Summary
This connects your AI agent to a searchable index of 14,000+ x402-enabled HTTP APIs, all payable with USDC on Base. Each search costs $0.01 and runs against endpoints that support the x402 protocol for machine-to-machine payments. You get back structured results with endpoint URLs, pricing metadata, network info, and relevance scores. Use it when you need to discover blockchain, DeFi, or crypto APIs on the fly without manually hunting through docs or setting up individual API keys. It works with Claude Desktop, Cursor, Windsurf, and Python frameworks like LangChain. You'll need a wallet private key and a small USDC balance on Base mainnet to run queries.
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →x402search MCP Server
Search 14,000+ x402-enabled HTTP APIs from any MCP-compatible agent.
Version: 1.0.3 · License: MIT · Cost: $0.01 USDC per search · Base mainnet · No account needed
npm: https://www.npmjs.com/package/x402search-mcp
PyPI: https://pypi.org/project/x402search-mcp
API: https://x402search.xyz
Requirements
- A wallet private key (EVM)
- USDC on Base mainnet (eip155:8453)
- Get USDC on Base: https://www.coinbase.com/how-to-buy/usdc
Install: Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"x402search": {
"command": "npx",
"args": ["x402search-mcp@1.0.3"],
"env": {
"EVM_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
}
}
}
}
Config file location:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Install: Claude Code
claude mcp add x402search -- npx x402search-mcp@1.0.3
Then set your key:
export EVM_PRIVATE_KEY=0xYOUR_PRIVATE_KEY_HERE
Install: Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"x402search": {
"command": "npx",
"args": ["x402search-mcp@1.0.3"],
"env": {
"EVM_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
}
}
}
}
Install: Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"x402search": {
"command": "npx",
"args": ["x402search-mcp@1.0.3"],
"env": {
"EVM_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
}
}
}
}
Install: Python agents (LangChain, CrewAI, AutoGen, GAME SDK)
pip install x402search-mcp
from x402search import search_x402_apis
results = search_x402_apis(
query="token price API ethereum",
private_key="0xYOUR_PRIVATE_KEY_HERE"
)
print(results)
Full docs: https://pypi.org/project/x402search-mcp
Quick Test
EVM_PRIVATE_KEY=0xYOUR_KEY npx x402search-mcp@1.0.3
Tool: search_x402_apis
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | yes | e.g. "token price API", "DEX swap routing" |
| network | string | no | e.g. "eip155:8453" for Base mainnet |
| max_price_usdc | number | no | Filter to APIs at or below this price |
| limit | number | no | Max results (default 10, max 50) |
Virtuals ACP Integration
x402search is available as a native ACP agent on the Virtuals protocol marketplace.
- Agent ID: 22531
- Agent profile: https://app.virtuals.io/acp/agent-details/22531
- Job name:
x402search - Price: 0.01 USDC per search
- Accepts crypto, DeFi, and blockchain API discovery queries
- Rejects off-topic requests automatically at the request phase
- Returns structured results: endpoint URLs, payment metadata, network, and relevance rank
Links
- npm: https://www.npmjs.com/package/x402search-mcp
- PyPI: https://pypi.org/project/x402search-mcp
- API: https://x402search.xyz
- Health: https://x402search.xyz/health
- GitHub: https://github.com/x402-index/x402search-mcp
- x402 protocol: https://x402.org
Featured
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Configuration
PRIVATE_KEY*secretEVM private key for x402 payment signing
Categories
Registryactive
Packagex402search-mcp
TransportSTDIO
AuthRequired
UpdatedMar 8, 2026
