X402 Service Discovery

x402 服务发现 MCP 服务

⭐ 给项目点星，帮助更多人发现它 — 如果 x402Scout 为你节省了时间，点星可以帮助其他开发者发现它

由社区打造的 x402 Agentic 经济版 Bazaar——一个持续扩大的实时服务目录，提供实时质量信号、facilitator 兼容性检查和 ERC-8004 信任评分。这正是 Coinbase 自己的 PROJECT-IDEAS.md 邀请社区构建的发现层。

---

ScoutGate — 即时实现 x402 API 变现

只需不到 2 分钟，即可为任何现有 API 接入 x402 付款——无需了解协议

x402 生态中最大的阻力一直在供给侧：要让 API 接入 x402 付款，需要了解 EIP-712 标头、facilitator 注册和结算逻辑。ScoutGate 将这些统统处理好。

# Register your existing API (30 seconds)
curl -X POST https://x402-scoutgate.onrender.com/register \  -H "Content-Type: application/json" \  -d '{"api_url": "https://your-api.com", "wallet_address": "0xYourWallet", "price_usd": 0.01, "name": "My API"}'
# Returns: {"proxy_url": "https://x402-scoutgate.onrender.com/api/abc123", "api_id": "abc123"}

就是这么简单。你的 API 现在已启用 x402、自动列入 x402Scout，并且通过 Base 主网以真实 USDC 结算。ScoutGate 负责 facilitator 集成、EIP-712 验证和结算。

费用模式： 每笔交易收取 2%（最低 $0.002）。现已上线： https://x402-scoutgate.onrender.com | 注册你的 API

---

终端 CLI — x402scout

在终端中搜索完整的 x402 服务目录

# Install (npm)
npm install -g x402scout

# Search
x402scout search "weather data"

# Top services by trust score
x402scout top 10

# Browse by category
x402scout browse data

# Scan a URL for x402 compliance
x402scout scan https://api.yourservice.com

# Ecosystem stats
x402scout stats

完整用法请参阅 cli/README.md。

---

scout_relay — 自主支付路由器

一次调用即可路由、执行并审计 x402 支付

Discovery MCP 用于查找要调用的内容，而 scout_relay 负责调用它——发现最佳服务、完成 x402 支付、失败时重试并返回结果。一次调用。完全自主。

# Route an intent to the best matching x402 service
curl -X POST https://x402-scout-relay.onrender.com/route \
  -H "Content-Type: application/json" \
  -H "X-Payment: <your-x402-payment-header>" \
  -d '{"intent": "blockchain analytics for wallet 0xABC", "max_budget_usd": 0.05}'

4 个 MCP 工具 — 可添加到任何 MCP 客户端：

工具	功能
scout_route	根据意图发现最佳服务并执行支付
scout_discover	查询发现目录，但不执行
scout_execute	向已知服务 URL 执行支付
scout_audit	查看支出日志和 Agent 预算状态

费用模式： 每次路由调用收取 max($0.003, 下游交易金额的 2.5%)。

优先级竞价： 提供方可以在 POST /placement/bid 注册路由优先级竞价（受 x402 门控，注册费 $0.01）。竞价仅在信任评分筛选后作为平局判定依据——始终以实力为先。

端点	说明
GET /health	服务健康状态和版本
POST /route	路由意图（受 x402 门控）
POST /execute	向已知 URL 执行支付（受 x402 门控）
GET /discover	发现目录（免费）
GET /audit	支出日志（免费）
POST /placement/bid	注册提供方优先级竞价（受 x402 门控，$0.01）
GET /placement/bids	查看所有有效的优先级竞价（公开）

在线地址： https://x402-scout-relay.onrender.com

---

这是什么（30 秒了解）

x402 是 Coinbase 为 Agent 网络推出的原生 HTTP 微支付标准。AI Agent 访问端点，收到 HTTP 402 挑战，使用 Base 上的 USDC 付款，然后获取数据——无需 API 密钥或订阅，纯粹的机器对机器交互。

问题： 生态系统中存在数百种支持 x402 付款的服务。官方 x402.org 目录只列出名称，仅此而已。没有运行时间数据、延迟评分、facilitator 兼容性标记或信任信号。Agent 无从得知哪些服务确实在线、值得信赖，或兼容其支付流程。

这个 MCP 服务解决了这个问题。 将任何 Claude、Cursor 或 Windsurf Agent 直接连接到 x402 服务发现 API——这是一个持续更新的目录，每个条目都包含真实的质量信号。查找服务、检查健康状态、验证 facilitator 兼容性，并注册新端点——一切都可在 AI 工作流中完成。

---

MCP 工具（5 个发现工具 + 4 个中继工具 = 共 9 个）

发现工具

工具	功能	费用
x402_discover	按关键词、类别和最高价格对实时目录进行语义搜索	$0.010 USDC （通过 x402 付款）
x402_health	实时检查任何已注册服务的运行时间和延迟	$0.001 USDC （通过 x402 付款）
x402_register	注册新的 x402 服务（仅限 HTTPS，受速率限制）	免费
x402_attest	获取服务的 ERC-8004 信任评分和声誉信号	免费
x402_scan	完整的 x402 合规性扫描：实时配置、信任评分和不匹配检测	$0.010 USDC （通过 x402 付款）

