rplryan/x402-discovery-mcp

> ⭐ 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.**
---
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.
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
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.
**4 MCP tools — add to any MCP client:**
| Tool | What It Does |
|------|--------------|
| scout_route | Discover best service for an intent + execute payment |
| scout_discover | Query the discovery catalog without executing |
| scout_execute | Execute payment to a known service URL |
| scout_audit | View 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.
| Endpoint | Description |
|----------|-------------|
| GET /health | Service health + version |
| POST /route | Route an intent (x402-gated) |
| POST /execute | Execute to a known URL (x402-gated) |
| GET /discover | Catalog discovery (free) |
| GET /audit | Spend log (free) |
| POST /placement/bid | Register a provider placement bid (x402-gated, $0.01) |
| GET /placement/bids | View 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
| Tool | What It Does | Cost |
|------|-------------|------|
| x402_discover | Semantic search across the live catalog by keyword, category, max price | **$0.010 USDC** *(pays via x402)* |