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: " \
-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协议解决了 *支付*.它不能解决 *发现*当存在数百个服务,但代理无法智能地找到、评估或路由到它们时,协议的全部价值就无法实现。
这个项目用三层来填补这个空白:
- 发现 --按功能、类别、价格上限查找x402服务
- 质量信号 --正常运行时间百分比、延迟(毫秒)、主持人兼容性、ERC-8004信任评分
- 执行 --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|模型上下文协议*