中继工具（通过 scout_relay）

工具	功能	费用
scout_route	根据意图发现最佳服务并执行 x402 支付	max($0.003, 2.5%)
scout_discover	查询发现目录，但不执行	免费
scout_execute	向已知服务 URL 执行 x402 支付	max($0.003, 2.5%)
scout_audit	查看 Agent 支出日志和预算状态	免费

---

快速开始 — 30 秒即可开始发现

选项 A：Docker（推荐）

添加到 claude_desktop_config.json、Cursor MCP 设置或 Windsurf 配置中：

{
  "mcpServers": {
    "x402-discovery": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/rplryan/x402-discovery-mcp:latest"]
    }
  }
}

选项 B：npx（无需 Docker）

{
  "mcpServers": {
    "x402-discovery": {
      "command": "npx",
      "args": ["-y", "@rplryan/x402-discovery-mcp"]
    }
  }
}

选项 C：直接调用 API

Discovery API 可公开访问——无需身份验证：

# Search for services
curl "https://x402scout.com/discover?query=blockchain+analytics&max_price_usd=0.01"

# Full catalog
curl "https://x402scout.com/.well-known/x402-discovery"

---

为什么这很重要

x402 中的发现缺口

x402 协议解决了支付问题，但没有解决发现问题。当存在数百种服务，而 Agent 却无法智能地找到、评估或路由到这些服务时，协议的全部价值便无法发挥。

本项目通过三个层面填补这一缺口：

1. 发现 — 按能力、类别和价格上限查找 x402 服务
2. 质量信号 — 正常运行时间百分比、延迟（毫秒）、facilitator 兼容性、ERC-8004 信任评分
3. 执行 — scout_relay 会自主发现、支付、重试并返回结果

与 x402.org/ecosystem 的不同之处

能力	x402.org/ecosystem	本项目
服务列表	✅ 名称 + URL	✅ 完整元数据
正常运行时间监控	❌ 无	✅ 实时健康检查
延迟数据	❌ 无	✅ 每项服务的毫秒级评分
Facilitator 兼容性	❌ 无	✅ 每项服务的标记
ERC-8004 信任信号	❌ 无	✅ 声誉评分
面向 Agent 的使用提示词	❌ 无	✅ 每项服务均有 llm_usage_prompt
自动更新的目录	❌ 手动	✅ 每 6 小时扫描一次
MCP 集成	❌ 无	✅ 9 个工具，已发布到注册表
语义搜索	❌ 无	✅ 关键词 + 类别 + 价格
自主执行	❌ 无	✅ scout_relay — 发现 + 支付 + 重试
Agent 集成提示	❌ 无	✅ 每项服务均有 howToUse 区块 — 精确的 x402 支付步骤

---

实时目录统计

Total Services:      Live — check https://x402scout.com/catalog
Auto-scan interval:  6 hours
Scan sources:        x402.org/ecosystem, awesome-x402, GitHub search
Categories:          data, compute, agent, utility
Facilitator-compat:  Flagged per service
Trust signals:       ERC-8004 per service
Primary URL:         https://x402scout.com
Trust scores:        0-100 per service (ERC-8004 based)
Payment metadata:    x402Config (address, asset, version) per service
Router:              Live at https://x402-scout-relay.onrender.com

目录示例

类别	数量	知名服务
数据	实时	CoinGecko、Einstein AI、DJD Agent Score、Ordiscan、Nansen、Zapper、AdEx AURA
实用工具	实时	dTelecom STT、Pinata、Tip.MD、Cybercentry、Trusta Attestation、AsterPay
计算	实时	BlockRun.AI、X402Engine、AurraCloud、AiMo、QuickSilver
Agent	实时	Questflow、Ubounty、Bitte Protocol、Farnsworth、SerenaI

---

示例：Agent 工作流

仅发现

# 1. Agent needs blockchain analytics under $0.01
result = x402_discover(
    query="blockchain analytics whale tracking",
    max_price_usd=0.01,
    category="data"
)
# Returns: ranked list with price, uptime %, latency, llm_usage_prompt

# 2. Scan for compliance + trust before paying
scan = x402_scan(url=result[0]["url"])

# 3. Check live health before committing
health = x402_health(url=result[0]["url"])

通过 scout_relay 完全自主执行

# One call — discovery + payment + retry handled automatically
result = scout_route(
    intent="blockchain analytics for wallet 0xABC",
    max_budget_usd=0.05
)
# Returns: {result: {...}, provider: "...", fee_usd: 0.003, trust_score: 82}

支付通过 x402 HTTP 协议使用 EIP-712 签名的 TransferWithAuthorization 完成，而非直接进行 ERC-20 转账。签名在服务器端验证；链上结算通过 receiveWithAuthorization 完成。

---

CDP Builder Grant 背景

本项目直接实现了 Coinbase 自己公开路线图中的两个项目：

摘自 coinbase/x402 中的 PROJECT-IDEAS.md：

