PayGate MCP — Monetization Gateway for AI Agents

PayGate MCP

Model Context Protocol サーバー向けの収益化ゲートウェイです。 任意の MCP サーバーを従量課金制のゲートウェイの背後に配置し、AI エージェントが登録も API キーも人間の介入もなしに、自律的に決済できるようにします。

ライブエンドポイント：https://paygate-mcp.rendercriativo.workers.dev/mcp

概要

エージェントがツールを呼び出します。ツールが有料の場合、PayGate は結果の代わりに x402 v2 の支払いチャレンジを返します。エージェントは USDC の送金承認に署名して再試行し、結果を受け取ります。決済は Base 上で行われるため、開発者が決済コードを扱う必要はありません。

agent ──tools/call──▶ PayGate ──▶ 402 challenge (price, asset, payTo)
agent ──signed payload──▶ PayGate ──verify──▶ facilitator
                          PayGate ──▶ developer's MCP server ──▶ result
                          PayGate ──settle──▶ facilitator ──▶ USDC on Base
agent ◀── result + settlement receipt

ツールの実行前に支払いが検証され、実行後に決済されます。ツールが失敗するかエラーを返した場合、料金は発生しません。

エージェント向け

一覧の取得は無料です。PayGate に販売中のものを問い合わせます。

curl -X POST https://paygate-mcp.rendercriativo.workers.dev/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"list_registered_servers","arguments":{}}}'

有料ツールを支払いなしで呼び出すと、仕様に準拠したチャレンジが返されます。これは isError: true を持つツール結果で、その structuredContent に PaymentRequired オブジェクトが含まれます。

{
  "x402Version": 2,
  "error": "Payment required: calculate_fator_r custa $0.02 USDC.",
  "resource": { "url": "mcp://tool/calculate_fator_r", "mimeType": "application/json" },
  "accepts": [{
    "scheme": "exact",
    "network": "eip155:8453",
    "amount": "20000",                                     // 6-decimal USDC units
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo": "0x82e3...999e",
    "maxTimeoutSeconds": 120,
    "extra": { "name": "USD Coin", "version": "2" }        // EIP-712 domain
  }]
}

extra に含まれるドメインを正確に使用して、EIP-3009 の TransferWithAuthorization に署名し、params._meta["x402/payment"] に支払い情報を添えて呼び出しを再試行してください。決済レシートは _meta["x402/payment-response"] に返されます。

Base メインネットでの USDC の EIP-712 ドメイン名は "USD Coin"、Base Sepolia では "USDC" です。誤った名前を使うと、すべての署名が検証に失敗します。

動作するリファレンスクライアントは scripts/pay-test.mjs にあります。

PRIVATE_KEY=0x... node scripts/pay-test.mjs

支払いに使うウォレットには Base 上の USDC が必要ですが、ETH は不要です。ガス代はファシリテーターが負担します。

どちらの x402 トランスポートにも対応しています。HTTP クライアントでは、MCP の _meta バインディングの代わりに、base64 形式の PAYMENT-REQUIRED／PAYMENT-SIGNATURE／PAYMENT-RESPONSE ヘッダーを使用できます。

販売者向け

販売者向けのライフサイクル全体を MCP ツールとして利用できるため、エージェントが最初から最後まで実行できます。アシスタントにサーバーの収益化を指示すれば、以下をすべて自律的に実行できます。

ツール	概要
register_server	サーバーを登録します。ツールは自動的にインポートされ、プロキシ URL とシークレットの api_key が発行されます。
verify_ownership	登録時に発行されたトークンを、ドメイン上の /.well-known/paygate-verify で提供してからこれを呼び出すと、認証済みバッジを取得できます。購入者は認証済みの販売者に絞り込めます。
set_tool_price	ツールの価格を変更するか、販売を停止します。
get_earnings / get_my_listing	収益レポートと現在の出品情報を取得します。

購入者はオンチェーンであなたのウォレットに直接支払います。 PayGate が資金を預かることはありません。出金を待つ必要も、引き出す残高も、直接支払いに対する手数料もありません。サーバーに変更を加えることもありません。PayGate は initialize、tools/list、resources/list、prompts/list を無料で転送し、tools/call のみ課金します。

同じ操作は REST（POST /api/register、PUT /api/me/tools、GET /api/me/earnings）でも利用できるため、必要に応じて curl を使えます。

curl -X POST https://paygate-mcp.rendercriativo.workers.dev/api/register \
  -H 'Content-Type: application/json' \
  -d '{"name":"Your Service",
       "target_server_url":"https://your-mcp-server.example.com/mcp",
       "wallet_address":"0xYourWallet"}'

ヘルスチェックと診断

GET /health/x402 では、決済レールが実際に課金できる状態かどうかを確認できます。

{
  "network": "eip155:8453",
  "facilitator": { "url": "...", "reachable": true, "authenticated": true },
  "ready_to_charge": true,
  "diagnosis": "Pronto para cobrar."
}

設定

実行時の値は wrangler.jsonc（vars）と Cloudflare のシークレットに設定します。

変数	用途
X402_NETWORK	CAIP-2 ネットワーク。eip155:8453（Base メインネット、デフォルト）または eip155:84532（Sepolia）。
X402_FACILITATOR_URL	ファシリテーターのベース URL。/verify のサフィックスは付けません。デフォルトはネットワークごとに異なります。
PAYGATE_WALLET_ADDRESS	支払いを受け取るウォレット。
CONTACT_EMAIL	任意。空の場合、UCP マニフェストから省略されます。
CDP_API_KEY_ID / CDP_API_KEY_SECRET	Coinbase CDP の認証情報。メインネットでは必須です。Base で決済するファシリテーターはこれだけです。
UPSTREAM_AUTH_TOKEN	開発者の MCP サーバーに転送するトークン。
STRIPE_SECRET_KEY	任意。価格が 0.50 ドル以上のツールで Stripe を利用する場合に必要です。

Base Sepolia では認証情報は不要です。公開ファシリテーター https://x402.org/facilitator がテストネットの USDC を無料で決済するため、フロー全体を試す最も安価な方法です。

レイアウト

src/
├── index.ts                 routes, health, discovery documents
├── x402/
│   ├── config.ts            network registry (CAIP-2, USDC assets, EIP-712 domains)
│   ├── protocol.ts          v2 structures, MCP + HTTP transport bindings
│   └── facilitator.ts       /verify and /settle, CDP JWT auth (EdDSA and ES256)
├── api/
│   ├── proxy.ts             the paid path: challenge → verify → execute → settle
│   ├── mcp-server.ts        PayGate's own MCP server
│   ├── paygate-tools.ts     marketplace tools: register, verify, price, earnings
│   ├── llms-txt.ts          /llms.txt for AI systems arriving over the web
│   ├── register.ts          developer onboarding
│   ├── dev-management.ts    profile, pricing, earnings
│   └── discovery.ts         server card and UCP manifest
└── db/schema.ts             developers, tools, transactions, payment proofs

開発

npm install
npx wrangler dev      # local
npx wrangler deploy   # production

Cloudflare Workers、Hono、D1 を基盤に構築されています。

ライセンス

MIT