ForgeMesh Utility Grid MCP

ForgeMesh Utility Grid MCP

ForgeMesh Labs の製品です。

エージェントに何百ものツールを読み込ませることなく、400 を超える実用的な API を検索して利用できます。Utility Grid は、OCR、画像・音声処理、ウェブ抽出、数学、変換、地理データなどに対応する、コンパクトな 7 つの MCP ツールを提供します。カタログの検索は無料です。API の実行には、x402 を通じて Base 上で USDC による従量課金が適用されます。アカウントも API キーも不要です。

この規模で、しかも拡大し続けるカタログに対して、ルートごとに 1 つの MCP ツールを公開するのは管理が困難です。そのため、このサーバーでは少数のメタツールを公開しています。稼働中のカタログを閲覧・検索し、ルートの正確な呼び出し仕様を取得してから、任意のルートを汎用的に呼び出せます。上流サービスに新しいルートが追加されると自動的に反映されるため、ここで現在のカタログをハードコードする必要はありません。

クイックスタート（Claude Desktop ／ Claude Code ／任意の MCP クライアント）

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

WALLET_PRIVATE_KEY が必要なのは、有料ツール 3 つを使う場合だけです。ウォレットがなくても検索できます。無料で閲覧や呼び出しの計画を行う場合は、env ブロック全体を省略してください。

ツール

ツール	料金	機能
list_tools	無料	稼働中の価格とカテゴリーごとの概要を含む全ルートを取得します。ウォレット不要で GET /menu をそのまま取得します
list_capabilities	無料	ルート数を含むカテゴリー概要、または 1 つのカテゴリー内の全ルートを表示します
search_capabilities	無料	各ルートのパス、ID、説明を対象にキーワード検索します
get_endpoint_spec	無料	ルートの正確な価格、入力スキーマ、リクエスト／レスポンスの実例を取得します
call_endpoint	$0.005-$0.05	パスと JSON ボディを指定して任意のルートを呼び出します。x402 の決済フローを自動的に処理します
daily_402	$0.005	「Daily 402」。ForgeMesh の全サービスから、UTC の日付ごとにローテーションされる注目のエンドポイントを 1 つ提供します
agent_service_directory	$0.05	カテゴリー、ルート数、価格帯を含む ForgeMesh の全 x402 サービスのレジストリです

カタログ内のカテゴリー（例であり、すべてを網羅するものではありません）

geo（空港、郵便番号、ジオコーディング、天気）、lookups（辞書、聖書、国情報、祝日）、math（統計、行列、方程式、幾何）、utilities（QR コード、ハッシュ化、UUID、電話番号の解析）、vision（OCR、画像キャプション生成、背景除去）、audio（TTS、文字起こし、フォーマット変換）、time（タイムゾーン、cron、太陽／月）、space（NASA APOD、小惑星、宇宙天気）、web（コンテンツ抽出、robots.txt／Content-Signal のチェック）、registry（サービス一覧、日替わり紹介）、documents（PDF 処理）、text（言語検出、可読性）、economy（為替レート、金融計算ツール）、science、developer、domains、ai、fun（占い、チェス、トリビア）。

引数なしで 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 が必要です。専用の低残高 Base ウォレットを用意し、USDC を入金してください。このサーバーは、支払先が Utility Grid の 2 つのウォレット以外の場合、ネットワークが Base mainnet 以外の場合、資産が USDC 以外の場合、または金額が上限（1 回の呼び出しにつき $0.05、セッションあたり $10）を超える場合、署名を拒否します。環境変数 X402_MAX_PRICE_USD と X402_SESSION_BUDGET_USD で設定できるのは、これらの上限を引き下げることだけです。リクエストは同一オリジンで行われ、タイムアウトは 60 秒、サイズ上限は 2 MB で、リダイレクトには決して追従しません。ツールの結果は { source, untrusted, content } の形式で返されます。content はリモートデータであり、指示ではありません。

支払いの仕組み

登録、API キー、サブスクリプションは不要です。call_endpoint、daily_402、agent_service_directory はいずれも同じフローを実行します。最初のリクエストで HTTP 402 チャレンジが返され、この MCP サーバーが Base 上で USDC の支払い承認（EIP-3009）に署名して再試行します。可能な場合、決済の詳細を _payment に含め、結果は同じレスポンス内に返されます。

直接 API を利用する

生の HTTP を使いたい場合に利用できる、エージェント向けの完全な情報です。

• https://x402.forgemesh.io/llms.txt — エージェント向けの 1 ページ概要
• 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 カードを、サーバー側でこの無料レスポンスに 1 件添付します。これはラベル付きのデータフィールドとして付加され、モデルが指示として読み取れるテキストではありません。

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

このパッケージに広告用の認証情報は含まれておらず、広告ネットワークへの呼び出しも行いません。フィールドを変更せずにそのまま渡します。有料ツールにカードが付くことはありません。delete result.sponsored で削除できます。

FAQ

アカウントや API キーは必要ですか？ いいえ。x402 の支払いが唯一の認証手段であり、3 つの有料ツールにのみ必要です。

チェーンとトークンは何ですか？ Base mainnet 上の USDC（eip155:8453）です。

上流のカタログが変更されると動作しなくなりますか？ いいえ。list_capabilities、search_capabilities、get_endpoint_spec はすべて /openapi.json をライブで読み取ります（メモリ内に 5 分間キャッシュされます）。call_endpoint はハードコードされたスキーマを一切必要とせず、JSON ボディをそのまま転送します。

---

ForgeMesh Labs が開発 · x402 プロトコル を採用 · MIT License