Paid MCP Metering

paid-mcp-metering

呼び出しごとに料金が発生する、従量課金制のMCPツールです。

検出は無料です。POST /mcp は、Model Context Protocol に準拠した JSON-RPC 2.0（initialize、tools/list、ping）に対応しています。実行は従量課金制です。POST /v1/t/{tool} は x402 v2 のペイウォールの背後にあります。未払いのリクエストには、支払い要件とともに HTTP 402 が返されます。支払い済みのリクエストには PAYMENT-SIGNATURE ヘッダーが含まれ、ツールの実行前にファシリテーターを通じて USDC で決済されます。

ライブデプロイ

ベースURL：https://paid-mcp-metering.vercel.app

• GET /health — 無料、公開
• POST /mcp — 無料の検出
• POST /v1/t/{tool} — 従量課金制。現在は、デプロイ環境で X402_PAY_TO が未設定のため、503 settlement_not_configured を返します（/health の settlementConfigured:false が正確な状態を示します）。受取アドレスが設定されるまで、支払いは受け付けられません。

server.json では、このURLをレジストリのリモートとして宣言しています。

ツール

ツール	価格	返される内容
web_search	$0.001/回	ソースURL付きの、ランキングされた最新のウェブ検索結果
deep_research	$0.01/回	複数のソースを調査し、要約した回答と引用元を返します

上流サービスには Exa（プライマリ）と Tavily（フォールバック）を使用します。各ハンドラーは上流サービスから取得した最新の出力を返すか、例外をスローします。定型の応答はありません。

決済方式

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

環境変数	用途
X402_PAY_TO	受取アドレス。決済に必須です。未設定の場合は、402の要件のみを返します
X402_NETWORK	CAIP-2 ネットワーク ID（デフォルトは eip155:84532）
X402_FACILITATOR_URL	x402 ファシリテーターのエンドポイント
EXA_API_KEY / TAVILY_API_KEY	検索上流サービスの認証情報

実行

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 Registry を io.github.dev55acc-ai/paid-mcp-metering として対象にします。v* のタグを付けると .github/workflows/publish-mcp.yml が実行されます。テスト、ビルド、（NPM_TOKEN が設定されている場合は）npm への公開を行った後、GitHub OIDC で認証してレジストリに公開します。レジストリの認証情報を保存する必要はありません。

ライセンス

MIT