mcp-x402

@codespar/mcp-x402

已弃用：没有可用的在线端点。 2026-09-27 使用两个公共 DNS 解析器（8.8.8.8 和 1.1.1.1）进行检测后发现：此服务唯一调用的主机 api.x402.org 无法通过 DNS 解析。x402 没有中央 API：它是一种 HTTP 402 协议，每个卖家都会选择验证付款的协调服务。此服务中的工具均无法连接到任何服务。该软件包已在 npm 上弃用，仅保留在此仓库中供参考。如果你有可用的端点，可通过 X402_BASE_URL 将服务指向该端点。若要恢复此软件包，请在 mcp-dev-latam 提交问题，并附上服务提供商提供的基础 URL 文档。

面向 x402 的 MCP 服务——由 Coinbase 推出的 HTTP 原生微支付协议（Base/Solana 上的 USDC）

什么是 x402？

x402 是一种开放协议，支持在 HTTP 层实现机器对机器微支付。当 AI Agent 请求资源并收到 HTTP 402 Payment Required 响应时，它会自动在链上发送 USDC 付款并重试——无需结账界面，也无需商家集成，纯 HTTP 流程。

这是专为 Agent 商务打造的支付通道。

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-x402"],
      "env": {
        "X402_API_KEY": "your-key",
        "X402_WALLET_ADDRESS": "your-wallet-address"
      }
    }
  }
}

Claude Code

claude mcp add x402 -- npx @codespar/mcp-x402

Cursor / VS Code

添加到 .cursor/mcp.json 或 .vscode/mcp.json：

{
  "servers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-x402"],
      "env": {
        "X402_API_KEY": "your-key",
        "X402_WALLET_ADDRESS": "your-wallet-address"
      }
    }
  }
}

工具（10 个）

工具	用途
pay_request	为受 402 保护的资源付款。
verify_payment	验证 x402 付款是否已收到并在链上结算
create_paywall	为端点创建 x402 付费墙配置。
get_paywall	获取特定 URL 的付费墙配置
list_paywalls	列出所有已配置的 x402 付费墙
delete_paywall	从端点移除 x402 付费墙
get_balance	获取可用于 x402 付款的 USDC 余额
list_payments	列出 x402 付款记录，可选使用筛选条件
get_payment	获取特定 x402 付款的详细信息
get_supported_networks	列出 x402 付款支持的区块链网络、代币和协调服务

身份验证

x402 使用从已注册协调服务获取的 Bearer API 密钥。

获取凭据

1. 访问 x402 文档
2. 设置协调服务，或使用 Coinbase 托管的协调服务
3. 生成 API 密钥
4. 获取你的钱包地址（Base 或 Solana）
5. 设置环境变量

环境变量

变量	必填	描述
X402_API_KEY	是	x402 协调服务的 API 密钥
X402_WALLET_ADDRESS	是	用于发送/接收付款的钱包地址
X402_NETWORK	否	区块链网络：base（默认）或 solana

使用场景

• Agent 访问付费 API — AI Agent 按请求为数据流、LLM API 或优质内容付费
• 微支付变现 — 通过低于一美分的付费墙保护你的 API 端点
• 机器对机器商务 — Agent 自主购买算力、数据或服务

路线图

v0.2（计划中）

• create_subscription — 为端点设置定期微支付
• estimate_cost — 在为资源付款前估算费用
• batch_pay — 在单笔交易中为多个资源付款

v0.3（计划中）

• 支持多种代币（除 USDC 外，还支持 ETH、SOL）
• 为长时间运行的 Agent 任务提供流式付款

想要贡献？提交 PR 或申请工具。

链接

• x402 协议（Coinbase）
• x402 规范
• MCP Dev LATAM
• 落地页

企业版

需要为 Agent 付款提供治理、预算限制和审计记录？CodeSpar Enterprise 在这些 MCP 服务之上增加了策略引擎、付款路由和合规模板。

许可证

MIT