x402 Discovery MCP

io.github.rplryan由 GitHub 帳號 rplryan 發布v1.2.3更新於 Oct 24, 2026

Discover x402 APIs by capability, price & trust. Powered by x402Scout.

概覽

AI 產生的概覽

把助理接到 x402Scout 的 x402 付費 API 目錄,可搜尋服務、查看健康度與信任分數,並路由付費呼叫。

可以做什麼
  • 依關鍵字、類別與最高價格搜尋 x402 服務目錄,並附上每筆項目的品質訊號
  • 檢查服務的即時可用性與延遲,讀取其 ERC-8004 信任評分與信譽訊號
  • 對服務網址執行合規掃描,包含即時設定與不一致偵測
  • 把新的 x402 服務註冊到目錄中
  • 依意圖路由到最合適的服務並執行 x402 付款,或直接付款給已知的服務網址
  • 檢視代理的支出紀錄與預算狀態
適用情境
適合助理在呼叫前需要先尋找並評估可用的 x402 付費 API 時使用;也適合讓助理在預算範圍內自行完成探索、付款與稽核的付費 API 呼叫。
執行需求
需要遠端端點(中繼服務託管於 x402-scout-relay.onrender.com);README 另提供 Docker 與 npx 安裝探索伺服器的方式。清單未宣告任何驗證、環境變數或標頭。付費工具需要 x402 付款標頭與 Base 上的 USDC。
安裝前請注意
多個工具會花費 Base 主網上的真實 USDC:探索、健康檢查與掃描按次計費,路由或執行則收取下游交易金額的 max($0.003, 2.5%)。付款需以錢包憑證簽署,而清單未宣告這些憑證。註冊服務與競價項目會寫入公開目錄,註冊與競價端點有速率限制且需 x402 付費。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 x402 Discovery MCP,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 SSE。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.rplryan%2Fx402-discovery-mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "x402-discovery": {
      "type": "sse",
      "url": "https://x402-scout-relay.onrender.com/sse"
    }
  }
}

README

x402 Service Discovery MCP Server

⭐ Star to help others find this — if x402Scout has saved you time, a star helps other developers find it

The community-built Bazaar for the x402 agentic economy — a continuously growing catalog of live services with real-time quality signals, facilitator-compatibility checks, and ERC-8004 trust scoring. The discovery layer that Coinbase's own PROJECT-IDEAS.md asked the community to build.

[MCP Registry] [Smithery Score] [API Status] [Services Indexed] [scout_relay] [x402scout CLI] [ScoutGate] [License: MIT]


ScoutGate — Instant x402 API Monetization

Wrap any existing API in x402 payments in under 2 minutes — no protocol knowledge required

The x402 ecosystem's biggest friction point has been supply-side: getting an API behind x402 payments requires understanding EIP-712 headers, facilitator registration, and settlement logic. ScoutGate removes all of it.

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

That's it. Your API is now x402-enabled, auto-listed in x402Scout, and settling on Base mainnet in real USDC. ScoutGate handles facilitator integration, EIP-712 verification, and settlement.

Fee model: 2% per transaction (min $0.002). Live at: https://x402-scoutgate.onrender.com | Register your API


Terminal CLI — x402scout

Search the full x402 service catalog from your terminal

bash
# Install (npm)npm install -g x402scout
# Searchx402scout search "weather data"
# Top services by trust scorex402scout top 10
# Browse by categoryx402scout browse data
# Scan a URL for x402 compliancex402scout scan https://api.yourservice.com
# Ecosystem statsx402scout stats

See cli/README.md for full usage.


scout_relay — Autonomous Payment Router

Route, execute, and audit x402 payments in a single call

Where the Discovery MCP finds what to call, scout_relay handles calling it — discovering the best service, making the x402 payment, retrying on failure, and returning the result. One call. Fully autonomous.

bash
# Route an intent to the best matching x402 servicecurl -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 tools — add to any MCP client:

ToolWhat It Does
scout_routeDiscover best service for an intent + execute payment
scout_discoverQuery the discovery catalog without executing
scout_executeExecute payment to a known service URL
scout_auditView spend log and agent budget status

Fee model: max($0.003, 2.5% of downstream transaction value) per routed call.

Placement bids: Providers can register routing priority bids at POST /placement/bid (x402-gated, $0.01 registration fee). Bids are used as tiebreakers after trust-score filtering — merit first, always.

