PayGate MCP — Monetization Gateway for AI Agents

PayGate MCP

**面向 Model Context Protocol 服务的变现网关。**将任意 MCP 服务接入按次付费的收费通道，让 AI Agent 能够自主完成支付——无需注册、无需 API 密钥，也无需人工介入。

在线端点：https://paygate-mcp.rendercriativo.workers.dev/mcp

功能介绍

Agent 调用工具。如果该工具启用了付费功能，PayGate 会返回 x402 v2 支付挑战，而不是工具结果。Agent 对 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

工具运行前会验证付款，工具返回后才会结算。如果工具运行失败或返回错误，则不会扣费。

面向 Agent

发现工具免费。向 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：Gas 由支付中介承担。

支持两种 x402 传输方式。HTTP 客户端也可以使用 base64 编码的 PAYMENT-REQUIRED / PAYMENT-SIGNATURE / PAYMENT-RESPONSE 标头，而不是 MCP _meta 绑定。

面向卖家

卖家的整个生命周期都通过 MCP 工具提供，因此 Agent 可以端到端地完成操作——告诉你的助手为你的服务启用变现，它就能自行完成以下所有操作：

工具	功能
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 收费。

如果你更喜欢使用 curl，也可以通过 REST 执行相同操作（POST /api/register、PUT /api/me/tools、GET /api/me/earnings）：

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	Facilitator 基础 URL，不带 /verify 后缀。默认值因网络而异。
PAYGATE_WALLET_ADDRESS	接收付款的钱包。
CONTACT_EMAIL	可选；为空时会从 UCP 清单中省略。
CDP_API_KEY_ID / CDP_API_KEY_SECRET	Coinbase CDP 凭据。主网必需——这是唯一能在 Base 上结算的 facilitator。
UPSTREAM_AUTH_TOKEN	转发给开发者 MCP 服务的令牌。
STRIPE_SECRET_KEY	可选，用于价格 ≥ $0.50 的工具的 Stripe 路径。

Base Sepolia 无需凭据：公共 facilitator 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