SuperAPI AI 工具集

x402-discovery-mcp

x402-discovery-mcp 是面向 x402 可付费 API 的运行时发现与路由工具。它以 MCP 服务器的形式,提供不断增长的 x402 服务目录,包含实时质量信号、facilitator 兼容性检查与 ERC-8004 信任评分,可按能力查找并按质量与信任分排序。项目同时提供 Python SDK 与 CLI(x402scout),并包含 scout_relay 自主支付路由:一次调用即可发现最优服务、完成 x402 支付、失败重试并返回结果。适用于 Claude、Cursor、Windsurf 等 MCP 客户端。

访问官网

工具介绍

用途 x402-discovery-mcp 解决 x402 生态中的“发现”问题。x402 是 Coinbase 提出的 HTTP 原生微支付标准:AI 智能体访问端点后收到 HTTP 402 挑战,用 Base 上的 USDC 支付并获得数据,无需 API 密钥或订阅。官方目录只列出服务名称,缺少可用性、延迟、facilitator 兼容性与信任信号,因此该 MCP 服务器把智能体连接到 x402 Service Discovery API,提供带实时质量信号的持续更新目录。

主要能力

  1. 发现:按能力、类别、价格上限查找 x402 服务。
  2. 质量信号:正常运行时间百分比、延迟(毫秒)、facilitator 兼容性、ERC-8004 信任评分。
  3. 注册:可通过 API 或 MCP 工具注册新的 x402 端点。
  4. 执行:scout_relay 在单次调用中完成发现、x402 支付、失败重试并返回结果,属自主支付路由器。
  5. MCP 工具:共 9 个,含 5 个发现工具与 4 个 relay 工具。
  6. 其他组件:Python SDK、终端 CLI(x402scout)、ScoutGate(将现有 API 在 2 分钟内包装为 x402 支付,无需协议知识,自动列入 x402Scout 并在 Base 主网以 USDC 结算)。

使用方式 支持多种接入方式:

  • Docker(推荐):加入 claude_desktop_config.json、Cursor MCP 设置或 Windsurf 配置。
  • npx(无需 Docker)。
  • 直接 API:Discovery API 公开可访问,无需认证。
  • CLI:x402scout 可在终端搜索完整 x402 服务目录,用法见 cli/README.md。 支付采用 EIP-712 签名的 TransferWithAuthorization 通过 x402 HTTP 协议完成,而非直接 ERC-20 转账;签名由服务端验证,链上通过 receiveWithAuthorization 结算。

适用场景

  • 在 Claude、Cursor、Windsurf 等 MCP 客户端内查找、评估、调用 x402 可付费服务。
  • 需要按质量与信任分选择服务、检查 facilitator 兼容性的智能体工作流。
  • 希望将现有 API 快速纳入 x402 支付并按调用收费的提供方。
  • 需要自主支付路由、自动重试与审计的场景。

费用与限制

  • x402_discover 调用费用为 $0.010 USDC,通过其自身服务的 x402 协议支付。
  • scout_relay 每次路由调用费用为 max($0.003, 下游交易金额的 2.5%)。
  • ScoutGate 费用为每笔交易 2%(最低 $0.002)。
  • 位置竞价:提供方可注册路由优先竞价,$0.01 注册费,x402 门控;竞价仅在信任分过滤后作为平局裁决,始终“质量优先”。
  • 项目构建于 Coinbase x402 协议、Base 网络、ERC-8004 与 Model Context Protocol 之上。
  • 关于 Python SDK 的具体接口、完整的 MCP 工具清单及各工具参数,资料中暂未提供详细说明。