I built a pay-per-search API discovery engine — no API keys, just crypto (x402)

x402 Discovery Index — Sun, 08 Mar 2026 12:19:32 +0000

AI agents are getting good at calling APIs. The problem is they still need a human in the loop to find the right API, sign up for an account, generate a key, fund a balance, and paste credentials into
a config file. That's fine for a one-time integration — but it's a complete non-starter for an autonomous agent that needs to discover and use new APIs on the fly.

 I wanted to fix that. Here's what I built.

 ## The problem

 When an agent needs a capability it doesn't have — weather data, image generation, price feeds, web scraping — it has no good way to go find a paid API on its own. Every API monetization model today
 assumes a human is doing the signup. There's no standard way for a machine to say "I want this capability, here's payment, give me the result."

 That's the gap I'm trying to close.

 ## What is x402?

 x402 is an open protocol that brings the [HTTP 402 Payment Required](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/402) status code to life. When a client hits an x402-enabled endpoint without
  paying, the server returns a `402` with a machine-readable payment request. The client pays on-chain (USDC on Base mainnet, typically), attaches a payment proof header, and retries — all in a single
 round-trip. No accounts, no API keys, no dashboards. Just a wallet and an HTTP client.

 ## What x402search does

 [x402search](https://x402search.xyz) is a discovery engine for x402-enabled APIs. It indexes 14,000+ APIs across the x402 ecosystem and exposes them via an MCP (Model Context Protocol) tool that Claude,
 Cursor, Windsurf, and any MCP-compatible agent can call natively.

 Each search costs **$0.01 USDC** on Base mainnet — paid automatically by the agent using the x402 protocol. No signup. No rate limit tiers. No API key to rotate. The agent pays for what it uses, finds
 what it needs, and moves on.

 The search tool understands natural language queries and supports filters for network (`eip155:8453` for Base) and max price. Results come back with endpoint URLs, descriptions, pricing, and the payment
 metadata needed to actually call the API.

 ## Install in 2 lines

 Add this to your MCP config (Claude Desktop, Cursor, Windsurf, etc.):

 ```json
 {
   "mcpServers": {
     "x402search": {
       "command": "npx",
       "args": ["-y", "x402search-mcp"],
       "env": {
         "EVM_PRIVATE_KEY": "<YOUR_PRIVATE_KEY>"
       }
     }
   }
 }
 ```

 Your wallet needs a small amount of USDC on Base mainnet. At $0.01 per search, $1 gets you 100 queries. The MCP server handles payment automatically — the agent just calls `search_x402_apis` with a query
  string.

 ## How it works under the hood

 When the agent calls `search_x402_apis`, the MCP server sends a POST to `https://x402search.xyz/v1/search`. The server returns a `402` with a payment request: network `eip155:8453`, amount `10000` (0.01
 USDC in 6-decimal format), recipient address, and a nonce.

 The x402 client library signs and submits a USDC transfer on Base mainnet, attaches the `X-Payment` header with the proof, and retries the request. The server verifies the on-chain payment and returns
 the search results. The whole flow is a couple of seconds — no polling, no webhooks.

 Under the hood the MCP server uses `@x402/axios` to wrap a standard Axios instance, `@x402/evm` to handle the EVM signing with `viem`, and `@modelcontextprotocol/sdk` to expose the tool over stdio. The
 private key stays local — it never leaves the agent's environment.

 ## Current status

 The indexer is live and running against the [CDP Bazaar](https://github.com/coinbase/cdp-bazaar) dataset with 12,845+ resources indexed. The search API is running on Base mainnet and accepting real
 payments. The MCP package is published on npm.

 What's next:
 - Broader index coverage beyond CDP Bazaar
 - Keyword + semantic hybrid search
 - An agent that can not just *find* APIs but autonomously compose multi-step workflows across them
 - A public leaderboard of the most-queried capabilities

Update — March 2026: OpenAI Agents SDK example

x402search now works as an MCP server inside OpenAI Agents SDK. Your agent
can discover paid APIs at runtime — no hardcoded endpoints.

Full working example: https://github.com/x402-index/x402search-agent-example

Proof of payment on-chain: 0x1148ce8c7bf8793ab5a74896e3a850bcf7400cd6502225c15f4f896d59fa3af8

 ## Try it

 The package is on npm: [x402search-mcp](https://www.npmjs.com/package/x402search-mcp)

 Source is on GitHub: [x402-index/x402search-mcp](https://github.com/x402-index/x402search-mcp)

 Live index at: [x402search.xyz](https://x402search.xyz)

 If you're building with MCP or exploring the x402 ecosystem, drop a star and let me know what you're working on. I'm especially curious about use cases where agents need to *compose* multiple paid APIs
 in a single task — that's where this gets interesting.

Update: Use x402search with OpenAI Agents SDK

If you're building with OpenAI Agents SDK, you can add x402search as an MCP
server and let your agent discover paid APIs at runtime — no hardcoded endpoints.

Full example repo: https://github.com/x402-index/x402search-agent-example

The agent:

Connects to x402search as an MCP server
Searches for APIs matching its task ("crypto market data", "web scraping", etc.)
Pays $0.01 USDC automatically from its Base wallet
Gets back endpoint URLs, descriptions, and pricing

Proof it works — on-chain payment tx:
0x1148ce8c7bf8793ab5a74896e3a850bcf7400cd6502225c15f4f896d59fa3af8

Install:
\


bash
git clone https://github.com/x402-index/x402search-agent-example
cd x402search-agent-example
pip3.11 install -r requirements.txt
cp .env.example .env  # add your OpenAI key + EVM private key
python3.11 main.py
\`\`\`

DEV Community: x402 Discovery Index

I built a pay-per-search API discovery engine — no API keys, just crypto (x402)

Update — March 2026: OpenAI Agents SDK example

Update: Use x402search with OpenAI Agents SDK