paid-mcp-metering

呼び出しごとに課金される従量制 MCP ツール。

探索は無料：POST /mcp は JSON-RPC 2.0 を Model Context Protocol に従って扱います（initialize、tools/list、ping）。実行は従量課金：POST /v1/t/{tool} は x402 v2 のペイウォールの背後にあります。未払いのリクエストには HTTP 402 を返して支払い情報を提示し、支払い済みのリクエストは PAYMENT-SIGNATURE ヘッダーを付け、ツールの実行前にファシリテーターを介して USDC を決済します。

ツール

アップストリームは Exa（プライマリ）と Tavily（フォールバック）です。各ハンドラーは最新のアップストリーム結果を返すか例外を投げます。固定された応答はありません。

Related MCP server: Base Intel Search

決済レール

x402 v2、USDC、そして EIP-155 ネットワークは X402_NETWORK で選択します（デフォルトは Base Sepolia テストネット、CAIP-2 eip155:84532）。ファシリテーターのデフォルトは https://x402.org/facilitator です。

実行

npm install
npm run build
npm start          # node dist/x402-server.js
npm test           # build + node --test dist/test-x402.js

無料の探索:

curl -s localhost:4021/mcp -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

有料の実行:

curl -s localhost:4021/v1/t/web_search -H 'Content-Type: application/json' \
  -d '{"query":"x402 protocol","max_results":3}'
# -> 402 with payment requirements; pay via an x402 client and retry with PAYMENT-SIGNATURE

レジストリ

server.json は、公式の MCP レジストリで io.github.dev55acc-ai/paid-mcp-metering として指定しています。v* タグを付けると .github/workflows/publish-mcp.yml が実行されます。テスト、ビルド、npm publish（NPM_TOKEN が設定されている場合）、そして GitHub OIDC によって認証されたレジストリ公開です。保存されたレジストリ資格情報は不要です。

ライセンス

MIT