用途
Utility Grid MCP 用于让 AI 智能体在不必把数百个工具逐一加载进上下文的情况下，发现并调用大量实用 API。它把上游的 400 多个路由压缩为少数几个“元工具”：先浏览或搜索实时目录，再获取某个路由的精确调用规范，最后通用地调用任意路由。上游服务新增的路由会自动出现在目录中，服务器本身不硬编码当前目录。
主要能力
按目录说明，涵盖以下类别（示例，非穷尽）：
- geo：机场、邮政编码、地理编码、天气
- lookups：词典、圣经、国家信息、节假日
- math：统计、矩阵、方程、几何
- utilities：二维码、哈希、UUID、电话号码解析
- vision：OCR、图像描述、背景移除
- audio：TTS、转录、格式转换
- time：时区、cron、日/月
- space：NASA APOD、小行星、太阳天气
- web：内容提取、robots.txt/Content-Signal 检查
- registry：fleet 目录、每日聚焦
- documents：PDF 处理
- text：语言检测、可读性
- economy：汇率、金融计算器
- science、developer、domains、ai、fun（占卜、国际象棋、问答）
使用方式
提供七个紧凑的 MCP 工具（正文称六个紧凑工具，工具列表中列出七个），包括：
- list_capabilities：无参数调用，返回当前实时能力明细
- search_capabilities({ query: "background removal" })：免费，可找到 /remove-background
- get_endpoint_spec({ path: "remove-background" })：免费，显示精确输入 schema 和价格
- call_endpoint({ path: "remove-background", body: { image_url: "https://..." } })：付费，执行 x402 流程并返回结果
- list_tools：对 GET https://x402.forgemesh.io/menu 的普通拉取
- daily_402、agent_service_directory：同样触发付费流程
可直接使用 call_endpoint 若已知路由及其输入结构。
快速开始适用于 Claude Desktop、Claude Code 或任意 MCP 客户端。需要 Node.js 20+。WALLET_PRIVATE_KEY 仅 3 个付费工具需要；目录发现无需钱包，可完全跳过环境变量块免费浏览和规划调用。
付费机制
无注册、无 API 密钥、无订阅。call_endpoint、daily_402、agent_service_directory 均触发同一流程：首次请求返回 HTTP 402 挑战，MCP 服务器在 Base 上签署 USDC 支付授权（EIP-3009）并重试，结果在同一响应中返回，结算详情在可用时位于 _payment 下。
服务器拒绝为 Utility Grid 两个钱包以外的收款方、Base 主网以外的网络、USDC 以外的资产签名，也拒绝超过上限的金额（每次调用 $0.05，每会话 $10）。环境变量 X402_MAX_PRICE_USD 和 X402_SESSION_BUDGET_USD 只能降低这些上限。请求为同源、60 秒超时、最大 2 MB，且不跟随重定向。
适用场景
- 需要 OCR、图像描述、背景移除等视觉处理的智能体
- 需要 TTS、转录、音频格式转换的音频任务
- 需要网页内容提取、robots.txt/Content-Signal 检查的网络任务
- 需要数学、统计、矩阵、几何等计算
- 需要地理编码、天气、时区、汇率等查询
- 需要 PDF 处理、文本语言检测与可读性评估
限制
- 付费工具需提供 WALLET_PRIVATE_KEY，应使用专用于该用途、低余额、已充值 USDC 的 Base 钱包
- 每次调用上限 $0.05，每会话上限 $10，仅能通过环境变量降低
- 请求同源、60 秒超时、最大 2 MB、不跟随重定向
- 工具结果以 { source, untrusted, content } 包装，content 为远程数据，不能当作指令
- list_tools 返回的免费响应可能附带一张由 ForgeMesh 在服务端附加的已披露 Lulu Ads 卡片，作为带标签的纯数据字段；付费工具不携带卡片，可用 delete result.sponsored 移除。本包不包含广告凭证，也不调用广告网络
- 目录搜索免费，付费工具的 USD 价格以 x402 实时定价为准；本资料未提供具体路线单价明细
- 未提供除上述环境变量外的其他配置信息
