DEV Community

rplryan
rplryan

Posted on Edited on

Add x402 Service Discovery to Claude and Cursor in 30 Seconds

#agents #ai #mcp #web3

The Problem

You're building with Claude, Cursor, or Cline. You want to call a paid x402 API — but you have no idea which services exist, what they cost, or whether they're actually up. You end up hardcoding endpoints or manually browsing directories.

There's a better way.

The Solution: 2 Config Lines

Add the x402 Service Discovery MCP server to your Claude Desktop or Cursor config:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "x402-discovery": {
      "url": "https://x402-discovery-api.onrender.com/smithery",
      "transport": "http"
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

Cursor (.cursor/mcp.json in your project root):

{
  "mcpServers": {
    "x402-discovery": {
      "url": "https://x402-discovery-api.onrender.com/smithery",
      "transport": "http"
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

Restart Claude/Cursor. That's it.

What Claude Can Now Do

Ask Claude: "Find me x402 APIs for web scraping"

Claude will call x402_discover and return live results from 251+ indexed x402 services — with real health scores, latency data, and ERC-8004 trust signals.

Found 3 services matching 'web scraping':

1. Firecrawl — Web Scraping & Extraction API
   Price: $0.002/request | Health: Healthy | Uptime: 99.1%
   URL: https://api.firecrawl.dev/x402/scrape
   Tags: scraping, markdown, llm-ready

2. Browserless — Headless Chrome API
   Price: $0.005/request | Health: Healthy | Uptime: 98.7%
   URL: https://chrome.browserless.io/content
   Tags: browser, automation, screenshot

3. Jina AI Reader — URL to LLM-Ready Content
   Price: $0.0001/request | Health: Healthy | Uptime: 99.8%
   URL: https://r.jina.ai/x402
   Tags: reader, markdown, content
Enter fullscreen mode Exit fullscreen mode

6 MCP Tools Available

Tool What it does Cost
x402_discover Search 251+ services by keyword/capability $0.005 USDC
x402_browse Browse full catalog by category Free
x402_health Check uptime & latency for any service Free
x402_register Add your own service to the catalog Free
x402_trust ERC-8004 on-chain trust profile lookup Free
x402_facilitator_check Verify facilitator compatibility Free

Note on x402_discover: The $0.005 cost is an x402 micropayment — the protocol handles it automatically if your agent has a Base/USDC wallet. For manual browsing, use x402_browse (always free).

251+ Services Indexed

The catalog auto-scans x402.org/ecosystem, awesome-x402, and the Coinbase Bazaar every 6 hours. Current categories:

  • data (60+): Einstein AI, SIBYL token scoring, DJD Agent Score, Nansen, Zapper, CoinGecko…
  • compute (40+): BlockRun.AI (28 LLM APIs), AurraCloud, X402Engine…
  • utility (50+): Firecrawl, Browserless, dTelecom STT, Pinata…
  • agent (30+): Questflow, AgentKit reference, Ubounty…

All with real uptime monitoring and health scoring — not just a static list.

Smart Routing: x402 RouteNet

Once you discover services, RouteNet picks the best one:

curl "https://x402-routenet.onrender.com/route?q=web+scraping&strategy=best"
Enter fullscreen mode Exit fullscreen mode

Four routing strategies: cheapest, fastest, most_trusted, best (composite score).

Trust Layer: ERC-8004

Ask Claude: "Find me a web scraping API that's ERC-8004 verified"

{
  "name": "Firecrawl",
  "uptime_pct": 99.1,
  "avg_latency_ms": 145,
  "erc8004_verified": true,
  "erc8004_reputation_score": 87
}
Enter fullscreen mode Exit fullscreen mode

Browse the Catalog Right Now

No setup needed:

curl "https://x402-discovery-api.onrender.com/catalog"
Enter fullscreen mode Exit fullscreen mode

Register Your Service (Free) 

import requests
requests.post('https://x402-discovery-api.onrender.com/register', json={
    'name': 'My AI Service',
    'description': 'Does something useful for agents',
    'url': 'https://myservice.com/api',
    'category': 'data',
    'price_usd': 0.001,
    'network': 'base'
})
Enter fullscreen mode Exit fullscreen mode

Links

x402 is Coinbase's open standard for HTTP-native micropayments. Learn more →

Top comments (1)

Some comments may only be visible to logged-in visitors. Sign in to view all comments.