convez.ai
MCP ServerIntegração & APIsIntermediário
x402-index

x402search MCP Server

x402-index/x402search-mcp

Acesso a 14k+ APIs x402 via agentes de IA com pagamento por requisição

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP 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-mcp

1 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

Estrelas
2
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 7 meses
Versão
—
Issues abertas
3
Contribuidores
2

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


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

ParameterTypeRequiredDescription
querystringyese.g. "token price API", "DEX swap routing"
networkstringnoe.g. "eip155:8453" for Base mainnet
max_price_usdcnumbernoFilter to APIs at or below this price
limitnumbernoMax 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

Ver o original no GitHub

Bom para

Relacionados