EndpointDescription
GET /healthService health + version
POST /routeRoute an intent (x402-gated)
POST /executeExecute to a known URL (x402-gated)
GET /discoverCatalog discovery (free)
GET /auditSpend log (free)
POST /placement/bidRegister a provider placement bid (x402-gated, $0.01)
GET /placement/bidsView all active placement bids (public)

Live at: https://x402-scout-relay.onrender.com


What This Is (30 seconds)

x402 is Coinbase's HTTP-native micropayment standard for the agentic web. An AI agent hits an endpoint, gets an HTTP 402 challenge, pays with USDC on Base, and receives data — no API keys, no subscriptions, pure machine-to-machine.

The problem: Hundreds of x402-payable services exist across the ecosystem. The official x402.org catalog lists names. That's it. No uptime data. No latency scores. No facilitator-compatibility flags. No trust signals. An agent has no way to know which services are actually live, trustworthy, or compatible with its payment flow.

This MCP server solves it. Connect any Claude, Cursor, or Windsurf agent directly to the x402 Service Discovery API — a continuously-updated catalog with real quality signals on every entry. Find services, check health, verify facilitator compatibility, and register new endpoints — all from inside your AI workflow.


MCP Tools (5 discovery + 4 relay = 9 total)

Discovery Tools

ToolWhat It DoesCost
x402_discoverSemantic search across the live catalog by keyword, category, max price$0.010 USDC (pays via x402)
x402_healthReal-time uptime + latency check for any registered service$0.001 USDC (pays via x402)
x402_registerRegister a new x402 service (HTTPS-only, rate-limited)Free
x402_attestERC-8004 trust score and reputation signals for a serviceFree
x402_scanFull x402 compliance scan: live config, trust score, mismatch detection$0.010 USDC (pays via x402)

Relay Tools (via scout_relay)

ToolWhat It DoesCost
scout_routeDiscover best service for an intent + execute x402 paymentmax($0.003, 2.5%)
scout_discoverQuery discovery catalog without executingFree
scout_executeExecute x402 payment to a known service URLmax($0.003, 2.5%)
scout_auditView agent spend log and budget statusFree

Quickstart — 30 Seconds to Discovery

Option A: Docker (recommended)

Add to your claude_desktop_config.json, Cursor MCP settings, or Windsurf config:

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

Option B: npx (no Docker required)

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

Option C: Direct API

The Discovery API is publicly accessible — no authentication required:

bash
# Search for servicescurl "https://x402scout.com/discover?query=blockchain+analytics&max_price_usd=0.01"
# Full catalogcurl "https://x402scout.com/.well-known/x402-discovery"

Why This Matters

The Discovery Gap in x402

The x402 protocol solves payment. It does not solve discovery. When hundreds of services exist but agents can't find, evaluate, or route to them intelligently, the protocol's full value is unrealized.

This project fills that gap with three layers:

  1. Discovery — Find x402 services by capability, category, price ceiling
  2. Quality signals — Uptime %, latency (ms), facilitator compatibility, ERC-8004 trust score
  3. Execution — scout_relay discovers, pays, retries, and returns results autonomously

What Makes This Different from x402.org/ecosystem

Capabilityx402.org/ecosystemThis Project
Service listings✅ Names + URLs✅ Full metadata
Uptime monitoring❌ None✅ Live health checks
Latency data❌ None✅ Per-service ms scores
Facilitator compatibility❌ None✅ Per-service flag
ERC-8004 trust signals❌ None✅ Reputation scoring
Agent-native usage prompts❌ None✅ llm_usage_prompt per service
Auto-updated catalog❌ Manual✅ Scans every 6 hours
MCP integration❌ None✅ 9 tools, registry-published
Semantic search❌ None✅ Keyword + category + price
Autonomous execution❌ None✅ scout_relay — discover + pay + retry
Agent integration hints❌ None✅ howToUse block per service — exact x402 payment steps

Live Catalog Stats

Total Services:      Live — check https://x402scout.com/catalogAuto-scan interval:  6 hoursScan sources:        x402.org/ecosystem, awesome-x402, GitHub searchCategories:          data, compute, agent, utilityFacilitator-compat:  Flagged per serviceTrust signals:       ERC-8004 per servicePrimary URL:         https://x402scout.comTrust scores:        0-100 per service (ERC-8004 based)Payment metadata:    x402Config (address, asset, version) per serviceRouter:              Live at https://x402-scout-relay.onrender.com

Catalog Sample

