X402 List MCP Server已验证已精选

什么是 x402-list MCP Server？

x402-list MCP Server 是 x402-list.com 的 MCP 服务器。x402-list.com 是一个收录接受 x402（HTTP 402 稳定币）支付服务的目录。它让 AI 智能体发现 x402 服务、查看可用性和价格，并检查各 facilitator 经链上验证的结算量。

该包以 x402-list-mcp 发布在 npm 上，是对公开 x402-list HTTP JSON API 的轻量封装。它不持有任何密钥、不访问数据库，也不向目录写入任何内容。七个工具中有六个免费且只读。第七个 x402_assess_services 是付费工具，作为透传：它转发一个由你在客户端自行签名的 x402 支付质询，该包从不持有密钥、从不签名、也从不结算。源代码以 MIT 许可发布在 github.com/mcccsm/x402-list-mcp。

如何使用 x402-list MCP Server？

你可以在本地通过 stdio 运行 npm 包，也可以连接托管服务器 https://mcp.x402-list.com/mcp（Streamable HTTP）。本地使用需要 Node.js 20 或更高版本以及 npm。两种方式都不需要 API 密钥。

Claude Code

本地包：

claude mcp add --transport stdio x402-list -- npx -y x402-list-mcp

或托管服务器：

claude mcp add --transport http x402-list https://mcp.x402-list.com/mcp

二选一即可。

Claude Desktop

将以下条目添加到 claude_desktop_config.json 并重启客户端：

{
  "mcpServers": {
    "x402-list": {
      "command": "npx",
      "args": ["-y", "x402-list-mcp"]
    }
  }
}

Cursor

将托管服务器添加到 .cursor/mcp.json（项目）或 ~/.cursor/mcp.json（全局），或使用 README 中的安装链接：

{
  "mcpServers": {
    "x402-list": {
      "url": "https://mcp.x402-list.com/mcp"
    }
  }
}

VS Code

将以下内容添加到 .vscode/mcp.json，然后启动服务器并在 Copilot 智能体模式中使用：

{
  "servers": {
    "x402-list": {
      "type": "http",
      "url": "https://mcp.x402-list.com/mcp"
    }
  }
}

Codex

codex mcp add x402-list --url https://mcp.x402-list.com/mcp

自托管 HTTP

MCP_HTTP_PORT=3000 npx -y x402-list-mcp --http

客户端随后连接 http://localhost:3000/mcp，http://localhost:3000/healthz 会返回 {"status":"ok"}。可选环境变量包括 X402_LIST_BASE_URL、X402_LIST_TIMEOUT_MS（默认 15000）、MCP_ALLOWED_ORIGINS 和 MCP_ALLOWED_HOSTS。

x402-list MCP Server 的主要功能

• 按关键词、类别、网络、在线状态以及服务的 402 响应是否可被标准 x402 客户端签名，搜索和筛选 x402-list 目录。
• 完整的服务记录：端点、每个端点的美元价格、24 小时 / 7 天 / 30 天 / 90 天可用率、网络和结算资产。
• 服务端排名，综合考量可靠性、x402 合规性和价格，并给链上实际使用量一个较小权重。
• 各 facilitator 经链上验证的结算量和交易笔数。
• 已收录服务的 payTo、价格和 402 schema 变更记录。
• 不持有密钥、不签名、不写入；API 返回的收款地址均已脱敏。

x402-list MCP Server 工具

• 发现： x402_search_services 把目录缩小到候选服务，x402_get_service 返回某个 slug 的完整记录，x402_find_best_service 根据文字描述的需求返回最多 20 个排序推荐，并标注 ranking_version，分数只应在同一评分版本内比较。
• 监控： x402_check_health 报告整个目录或单个服务的实时状态，x402_change_events 列出观察到的 payto_changed、price_changed 和 schema_changed 事件，可按 service、type 和 days 筛选。
• 市场数据： x402_facilitator_volumes 返回各 facilitator 今日（UTC）、7 天、30 天和累计的结算量，并附链上验证标记。
• 付费评估： x402_assess_services 以 Base 上 0.25 USDC 的价格，对 2 到 8 个候选服务进行一次全新的 AI 比较。先不带 payment_signature_b64 调用以获取质询，在客户端签名后重试。

x402-list MCP Server 的使用场景

• 为任务寻找付费 API：“找一个在 Base 上、当前在线且可签名的图像生成 x402 服务。”
• 付款前检查服务：“这个服务现在在线吗？30 天可用率是多少？”
• 排查支付失败：“这个服务的 payTo 或价格最近变过吗？”
• 研究生态：“本月哪些 x402 facilitator 有真实的链上结算量？”
• 在相近选项之间取舍：“针对我的用例评估这三个候选服务。”

x402-list MCP Server 常见问题排查

• 本地服务器无法启动： 本地使用需要 Node.js 20 或更高版本以及 npm。使用托管 URL 则完全不需要本地 Node.js。
• x402_change_events 忽略了筛选条件： 参数名是 service（目录中的 slug），而不是 slug。
• 价格看起来非常大： pricing[].price 是链上代币的原始最小单位数量；只有 price_usd 是美元金额。
• 分数对不上： 只在相同的 ranking_version 内比较 x402_find_best_service 的分数。
• 请求超时： 调大 X402_LIST_TIMEOUT_MS（默认 15000 毫秒）。