x402 Discovery MCP Server

The community-built Bazaar for the x402 agentic economy

README.md

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.


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.

# 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

# 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

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.

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

**Liv

Tools 4

scout_routeDiscover best service for an intent and 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

Try it

Find the best x402-enabled service for blockchain analytics for wallet 0xABC.
Search the x402 catalog for weather data services.
Check my current agent spend log and budget status.
Execute a payment to the service at https://api.yourservice.com.

Frequently Asked Questions

What are the key features of x402 Discovery?

Real-time quality signals and service health monitoring. Facilitator-compatibility checks for x402 payments. ERC-8004 trust scoring for service providers. Autonomous payment routing and execution. Spend logging and agent budget auditing.

What can I use x402 Discovery for?

Finding and paying for high-quality API services using x402 payments. Automating agentic workflows that require paid data or compute services. Auditing agent spending across multiple x402-enabled service providers. Discovering the most cost-effective or fastest services for a specific intent.

How do I install x402 Discovery?

Install x402 Discovery by running: npx -y x402-discovery-mcp

What MCP clients work with x402 Discovery?

x402 Discovery works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep x402 Discovery docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Open Conare