“动态端点采购器 — 一个能够发现 MCP 注册表、支付访问费用，并串联多个服务结果的 Agent”

摘自 CDP x402 facilitator 路线图：

“为买方（人类和 Agent）提供发现层，以便查找可用服务（Bazaar）”

我们构建了社区版 Bazaar。它已经上线，包含官方页面没有的质量信号。并且它自身也使用 x402 支付——x402_discover 的费用为 0.010 USDC，通过其所服务的协议支付。scout_relay 在此基础上进一步扩展：它会自主路由并执行 x402 支付，并为这项服务收取自身的 x402 费用。

我们在 11 天内交付的内容

交付项	状态
x402 Service Discovery API v3.7.0	✅ 已在 Render 上线
x402 Discovery MCP Server	✅ Docker + GitHub MCP Registry
x402 RouteNet v1.0.0（智能路由）	✅ 已在 Render 上线
x402 Payment Harness v1.0.0（EOA 测试）	✅ PyPI pip install x402-payment-harness
持续增长且带有质量信号的目录	✅ 每 6 小时自动更新
ERC-8004 信任层	✅ 为每项服务评分
Facilitator 兼容层	✅ 付款前兼容性检查
已在 Base 上验证完整的 HTTP 402 协议流程	✅ EIP-712 签名 → X-PAYMENT 标头 → 200
x402scout CLI v1.0.0	✅ npm install -g x402scout
scout_relay v2.1.0（支付路由器）	✅ 已在 Render 上线
Provider placement bids (POST /placement/bid)	✅ 已上线 — 由 x402 门控，可自助使用
目录中的 x402Config 支付元数据	✅ 每项服务均包含 payment_address、asset_contract、x402Version
/scan 合规端点（付费）	✅ 已上线 — 合规等级、失配检测、信任评分
howToUse 集成说明块	✅ 在 /discover 结果中为每项服务提供精确的 x402 付款步骤
落地页（x402scout.com）	✅ NVG 绿色设计、实时统计数据、代码片段
端点安全加固	✅ SSRF 防护、速率限制、/register 仅允许 HTTPS
Smithery 评分	✅ 100/100
GitHub MCP Registry	✅ 已发布：io.github.rplryan/x402-discovery-mcp
ScoutGate v1.0.0（x402 API 变现网关）	✅ 已在 Render 上线 — 30 秒内即可为任意 API 接入 x402 付款

---

架构

┌─────────────────────────────────────────────────────┐
│              AI Agent (Claude / Cursor / Windsurf)  │
│                                                     │
│  x402_discover → x402_health → x402_attest         │
│  x402_scan → x402_register → x402_health           │
│                                                     │
│  scout_route → scout_execute → scout_audit          │
└──────────┬──────────────────────────┬───────────────┘
           │ MCP (stdio/Docker)       │ REST / MCP
┌──────────▼──────────┐    ┌──────────▼──────────────┐
│  x402 Discovery     │    │  scout_relay v2.1.0      │
│  MCP Server         │    │  x402-scout-relay        │
│  ghcr.io/rplryan/   │    │  .onrender.com           │
│  x402-discovery-mcp │    │  Fee: max($0.003, 2.5%)  │
└──────────┬──────────┘    └──────────┬───────────────┘
           │ HTTPS                    │ HTTPS
           └──────────────┬───────────┘
                          │
┌─────────────────────────▼───────────────────────────┐
│     x402 Discovery API (Render, v3.7.0)             │
│     https://x402scout.com                          │
│                                                     │
│  • Growing catalog  • Auto-scan every 6h            │
│  • Health checks  • Facilitator compat flags        │
│  • ERC-8004 trust • llm_usage_prompt per service    │
└─────────────────────────────────────────────────────┘

---

相关项目

项目	描述	状态
x402 Discovery API	为此 MCP 服务提供支持的 REST 后端	已上线 v3.7.0
scout_relay	自主 x402 支付路由器 — 一次调用即可完成发现 + 执行 + 审计	已上线 v2.1.0
x402 RouteNet	在已发现的服务之间进行智能路由	已上线 v1.0.0
x402 Payment Harness	基于 EOA 的 Python 库 + CLI，用于 x402 支付测试	PyPI v1.0.0
ScoutGate	30 秒内即可为任意现有 API 接入 x402 付款 — 无需了解协议	已上线 v1.0.0

---

注册你的服务

如果你正在构建支持 x402 的服务，可以将其添加到目录中：

curl -X POST https://x402scout.com/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Service",
    "url": "https://myservice.example.com/api",
    "price_usd": 0.010,
    "category": "data",
    "description": "What your service does",
    "network": "base-mainnet"
  }'

或者在 Claude/Cursor/Windsurf 中使用 x402_register MCP 工具。

想获得路由优先级？ 在 POST https://x402-scout-relay.onrender.com/placement/bid 注册 placement bid（由 x402 门控，注册费为 $0.01）。你的服务将在按信任评分筛选后，作为加权的决胜因素 — 始终以实力为先。

---

许可证

MIT

---

基于 Coinbase x402 protocol 构建 | Base Network | ERC-8004 | Model Context Protocol