pay-mcp

@pay-skill/mcp

面向 Pay 的 MCP 服务 —— 为 AI Agent 提供完整的 x402 支付栈。使用 Base 上的 USDC。

让任何兼容 MCP 的客户端（Claude Desktop、Cursor、VS Code、自定义框架）都能充分使用 Pay 的功能：直接付款、账单、x402 付费墙、服务发现和钱包管理。无需 CLI 二进制文件。

设置

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "pay": {
      "command": "npx",
      "args": ["-y", "@pay-skill/mcp"]
    }
  }
}

VS Code / Cursor

添加到 .vscode/mcp.json：

{
  "servers": {
    "pay": {
      "command": "npx",
      "args": ["-y", "@pay-skill/mcp"]
    }
  }
}

Claude Code

claude mcp add pay -- npx -y @pay-skill/mcp

就这么简单。首次运行时，服务会生成一个钱包并将其存储在操作系统的钥匙串中（Windows Hello、macOS Keychain、Linux Secret Service）。之后运行时会自动加载该钱包。

配置

环境变量	必需	默认值	说明
PAYSKILL_SIGNER_KEY	否	—	可选覆盖项。原始十六进制密钥或 .enc 密钥库密码。常规使用无需设置。
PAY_NETWORK	否	mainnet	mainnet（Base）或 testnet（Base Sepolia）

密钥解析顺序

1. 操作系统钥匙串（默认）——通过 keytar 从操作系统凭据存储中加载。首次运行时会自动生成新的密钥对并存储。
2. 加密密钥库——如果存在 ~/.pay/keys/default.enc，则使用 PAYSKILL_SIGNER_KEY 作为解密密码。
3. 原始十六进制密钥——如果 PAYSKILL_SIGNER_KEY 是一个 64 位十六进制字符串，则直接使用。适用于开发、测试或导入现有钱包。
4. 自动生成——如果以上方式均不适用，则生成新的密钥对并将其存储在操作系统钥匙串中。

诊断检查

验证所有配置是否正确：

npx @pay-skill/mcp --check

输出：

pay-mcp diagnostic check
  network: Base (chain 8453)
  api:     https://pay-skill.com/api/v1
  wallet:  0x1234...
  key:     keychain
  server:  OK (router: 0xABCD...)
  auth:    OK (balance: $50.00)

All checks passed. MCP server is ready.

工具（15 个）

付款

工具	说明
pay_send	直接支付 USDC（最低 $1）。确认阈值：低于 $10 自动确认，$10–100 需规划，超过 $100 需明确确认。
pay_request	使用 x402 自动付款的 HTTP 请求。处理 402 检测、直接结算/账单结算和价格质疑。

账单（按用量计费账户）

工具	说明
pay_tab_open	开通预充值账单（最低 $5，建议 $50）。服务提供方按调用收费。
pay_tab_close	关闭账单。返回分配明细（服务提供方 99%、手续费 1%、其余归 Agent）。
pay_tab_charge	从已开通的账单中扣款（仅限服务提供方）。
pay_tab_topup	为已开通的账单充值（仅限 Agent）。
pay_tab_list	列出账单，并标记闲置或余额较低的账单。

钱包

工具	说明
pay_status	余额、锁定/可用资金以及可执行建议。
pay_fund	生成有效期为 1 小时的充值链接（Coinbase Onramp 或直接充值 USDC）。
pay_withdraw	生成有效期为 1 小时的提现链接。
pay_mint	铸造测试网 USDC（仅限 Base Sepolia）。

服务发现与 Webhook

工具	说明
pay_discover	按关键词/类别搜索付费 API 服务。
pay_webhook_register	为支付事件注册 Webhook（使用 HMAC 签名）。
pay_webhook_list	列出已注册的 Webhook。
pay_webhook_delete	删除 Webhook。

资源（5 个）

URI	说明
pay://wallet/status	余额、账单、锁定/可用资金
pay://wallet/tabs	所有已开通的账单
pay://tab/{tab_id}	单个账单详情
pay://wallet/address	钱包地址
pay://network	网络配置和合约地址

提示词（3 个）

提示词	说明
pay-for-service	引导流程：发现服务、评估定价并发起请求
review-tabs	检查账单、标记闲置账单并建议关闭或充值
fund-wallet	生成充值链接并说明存款流程

开发

git clone https://github.com/pay-skill/pay-mcp.git
cd pay-mcp
npm install
npm run build
npm test                    # unit tests (mocked)
npm run test:acceptance     # testnet (requires PAYSKILL_TESTNET_KEY)

许可证

MIT

Pay 的组成部分

Pay 是完整的 x402 支付技术栈，包含网关、协调器、SDK、CLI 和 MCP 服务，可让 AI Agent 使用 Base 上的 USDC 支付 API 费用。

• 文档
• 架构
• SDK -- Python + TypeScript
• CLI -- 命令行工具
• pay-gate -- x402 支付网关
• 协议 -- 智能合约