rplryan

Posted on Feb 26 • Edited on Feb 27

Add x402 Service Discovery to Claude and Cursor in 30 Seconds

#ai #mcp #web3 #agents

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

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

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

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

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"

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
}

Browse the Catalog Right Now

No setup needed:

curl "https://x402-discovery-api.onrender.com/catalog"

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'
})

DEV Community