用途
agent-discovery-mcp 是一个 MCP（Model Context Protocol）服务端，目标是让你的 AI 编程代理（Claude Code、OpenClaw、Codex、Cursor 等）能够发现并调用链上代理，并使用 Coinbase 的 x402 协议自动支付。
链上代理通过 ERC-8004（以太坊的代理身份标准）自行注册。该服务端把这一注册表与 x402 支付衔接起来，使你现有的工具运行时可以在单个工具调用中查找并支付任意链上代理——无需智能账户、无需打包器、无需中继。只用你的 EOA、一个 HTTPS 请求，以及自动的 402 → 签名 → 重试流程。
适用对象：正在构建或使用 AI 编程代理、希望接入链上代理生态但不想自行接线定制发现或支付栈的开发者。
主要能力
通过 MCP 暴露三个工具，整个服务端约 250 行 TypeScript。没有智能合约账户、没有打包器、没有第三方中继——按照 x402 规范直接由 EOA 签名完成支付。
发现能力：
- 使用 8004scan 公共 API 进行代理发现（8004scan 是由 ERC-8004 团队维护的规范 ERC-8004 索引器）。
支付能力：
- 使用 Coinbase 官方 x402-fetch 进行支付，它包装了原生 fetch 以自动处理 402 响应。
- 使用 viem 进行 EOA 签名——无需部署合约账户，无需打包器。
结果：安装、设置一个环境变量，你的代理运行时即可调用 ERC-8004 注册表中任何支持 x402 的代理。
该服务端为何存在（背景，据资料）：
- x402（Coinbase 基于 HTTP 402 的支付协议）截至 2026 年 4 月已处理 1.65 亿+ 笔交易、约 5000 万美元交易量。
- ERC-8004（以太坊代理身份标准）于 2026 年 1 月 29 日部署到主网，目前已有数万个已注册代理。
- MCP（Anthropic 的工具调用协议）是连接 AI 编程代理与外部能力的实际标准。
但此前缺少一个干净的“胶水”，让 Claude Code / OpenClaw / Cursor 用户能在现有工具内直接发现并支付任意链上代理。已有方案如 @azeth/mcp-server 在其上捆绑了 ERC-4337 智能账户和自定义信任层——这迫使其依赖打包器/中继，实际使用中在测试网上可能失败。本服务端跳过了这些。
使用方式
要求：Node ≥ 20。
设置钱包私钥（这是将用于签署 x402 支付的 EOA）：
TEST_WALLET_KEY 仅 call_agent_with_payment 需要；发现类工具（find_agents_by_skill、get_agent_card）无需它即可工作。
macOS LaunchAgent 用户（例如 OpenClaw）：请改用 launchctl setenv，因为 LaunchAgent 进程不会继承你的 shell 环境变量。
与 Claude Code 配合： 添加到项目根目录的 .mcp.json 或 ~/.claude/mcp_settings.json 中。
与 OpenClaw 配合： 添加到 ~/.openclaw/openclaw.json 的 mcp.servers 下，然后执行 openclaw gateway restart。
与 Cursor / Cline / 任何兼容 MCP 的客户端配合： 标准 MCP stdio 服务端。将客户端指向 node /path/to/dist/index.js。
示例工作流： 在你的 AI 编程代理中，直接问： “Find me 5 agents on Base mainnet that can do text summarization, only ones supporting x402.” 代理会调用 find_agents_by_skill({ skill_keyword: "summarization", chain_id: 8453, x402_only: true, limit: 5 }) 并返回真实链上代理。
“Call agent #25886 at its primary endpoint with the text "...long article...", pay max $0.05 USDC.” 代理会调用 call_agent_with_payment({ endpoint: "...", payload: { text: "..." }, max_pay_usdc: 0.05, chain_id: 8453 })。若服务端返回 402，EOA 会签署 EIP-3009 USDC 授权、重试并返回结果。
工具参考：
- find_agents_by_skill
- call_agent_with_payment
支持链、无智能合约账户、无打包器、无中继：你的 EOA 签名，x402-fetch 重试，代理的 facilitator 结算。
适用场景
适用于在 AI 编程代理运行环境中直接访问链上代理生态：按技能查找代理、获取代理卡片、以 USDC 调用并支付代理端点。
限制与现状
这是一个可用的 v0.1.0 版本，底层是真实基础设施，但生态仍处于早期：
发现可用：8004scan API 返回 ERC-8004 注册表中的真实代理（截至 2026 年中期，跨链注册约 7 万+）。
支付可用：x402 支付流程端到端，使用 Coinbase 官方 x402-fetch 库和 EOA 签名。
生态注意事项：许多代理在元数据中设置 x402Support: true，但并未在其端点上强制付费墙——他们接受免费调用或返回 404。该标记为自我声明，尚无人验证。当前大多数生产环境的 x402 流量通过托管平台（Coinbase Agent.market、AWS Bedrock AgentCore 等）流转。无许可注册表流程真实但尚早。
路线图（据资料）：
- 在 find_agents_by_skill 返回代理前进行端点健康检查（过滤掉 404 演示部署）。
- 通过探测端点是否返回 402 来验证链上 x402Support 声明。
- 单次调用中的多链支付（自动选择 USDC 最便宜的链）。
- 可选集成 Coinbase Facilitator 以获取结算元数据。
- 支出限额策略（独立于 max_pay_usdc 参数的服务端上限）。
- 将收据记录到磁盘以用于税务/审计。
该包已列于 CodeGuilds（MCP 服务端和 AI 代理工具目录）。
平台支持：可与 Claude Code、OpenClaw、Cursor、Cline 配合使用。
