x402服务发现MCP服务器

x402服务发现MCP服务器是一个社区构建的x402代理经济市场,提供实时质量信号、促进者兼容性检查和ERC-8004信任评分的服务目录,支持AI工作流中的服务发现、健康检查和端点注册。

  • by rplryan
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 rplryan/x402-discovery-mcp

使用说明

x402服务发现MCP服务器

⭐ Star帮助其他人找到这个 --如果x402Scout为您节省了时间,那么星号可以帮助其他开发人员找到它

社区为x402代理经济构建了Bazaar,这是一个不断增长的实时服务目录,具有实时质量信号、主持人兼容性检查和ERC-8004信任评分。Coinbase自己的PROJECT-IDEAS.md要求社区构建的发现层。


ScoutGate-即时x402 API货币化

在2分钟内完成x402付款中的任何现有API-无需协议知识

x402生态系统最大的摩擦点一直是供应方:获得API 后面 x402支付需要了解EIP-712标头、协调人注册和结算逻辑。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主网上定居 以实际美元计算。ScoutGate负责协调人集成、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在哪里找到 什么 呼叫, 侦察接力 手柄 称之为 --发现最佳服务,支付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 查看支出日志和代理预算状态

收费模式: max($0.003, 2.5% of downstream transaction value) 每个路由呼叫。

配售投标: 供应商可以在以下网址注册路由优先级出价 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针对代理网络的HTTP原生微支付标准。人工智能代理命中端点,获得HTTP 402挑战,在Base上使用USDC付款,并接收数据——没有API密钥,没有订阅,纯机器对机器。

问题: 整个生态系统中存在数百种x402付费服务。官方的x402.org目录列出了名字。就是这样。没有正常运行时间数据。无延迟评分。没有主持人兼容性标志。没有信任信号。代理无法知道哪些服务实际上是实时的、值得信赖的,或者与它的支付流兼容。

这个MCP服务器解决了这个问题。 将任何Claude、Cursor或Windsurf代理直接连接到x402 Service Discovery API,这是一个持续更新的目录,每个条目都有真实的质量信号。查找服务、检查健康状况、验证主持人兼容性以及注册新端点——所有这些都可以在您的AI工作流程中完成。


MCP工具(5个发现+4个中继=9个)

发现工具

工具 功能 成本
x402_discover 按关键字、类别、最高价格在实时目录中进行语义搜索 0.010美元直流电 (通过x402支付)
x402_health 任何注册服务的实时正常运行时间+延迟检查 0.001美元直流电 (通过x402支付)
x402_register 注册新的x402服务(仅限HTTPS,价格有限) 免费
x402_attest ERC-8004服务的信任评分和声誉信号 免费
x402_scan 完整的x402合规性扫描:实时配置、信任评分、不匹配检测 0.010美元直流电 (通过x402支付)

继电器工具(通过scout_Relay)

工具 功能 成本
scout_route 发现意图+执行x402付款的最佳服务 最高(0.003美元,2.5%)
scout_discover 不执行查询发现目录 免费
scout_execute 向已知服务URL执行x402付款 最大值(0.003美元,2.5%)
scout_audit 查看代理支出日志和预算状态 免费

快速入门——30秒发现

选项A:Docker(推荐)

添加到您的 claude_desktop_config.json、光标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协议解决了 支付.它不能解决 发现当存在数百个服务,但代理无法智能地找到、评估或路由到它们时,协议的全部价值就无法实现。

这个项目用三层来填补这个空白:

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

这与x402.org/ecosystem有何不同

