x402search MCP Server
x402-index/x402search-mcp
Acesso a 14k+ APIs x402 via agentes de IA com pagamento por requisição
Ver no GitHubMCP server que conecta agentes de IA a um índice de 14.000+ APIs habilitadas para x402 (protocolo de pagamento microtransacional). Permite buscar, filtrar e integrar APIs de blockchain, DeFi e Web3 diretamente em agentes Claude, LangChain, CrewAI e Cursor. Opera com microtransações em USDC (Base mainnet) sem necessidade de conta.
Instalação
npx convez-ai x402-index/x402search-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Agentes que precisam descobrir e integrar APIs de blockchain/DeFi dinamicamente
- Buscas de dados cripto, preços de tokens e roteamento de swaps DEX
- Automatização de consultas a múltiplas APIs com modelo de pagamento por uso
Veredito

Ferramenta especializada e robusta para ecossistema blockchain/DeFi. Requer setup com wallet privada e USDC, o que limita adoção casual, mas oferece acesso único a índice de APIs monetizadas. Integração limpa com Claude, Python e Cursor; pricing transparente de $0.01 por busca.
README
A tradução para o português deste README ainda está na fila.
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