CategoryCountNotable Services
dataLiveCoinGecko, Einstein AI, DJD Agent Score, Ordiscan, Nansen, Zapper, AdEx AURA
utilityLivedTelecom STT, Pinata, Tip.MD, Cybercentry, Trusta Attestation, AsterPay
computeLiveBlockRun.AI, X402Engine, AurraCloud, AiMo, QuickSilver
agentLiveQuestflow, Ubounty, Bitte Protocol, Farnsworth, SerenaI

Example: Agent Workflow

Discovery only

python
# 1. Agent needs blockchain analytics under $0.01result = 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 payingscan = x402_scan(url=result[0]["url"])
# 3. Check live health before committinghealth = x402_health(url=result[0]["url"])

Full autonomous execution via scout_relay

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

Payments use EIP-712 signed TransferWithAuthorization via the x402 HTTP protocol — not direct ERC-20 transfer. Signature verified server-side; on-chain settlement via receiveWithAuthorization.


CDP Builder Grant Context

This project is a direct implementation of two items from Coinbase's own public roadmap:

From PROJECT-IDEAS.md in coinbase/x402:

"Dynamic Endpoint Shopper — An agent that discovers an MCP registry, pays for access, chains results from multiple services"

From the CDP x402 facilitator roadmap:

"A discovery layer for buyers (human and agents) to find available services (Bazaar)"

We built the community Bazaar. It's live. It has quality signals the official page doesn't. And it uses x402 payments itself — x402_discover costs $0.010 USDC, paid via the protocol it serves. scout_relay extends this: it routes and executes x402 payments autonomously, charging its own x402 fee for the service.

What We've Shipped (11 days)

DeliverableStatus
x402 Service Discovery API v3.7.0✅ Live on Render
x402 Discovery MCP Server✅ Docker + GitHub MCP Registry
x402 RouteNet v1.0.0 (smart routing)✅ Live on Render
x402 Payment Harness v1.0.0 (EOA testing)✅ PyPI pip install x402-payment-harness
Continuously growing catalog with quality signals✅ Auto-updating every 6h
ERC-8004 trust layer✅ Per-service trust scoring
Facilitator compatibility layer✅ Pre-payment compatibility check
Full HTTP 402 protocol flow proven on Base✅ EIP-712 sign → X-PAYMENT header → 200
x402scout CLI v1.0.0✅ npm install -g x402scout
scout_relay v2.1.0 (payment router)✅ Live on Render
Provider placement bids (POST /placement/bid)✅ Live — x402-gated, self-serve
x402Config payment metadata in catalog✅ payment_address, asset_contract, x402Version per service
/scan compliance endpoint (paid)✅ Live — compliance grade, mismatch detection, trust score
howToUse integration blocks✅ Per-service exact x402 payment steps in /discover results
Landing page (x402scout.com)✅ NVG green design, live stats, code snippets
Endpoint security hardening✅ SSRF guard, rate limiting, HTTPS-only on /register
Smithery score✅ 100/100
GitHub MCP Registry✅ Published: io.github.rplryan/x402-discovery-mcp
ScoutGate v1.0.0 (x402 API monetization gateway)✅ Live on Render — wrap any API in x402 payments in 30 seconds

Architecture

┌─────────────────────────────────────────────────────┐│              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    │└─────────────────────────────────────────────────────┘

Related Projects

ProjectDescriptionStatus
x402 Discovery APIREST backend powering this MCP serverLive v3.7.0
scout_relayAutonomous x402 payment router — discover + execute + audit in one callLive v2.1.0
x402 RouteNetSmart routing across discovered servicesLive v1.0.0
x402 Payment HarnessEOA-based Python library + CLI for x402 payment testingPyPI v1.0.0
ScoutGateWrap any existing API in x402 payments in 30 seconds — no protocol knowledge requiredLive v1.0.0

Register Your Service

If you're building an x402-enabled service, add it to the catalog:

bash
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"  }'

Or use the x402_register MCP tool from inside Claude/Cursor/Windsurf.

Want routing priority? Register a placement bid at POST https://x402-scout-relay.onrender.com/placement/bid (x402-gated, $0.01 registration fee). Your service gets weighted as a tiebreaker after trust-score filtering — merit first, always.


License

MIT


Built on Coinbase x402 protocol | Base Network | ERC-8004 | Model Context Protocol

來源:README.md,提交 4b8e69d

工具

0
SourceWeft 尚未讀取此伺服器的工具。

版本歷史

1
  1. v1.2.3最新Sep 16, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分