{
  "markdown": "# x402 Service Discovery MCP Server\n\n> [⭐ Star to help others find this](https://github.com/rplryan/x402-discovery-mcp) — if x402Scout has saved you time, a star helps other developers find it\n\n> **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.**\n\n[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-Published-blue?logo=github)](https://registry.modelcontextprotocol.io/servers/io.github.rplryan/x402-discovery-mcp)\n[![Smithery Score](https://img.shields.io/badge/Smithery-100%2F100-brightgreen?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0id2hpdGUiIGQ9Ik0xMiAyQzYuNDggMiAyIDYuNDggMiAxMnM0LjQ4IDEwIDEwIDEwIDEwLTQuNDggMTAtMTBTMTcuNTIgMiAxMiAyem0tMiAxNWwtNS01IDEuNDEtMS40MUwxMCAxNC4xN2w3LjU5LTcuNTlMMTkgOGwtOSA5eiIvPjwvc3ZnPg==)](https://smithery.ai/server/x402-discovery-mcp)\n[![API Status](https://img.shields.io/badge/API-Live-brightgreen)](https://x402scout.com)\n[![Services Indexed](https://img.shields.io/badge/Services%20Indexed-Live%20Catalog-brightgreen)](https://x402scout.com/catalog)\n[![scout_relay](https://img.shields.io/badge/scout__relay-v2.1.0-brightgreen)](https://x402-scout-relay.onrender.com)\n[![x402scout CLI](https://img.shields.io/badge/CLI-x402scout%201.0.0-brightgreen)](https://www.npmjs.com/package/x402scout)\n[![ScoutGate](https://img.shields.io/badge/ScoutGate-v1.0.0-brightgreen)](https://x402-scoutgate.onrender.com)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\n---\n\n## ScoutGate — Instant x402 API Monetization\n\n> Wrap any existing API in x402 payments in under 2 minutes — no protocol knowledge required\n\nThe 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.\n\n```bash\n# Register your existing API (30 seconds)\ncurl -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\"}'\n# Returns: {\"proxy_url\": \"https://x402-scoutgate.onrender.com/api/abc123\", \"api_id\": \"abc123\"}\n```\n\nThat'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.\n\n**Fee model:** 2% per transaction (min $0.002). **Live at:** https://x402-scoutgate.onrender.com | [Register your API](https://x402scout.com/register)\n\n---\n\n## Terminal CLI — x402scout\n\n> Search the full x402 service catalog from your terminal\n\n```bash\n# Install (npm)\nnpm install -g x402scout\n\n# Search\nx402scout search \"weather data\"\n\n# Top services by trust score\nx402scout top 10\n\n# Browse by category\nx402scout browse data\n\n# Scan a URL for x402 compliance\nx402scout scan https://api.yourservice.com\n\n# Ecosystem stats\nx402scout stats\n```\n\nSee [cli/README.md](cli/README.md) for full usage.\n\n---\n\n## scout_relay — Autonomous Payment Router\n\n> Route, execute, and audit x402 payments in a single call\n\nWhere 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.\n\n```bash\n# Route an intent to the best matching x402 service\ncurl -X POST https://x402-scout-relay.onrender.com/route \\\n  -H \"Content-Type: application/json\" \\\n  -H \"X-Payment: <your-x402-payment-header>\" \\\n  -d '{\"intent\": \"blockchain analytics for wallet 0xABC\", \"max_budget_usd\": 0.05}'\n```\n\n**4 MCP tools — add to any MCP client:**\n\n| Tool | What It Does |\n|------|--------------|\n| `scout_route` | Discover best service for an intent + execute payment |\n| `scout_discover` | Query the discovery catalog without executing |\n| `scout_execute` | Execute payment to a known service URL |\n| `scout_audit` | View spend log and agent budget status |\n\n**Fee model:** `max($0.003, 2.5% of downstream transaction value)` per routed call.\n\n**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.\n\n| Endpoint | Description |\n|----------|-------------|\n| `GET /health` | Service health + version |\n| `POST /route` | Route an intent (x402-gated) |\n| `POST /execute` | Execute to a known URL (x402-gated) |\n| `GET /discover` | Catalog discovery (free) |\n| `GET /audit` | Spend log (free) |\n| `POST /placement/bid` | Register a provider placement bid (x402-gated, $0.01) |\n| `GET /placement/bids` | View all active placement bids (public) |\n\n**Live at:** https://x402-scout-relay.onrender.com\n\n---\n\n## What This Is (30 seconds)\n\n**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.\n\n**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.\n\n**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.\n\n---\n\n## MCP Tools (5 discovery + 4 relay = 9 total)\n\n### Discovery Tools\n| Tool | What It Does | Cost |\n|------|-------------|------|\n| `x402_discover` | Semantic search across the live catalog by keyword, category, max price | **$0.010 USDC** *(pays via x402)* |\n| `x402_health` | Real-time uptime + latency check for any registered service | **$0.001 USDC** *(pays via x402)* |\n| `x402_register` | Register a new x402 service (HTTPS-only, rate-limited) | Free |\n| `x402_attest` | ERC-8004 trust score and reputation signals for a service | Free |\n| `x402_scan` | Full x402 compliance scan: live config, trust score, mismatch detection | **$0.010 USDC** *(pays via x402)* |\n\n### Relay Tools (via scout_relay)\n| Tool | What It Does | Cost |\n|------|-------------|------|\n| `scout_route` | Discover best service for an intent + execute x402 payment | max($0.003, 2.5%) |\n| `scout_discover` | Query discovery catalog without executing | Free |\n| `scout_execute` | Execute x402 payment to a known service URL | max($0.003, 2.5%) |\n| `scout_audit` | View agent spend log and budget status | Free |\n\n---\n\n## Quickstart — 30 Seconds to Discovery\n\n### Option A: Docker (recommended)\n\nAdd to your `claude_desktop_config.json`, Cursor MCP settings, or Windsurf config:\n\n```json\n{\n  \"mcpServers\": {\n    \"x402-discovery\": {\n      \"command\": \"docker\",\n      \"args\": [\"run\", \"-i\", \"--rm\", \"ghcr.io/rplryan/x402-discovery-mcp:latest\"]\n    }\n  }\n}\n```\n\n### Option B: npx (no Docker required)\n\n```json\n{\n  \"mcpServers\": {\n    \"x402-discovery\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@rplryan/x402-discovery-mcp\"]\n    }\n  }\n}\n```\n\n### Option C: Direct API\n\nThe Discovery API is publicly accessible — no authentication required:\n\n```bash\n# Search for services\ncurl \"https://x402scout.com/discover?query=blockchain+analytics&max_price_usd=0.01\"\n\n# Full catalog\ncurl \"https://x402scout.com/.well-known/x402-discovery\"\n```\n\n---\n\n## Why This Matters\n\n### The Discovery Gap in x402\n\nThe 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.\n\nThis project fills that gap with three layers:\n\n1. **Discovery** — Find x402 services by capability, category, price ceiling\n2. **Quality signals** — Uptime %, latency (ms), facilitator compatibility, ERC-8004 trust score\n3. **Execution** — scout_relay discovers, pays, retries, and returns results autonomously\n\n### What Makes This Different from x402.org/ecosystem\n\n| Capability | x402.org/ecosystem | This Project |\n|------------|-------------------|--------------|\n| Service listings | ✅ Names + URLs | ✅ Full metadata |\n| Uptime monitoring | ❌ None | ✅ Live health checks |\n| Latency data | ❌ None | ✅ Per-service ms scores |\n| Facilitator compatibility | ❌ None | ✅ Per-service flag |\n| ERC-8004 trust signals | ❌ None | ✅ Reputation scoring |\n| Agent-native usage prompts | ❌ None | ✅ `llm_usage_prompt` per service |\n| Auto-updated catalog | ❌ Manual | ✅ Scans every 6 hours |\n| MCP integration | ❌ None | ✅ 9 tools, registry-published |\n| Semantic search | ❌ None | ✅ Keyword + category + price |\n| Autonomous execution | ❌ None | ✅ scout_relay — discover + pay + retry |\n| Agent integration hints | ❌ None | ✅ `howToUse` block per service — exact x402 payment steps |\n\n---\n\n## Live Catalog Stats\n\n```\nTotal Services:      Live — check https://x402scout.com/catalog\nAuto-scan interval:  6 hours\nScan sources:        x402.org/ecosystem, awesome-x402, GitHub search\nCategories:          data, compute, agent, utility\nFacilitator-compat:  Flagged per service\nTrust signals:       ERC-8004 per service\nPrimary URL:         https://x402scout.com\nTrust scores:        0-100 per service (ERC-8004 based)\nPayment metadata:    x402Config (address, asset, version) per service\nRouter:              Live at https://x402-scout-relay.onrender.com\n```\n\n### Catalog Sample\n\n| Category | Count | Notable Services |\n|----------|-------|------------------|\n| **data** | [Live](https://x402scout.com/catalog) | CoinGecko, Einstein AI, DJD Agent Score, Ordiscan, Nansen, Zapper, AdEx AURA |\n| **utility** | [Live](https://x402scout.com/catalog) | dTelecom STT, Pinata, Tip.MD, Cybercentry, Trusta Attestation, AsterPay |\n| **compute** | [Live](https://x402scout.com/catalog) | BlockRun.AI, X402Engine, AurraCloud, AiMo, QuickSilver |\n| **agent** | [Live](https://x402scout.com/catalog) | Questflow, Ubounty, Bitte Protocol, Farnsworth, SerenaI |\n\n---\n\n## Example: Agent Workflow\n\n### Discovery only\n```python\n# 1. Agent needs blockchain analytics under $0.01\nresult = x402_discover(\n    query=\"blockchain analytics whale tracking\",\n    max_price_usd=0.01,\n    category=\"data\"\n)\n# Returns: ranked list with price, uptime %, latency, llm_usage_prompt\n\n# 2. Scan for compliance + trust before paying\nscan = x402_scan(url=result[0][\"url\"])\n\n# 3. Check live health before committing\nhealth = x402_health(url=result[0][\"url\"])\n```\n\n### Full autonomous execution via scout_relay\n```python\n# One call — discovery + payment + retry handled automatically\nresult = scout_route(\n    intent=\"blockchain analytics for wallet 0xABC\",\n    max_budget_usd=0.05\n)\n# Returns: {result: {...}, provider: \"...\", fee_usd: 0.003, trust_score: 82}\n```\n\nPayments use **EIP-712 signed `TransferWithAuthorization`** via the x402 HTTP protocol — not direct ERC-20 transfer. Signature verified server-side; on-chain settlement via `receiveWithAuthorization`.\n\n---\n\n## CDP Builder Grant Context\n\nThis project is a direct implementation of two items from Coinbase's own public roadmap:\n\n**From `PROJECT-IDEAS.md` in coinbase/x402:**\n> *\"Dynamic Endpoint Shopper — An agent that discovers an MCP registry, pays for access, chains results from multiple services\"*\n\n**From the CDP x402 facilitator roadmap:**\n> *\"A discovery layer for buyers (human and agents) to find available services (Bazaar)\"*\n\nWe 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.\n\n### What We've Shipped (11 days)\n\n| Deliverable | Status |\n|-------------|---------|\n| x402 Service Discovery API v3.7.0 | ✅ Live on Render |\n| x402 Discovery MCP Server | ✅ Docker + GitHub MCP Registry |\n| x402 RouteNet v1.0.0 (smart routing) | ✅ Live on Render |\n| x402 Payment Harness v1.0.0 (EOA testing) | ✅ PyPI `pip install x402-payment-harness` |\n| Continuously growing catalog with quality signals | ✅ Auto-updating every 6h |\n| ERC-8004 trust layer | ✅ Per-service trust scoring |\n| Facilitator compatibility layer | ✅ Pre-payment compatibility check |\n| Full HTTP 402 protocol flow proven on Base | ✅ EIP-712 sign → X-PAYMENT header → 200 |\n| x402scout CLI v1.0.0 | ✅ `npm install -g x402scout` |\n| scout_relay v2.1.0 (payment router) | ✅ Live on Render |\n| Provider placement bids (POST /placement/bid) | ✅ Live — x402-gated, self-serve |\n| x402Config payment metadata in catalog | ✅ payment_address, asset_contract, x402Version per service |\n| `/scan` compliance endpoint (paid) | ✅ Live — compliance grade, mismatch detection, trust score |\n| `howToUse` integration blocks | ✅ Per-service exact x402 payment steps in /discover results |\n| Landing page (x402scout.com) | ✅ NVG green design, live stats, code snippets |\n| Endpoint security hardening | ✅ SSRF guard, rate limiting, HTTPS-only on /register |\n| Smithery score | ✅ 100/100 |\n| GitHub MCP Registry | ✅ Published: `io.github.rplryan/x402-discovery-mcp` |\n| **ScoutGate v1.0.0** (x402 API monetization gateway) | ✅ Live on Render — wrap any API in x402 payments in 30 seconds |\n\n---\n\n## Architecture\n\n```\n┌─────────────────────────────────────────────────────┐\n│              AI Agent (Claude / Cursor / Windsurf)  │\n│                                                     │\n│  x402_discover → x402_health → x402_attest         │\n│  x402_scan → x402_register → x402_health           │\n│                                                     │\n│  scout_route → scout_execute → scout_audit          │\n└──────────┬──────────────────────────┬───────────────┘\n           │ MCP (stdio/Docker)       │ REST / MCP\n┌──────────▼──────────┐    ┌──────────▼──────────────┐\n│  x402 Discovery     │    │  scout_relay v2.1.0      │\n│  MCP Server         │    │  x402-scout-relay        │\n│  ghcr.io/rplryan/   │    │  .onrender.com           │\n│  x402-discovery-mcp │    │  Fee: max($0.003, 2.5%)  │\n└──────────┬──────────┘    └──────────┬───────────────┘\n           │ HTTPS                    │ HTTPS\n           └──────────────┬───────────┘\n                          │\n┌─────────────────────────▼───────────────────────────┐\n│     x402 Discovery API (Render, v3.7.0)             │\n│     https://x402scout.com                          │\n│                                                     │\n│  • Growing catalog  • Auto-scan every 6h            │\n│  • Health checks  • Facilitator compat flags        │\n│  • ERC-8004 trust • llm_usage_prompt per service    │\n└─────────────────────────────────────────────────────┘\n```\n\n---\n\n## Related Projects\n\n| Project | Description | Status |\n|---------|-------------|--------|\n| [x402 Discovery API](https://x402scout.com) | REST backend powering this MCP server | Live v3.7.0 |\n| [scout_relay](https://x402-scout-relay.onrender.com) | Autonomous x402 payment router — discover + execute + audit in one call | Live v2.1.0 |\n| [x402 RouteNet](https://github.com/rplryan/x402-routenet) | Smart routing across discovered services | Live v1.0.0 |\n| [x402 Payment Harness](https://github.com/rplryan/x402-payment-harness) | EOA-based Python library + CLI for x402 payment testing | PyPI v1.0.0 |\n| [ScoutGate](https://x402-scoutgate.onrender.com) | Wrap any existing API in x402 payments in 30 seconds — no protocol knowledge required | Live v1.0.0 |\n\n---\n\n## Register Your Service\n\nIf you're building an x402-enabled service, add it to the catalog:\n\n```bash\ncurl -X POST https://x402scout.com/register \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"name\": \"My Service\",\n    \"url\": \"https://myservice.example.com/api\",\n    \"price_usd\": 0.010,\n    \"category\": \"data\",\n    \"description\": \"What your service does\",\n    \"network\": \"base-mainnet\"\n  }'\n```\n\nOr use the `x402_register` MCP tool from inside Claude/Cursor/Windsurf.\n\n**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.\n\n---\n\n## License\n\nMIT\n\n---\n\n*Built on [Coinbase x402 protocol](https://github.com/coinbase/x402) | Base Network | ERC-8004 | Model Context Protocol*\n",
  "bytes": 16843,
  "sha": "cb5203184650f1d1e8ebdaef0cd4df1a66e8f207930436fce0517f6d2030b5ee",
  "repo_slug": "rplryan/x402-discovery-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_rplryan_x402_discovery_mcp_84808e43/readme"
}