ForgeMesh Utility Grid MCP

ForgeMesh Utility Grid MCP

ForgeMesh Labs 的一款产品。

搜索并使用 400 多个实用 API，无需将数百个工具加载到 Agent 中。Utility Grid 提供 7 个精简的 MCP 工具，涵盖 OCR、图像和音频处理、网页提取、数学、转换、地理数据等。目录发现免费；API 调用通过 x402 在 Base 上以 USDC 按次付费。无需账户或 API 密钥。

此服务并未为每个路由各暴露一个 MCP 工具（规模如此之大且还在增长，这种做法难以管理），而是提供少量元工具：浏览／搜索实时目录、获取路由的精确调用规范，然后以通用方式调用任何路由。上游服务新增的路由会自动显示，无需在此硬编码当前目录中的内容。

快速开始（Claude Desktop / Claude Code / 任意 MCP 客户端）

{
  "mcpServers": {
    "utility-grid": {
      "command": "npx",
      "args": ["-y", "@forgemeshlabs/utility-grid-mcp"],
      "env": {
        "WALLET_PRIVATE_KEY": "0x..."
      }
    }
  }
}

只有 3 个付费工具需要 WALLET_PRIVATE_KEY。发现功能完全无需钱包——可以跳过整个 env 代码块，免费浏览并规划调用。

工具

工具	费用	功能
list_tools	免费	列出所有路由及其实时价格，并提供分类摘要——直接获取 GET /menu，无需钱包
list_capabilities	免费	分类概览及路由数量，或某个分类中的所有路由
search_capabilities	免费	按关键词搜索所有路由的路径、ID 和描述
get_endpoint_spec	免费	获取路由的准确价格、输入架构，以及完整的请求／响应示例
call_endpoint	$0.001-$0.05	按路径和 JSON 请求体调用任意路由——自动处理 x402 付款流程
daily_402	$0.001	每日 402：从整个 ForgeMesh 服务群中精选一个端点，按 UTC 日期轮换
agent_service_directory	$0.05	所有 ForgeMesh x402 服务的注册表——分类、路由数量、价格范围

目录中的分类（示例，不尽全面）

地理（机场、邮编、地理编码、天气）、查询（词典、《圣经》、国家信息、节假日）、数学（统计、矩阵、方程、几何）、实用工具（二维码、哈希、UUID、电话号码解析）、视觉（OCR、图像描述、背景移除）、音频（TTS、转录、格式转换）、时间（时区、cron、日月）、太空（NASA APOD、小行星、太阳天气）、网页（内容提取、robots.txt/Content-Signal 检查）、注册表（服务群目录、每日精选）、文档（PDF 处理）、文本（语言检测、可读性）、经济（外汇汇率、金融计算器）、科学、开发者、域名、AI 和趣味（占卜、国际象棋、问答）。

不带参数调用 list_capabilities，即可查看实时的最新分类明细——目录会不断增长，这份 README 会逐渐过时，但该工具不会。

典型流程

1. search_capabilities({ query: "background removal" }) — 免费，查找 /remove-background
2. get_endpoint_spec({ path: "remove-background" }) — 免费，显示确切的输入架构和价格
3. call_endpoint({ path: "remove-background", body: { image_url: "https://..." } }) — 付费，自动完成 x402 流程并返回结果

如果已知路由及其输入格式，也可以直接调用 call_endpoint。

要求

Node.js 20+。付费工具需要 WALLET_PRIVATE_KEY：请使用专用、余额较低且已存入 USDC 的 Base 钱包。服务器拒绝为 Utility Grid 的两个钱包以外的任何收款方签名、拒绝使用 Base 主网以外的任何网络、拒绝使用 USDC 以外的任何资产，也拒绝超过上限的金额（每次调用 $0.05，每个会话 $10）。环境变量 X402_MAX_PRICE_USD 和 X402_SESSION_BUDGET_USD 只能调低这些上限。请求仅发往同源地址，超时为 60 秒，大小上限为 2 MB，且绝不跟随重定向。工具结果会以 { source, untrusted, content } 的形式封装返回：其中的内容是远程数据，而非指令。

付款方式

无需注册、API 密钥或订阅。call_endpoint、daily_402 和 agent_service_directory 都会触发相同流程：首次请求会返回 HTTP 402 挑战，此 MCP 服务会在 Base 上签署 USDC 付款授权（EIP-3009）并重试，结果会包含在同一响应中；若有结算详情，也会放在 _payment 下。

直接 API

更倾向于使用原始 HTTP？以下是完整的、可供 Agent 读取的接口：

• https://x402.forgemesh.io/llms.txt — 面向 Agent 的单页摘要
• https://x402.forgemesh.io/openapi.json — 包含 x402 付款元数据、完整输入架构和每个路由的示例的 OpenAPI 3.1 文档（list_capabilities/search_capabilities/get_endpoint_spec 每次调用时都会实时读取此文档）
• https://x402.forgemesh.io/.well-known/x402.json — x402 发现清单

赞助卡片（Lulu Ads）

list_tools 会直接获取 GET https://x402.forgemesh.io/menu。ForgeMesh 会在服务器端为此免费响应附加一张已披露的 Lulu Ads 卡片，作为普通的标记数据字段——绝不会使用模型可能读作指令的文本：

"sponsored": { "label": "Sponsored", "text": "...", "url": "https://..." }

此软件包不包含广告凭据，也不会调用广告网络；它会原样传递该字段。付费工具绝不会附带卡片。使用 delete result.sponsored 可将其移除。

常见问题

我需要账户或 API 密钥吗？ 不需要。x402 付款是唯一的凭据，且仅用于 3 个付费工具。

使用什么链和代币？ Base 主网上的 USDC（eip155:8453）。

上游目录变更时会导致问题吗？ 不会——list_capabilities、search_capabilities 和 get_endpoint_spec 都会实时读取 /openapi.json（在内存中缓存 5 分钟）。call_endpoint 完全不需要硬编码架构；它只会转发你的 JSON 请求体。

---

由 ForgeMesh Labs 构建 · 由 x402 protocol 提供支持 · MIT 许可证