Pay Mcp

io.github.pay-skill由 GitHub 账号 pay-skill 发布v0.2.8更新于 Oct 24, 2026

USDC payments for AI agents on Base — direct, tabs, x402 paywalls, discovery

概览

AI 生成的概览

让助手在 Base 上收发 USDC 付款、管理按量计费的 tab,并支付 x402 付费 API。

可以做什么
提供 15 个工具,用于在 Base 上进行 USDC 支付:直接转账、带 x402 自动付款的 HTTP 请求,以及由服务方按调用计费的预付费 tab。钱包工具涵盖余额与状态、充值链接、提现链接和测试网 USDC 铸造。还提供服务发现以查找付费 API,以及支付事件的 webhook 注册,并附带钱包与 tab 资源和引导式提示词。
适用场景
当助手需要用 Base 上的 USDC 为 API 或服务付费、结算 x402 付费墙,或与服务方运行预付费按量账户时使用。适合会动用真实资金、并需要查看余额、tab 和 webhook 的智能体工作流。
运行要求
通过 stdio 在本地运行,通常使用 npx @pay-skill/mcp,适用于 Claude Desktop、Cursor、VS Code 或 Claude Code 等桌面客户端。需要 Node.js 以及访问 Pay API 的网络连接。首次运行会生成钱包并存入操作系统钥匙串;PAYSKILL_SIGNER_KEY 为可选覆盖项,PAY_NETWORK 选择主网或测试网。
安装前请注意
该服务器会动用真实资金:可发送 USDC、开设预付费 tab,并可自动支付 x402 请求,确认阈值为低于 10 美元自动、10 至 100 美元需计划、超过 100 美元需明确确认。PAYSKILL_SIGNER_KEY 是私钥或密钥库密码,可控制钱包,请勿放入共享配置。充值与提现链接有时效,webhook 会注册到第三方。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Pay Mcp,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@pay-skill/mcp

MCP server for Pay -- the complete x402 payment stack for AI agents. USDC on Base.

Gives any MCP-compatible client (Claude Desktop, Cursor, VS Code, custom frameworks) the full power of Pay: direct payments, tabs, x402 paywalls, service discovery, and wallet management. No CLI binary needed.

Setup

Claude Desktop

Add to claude_desktop_config.json:

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

VS Code / Cursor

Add to .vscode/mcp.json:

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

Claude Code

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

That's it. On first run, the server generates a wallet and stores it in the OS keychain (Windows Hello, macOS Keychain, Linux Secret Service). Subsequent runs load it automatically.

Configuration

Env VarRequiredDefaultDescription
PAYSKILL_SIGNER_KEYNo—Optional override. Raw hex key or .enc keystore password. Not needed for normal use.
PAY_NETWORKNomainnetmainnet (Base) or testnet (Base Sepolia)

Key Resolution (checked in order)

  1. OS keychain (default) — Loads from the OS credential store via keytar. On first run, a new keypair is generated and stored automatically.
  2. Encrypted keystore — If ~/.pay/keys/default.enc exists, PAYSKILL_SIGNER_KEY is used as the decryption password.
  3. Raw hex key — If PAYSKILL_SIGNER_KEY is a 64-char hex string, it's used directly. For dev/testing or importing an existing wallet.
  4. Auto-generate — If none of the above, generates a new keypair and stores it in the OS keychain.

Diagnostic Check

Verify everything is configured correctly:

bash
npx @pay-skill/mcp --check

Output:

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.

Tools (15)

Payments

ToolDescription
pay_sendDirect USDC payment ($1 min). Confirmation thresholds: <$10 auto, $10-100 plan, >$100 explicit.
pay_requestHTTP request with x402 auto-payment. Handles 402 detection, direct/tab settlement, price skepticism.

Tabs (metered accounts)

ToolDescription
pay_tab_openOpen pre-funded tab ($5 min, $50 recommended). Provider charges per-call.
pay_tab_closeClose tab. Returns distribution breakdown (provider 99%, fee 1%, agent remainder).
pay_tab_chargeCharge against open tab (provider only).
pay_tab_topupAdd funds to open tab (agent only).
pay_tab_listList tabs with idle/low-balance flags.

Wallet

ToolDescription
pay_statusBalance, locked/available funds, actionable suggestions.
pay_fundGenerate 1-hour funding link (Coinbase Onramp or direct USDC).
pay_withdrawGenerate 1-hour withdrawal link.
pay_mintMint testnet USDC (Base Sepolia only).

Discovery & Webhooks

ToolDescription
pay_discoverSearch paid API services by keyword/category.
pay_webhook_registerRegister webhook for payment events (HMAC-signed).
pay_webhook_listList registered webhooks.
pay_webhook_deleteDelete a webhook.

Resources (5)

URIDescription
pay://wallet/statusBalance, tabs, locked/available
pay://wallet/tabsAll open tabs
pay://tab/{tab_id}Single tab detail
pay://wallet/addressWallet address
pay://networkNetwork config + contract addresses

Prompts (3)

PromptDescription
pay-for-serviceGuided: discover service, evaluate pricing, make request
review-tabsReview tabs, flag idle, suggest close/topup
fund-walletGenerate fund link, explain deposit process

Development

bash
git clone https://github.com/pay-skill/pay-mcp.gitcd pay-mcpnpm installnpm run buildnpm test                    # unit tests (mocked)npm run test:acceptance     # testnet (requires PAYSKILL_TESTNET_KEY)

License

MIT

Part of Pay

Pay is the complete x402 payment stack -- gateway, facilitator, SDKs, CLI, and MCP server -- that lets AI agents pay for APIs with USDC on Base.

来源:README.md,提交 9dd2d20

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.2.8最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。