能力 x402.org/ecosystem 本项目
服务列表 ✅ 名称+网址 ✅ 完整元数据
正常运行时间监控 ❌ 无 ✅ 实时健康检查
延迟数据 ❌ 无 ✅ 每项服务ms得分
主持人兼容性 ❌ 无 ✅ 每个服务标志
ERC-8004信任信号❌ 无 ✅ 声誉评分
代理本机使用提示 ❌ 无 ✅ llm_usage_prompt 每次服务
自动更新目录 ❌ 手册 ✅ 每6小时扫描一次
MCP集成 ❌ 无 ✅ 9个工具,注册表已发布
语义搜索 ❌ 无 ✅ 关键词+品类+价格
自主执行 ❌ 无 ✅ scout_relay--发现+支付+重试
代理集成提示 ❌ 无 ✅ 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。医学博士,Cybercentry,Trusta认证,AsterPay
计算 生活 BlockRun。AI、X402引擎、AurraCloud、AiMo、QuickSilver
代理 生活 Questflow、Ubounty、比特协议、法恩斯沃斯、塞雷娜

示例:代理工作流

仅限发现

# 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}

付款使用 EIP-712已签署 TransferWithAuthorization 通过x402 HTTP协议,而不是直接的ERC-20传输。签名已在服务器端验证;通过链上结算 receiveWithAuthorization.


CDP生成器授权上下文

该项目是Coinbase自己的公共路线图中两项内容的直接实施:

自 PROJECT-IDEAS.md 在coinbase/x402中:

“动态端点购物者——一个发现MCP注册表、支付访问费用、链接多个服务结果的代理”

来自CDP x402主持人路线图:

“买家(人和代理人)查找可用服务的发现层(Bazaar)”

我们建立了社区集市。这是现场直播。它有官方页面没有的质量信号 使用x402支付本身 — x402_discover 通过其服务的协议支付的费用为0.010美元。scout_relay扩展了这个:it 路由和执行 x402自主支付,收取自己的x402服务费。

我们发货了什么(11天)

可交付成果 状态
x402服务发现API v3.7.0 ✅ 实时渲染
x402发现MCP服务器 ✅ Docker+GitHub MCP注册表
x402 RouteNet v1.0.0(智能路由) ✅ 实时渲染
x402支付工具v1.0.0(EOA测试) ✅ PyPI pip install x402-payment-harness
不断增长的优质信号目录 ✅ 每6小时自动更新一次
ERC-8004信任层 ✅ 每项服务信任评分
主持人兼容性层 ✅ 预付款兼容性检查
在Base上验证了完整的HTTP 402协议流 ✅ EIP-712标志→ X-PAYMENT标头→ 200
x402scout CLI v1.0.0 ✅ npm install -g x402scout
scout_relay v2.1.0(支付路由器) ✅ 实时渲染
供应商配售出价(POST/配售/出价) ✅ 直播--x402门控,自助式
x402配置目录中的支付元数据 ✅ payment_address,asset_contract,x402每个服务的版本
/scan 合规性端点(付费) ✅ 实时——合规等级、错配检测、信任评分
howToUse 集成块 ✅ 每项服务精确x402付款步骤/发现结果
登录页面(x402scout.com) ✅ NVG绿色设计、实时统计数据、代码片段
端点安全强化 ✅ SSRF保护、速率限制、仅HTTPS登录/注册
Smithery评分 ✅ 100/100
GitHub MCP注册表 ✅ 出版: io.github.rplryan/x402-discovery-mcp
ScoutGate v1.0.0 (x402 API货币化网关) ✅ 实时渲染-在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路虎发现API 支持此MCP服务器的REST后端 Live v3.7.0
侦察接力 自主x402支付路由器——一键发现+执行+审核 Live v2.1.0
x402路由网 跨已发现服务的智能路由 Live v1.0.0
x402付款工具 基于EOA的Python库+CLI用于x402支付测试 PyPI v1.0.0
ScoutGate 在30秒内完成x402支付中的任何现有API-无需协议知识 Live 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"
  }'

或者使用 x402_register 来自Claude/Cursor/Windsurf内部的MCP工具。

想要路由优先级? 在以下网址注册配售出价 POST https://x402-scout-relay.onrender.com/placement/bid (x402门,0.01美元注册费)。在信任评分过滤后,您的服务将被加权为决胜局——始终以业绩为先。


许可证

麻省理工学院


建立在 Coinbase x402协议 |基础网络|ERC-8004|模型上下文协议