Forge Agent Hub

forge-agent-mcp

オープンソースのMCPサーバーです。Forge Agent Hubのx402 APIをラップします。

• 稼働中のリモートサーバー（ホスト済み）： https://x402-gateway.forge-x402.workers.dev/mcp（Streamable HTTP）
• このパッケージ（v1.3.0）： stdio（およびオプションのローカルStreamable HTTP）で、カタログ全体（両方のAPIホスト）を利用できます。ホスト済みのリモートサーバーでは、引き続き元のゲートウェイMCPが提供されます。

お問い合わせ先：[email protected]
ライセンス：MIT

このパッケージはnpmに公開されていません（追加アカウントを持たないため）。クローンして、Node 20+で実行してください。

ツール

• list_endpoints — 無料です。有料ツール、価格（Base上のUSDC）、HTTPパスを一覧表示します。
• カタログ内の各パス（iban、eu_vat、sanctions_checkなど。現在58件）に対して、有料ツールが1つずつ用意されています。未払いの呼び出しでは、HTTP 402チャレンジが返されます。EVM_PRIVATE_KEYが設定されていて、@x402/fetchがインストールされている場合、サーバーは署名付きのx402 v2決済を使って再試行します。ゲートウェイのホスト済みリモートサーバーで引き続き公開されるのは、元のゲートウェイツールのみです。Wave-1のツール（$3のプレイブック2つを含む）は、?demo=1を付けるとサンプルを返します。また、各UTC日につき、IPあたり最初の3回の実際のHTTP呼び出しも無料です。

stdio

{
  "mcpServers": {
    "forge-agent-hub": {
      "command": "node",
      "args": ["/path/to/forge-agent-mcp/src/server.mjs"]
    }
  }
}

git clone https://github.com/forge-agent-hub/forge-agent-mcp
cd forge-agent-mcp
npm install
node src/server.mjs

Streamable HTTP（ローカル）

npm run start:http
# listens on 127.0.0.1:8787/mcp

ホスト済みリモートサーバー

プロセスを実行したくない場合は、稼働中のゲートウェイを利用してください。

{
  "mcpServers": {
    "forge-agent-api": {
      "url": "https://x402-gateway.forge-x402.workers.dev/mcp",
      "transport": "streamable-http"
    }
  }
}

ホスト済みツールの決済情報は、ゲートウェイ上の@x402/mcpを介してMCPの_metaで渡されます。

環境変数

変数	用途
API_BASE	デフォルトはhttps://x402-gateway.forge-x402.workers.devです
EVM_PRIVATE_KEY	オプションです。このプロセスでの自動決済を有効にします。絶対にコミットしないでください。
PORT	--httpで実行する場合のHTTPポートです（デフォルトは8787）