io.github.x402-index/x402search-mcp

Registre officiel Recherche et web

Search 13,000+ x402-enabled APIs from your AI agent. Powered by x402search.xyz

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package x402search-mcp
Claude Code
claude mcp add x402search-mcp -e 'PRIVATE_KEY=<your private_key>' -- npx -y x402search-mcp@1.0.2
Configuration JSON (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "x402search-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "x402search-mcp@1.0.2"
            ],
            "env": {
                "PRIVATE_KEY": "<your private_key>"
            }
        }
    }
}

Variables d'environnement

  • PRIVATE_KEY obligatoire secret EVM private key for x402 payment signing

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. x402search MCP Server
  2. Requirements
  3. Install: Claude Desktop
  4. Install: Claude Code
  5. Install: Cursor
  6. Install: Windsurf
  7. Install: Python agents (LangChain, CrewAI, AutoGen, GAME SDK)
  8. Quick Test
  9. Tool: search_x402_apis
  10. Virtuals ACP Integration
  11. Links

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

Questions fréquentes

Qu'est-ce que io.github.x402-index/x402search-mcp ?

Search 13,000+ x402-enabled APIs from your AI agent. Powered by x402search.xyz

Comment installer io.github.x402-index/x402search-mcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add x402search-mcp -e 'PRIVATE_KEY=<your private_key>' -- npx -y x402search-mcp@1.0.2. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.x402-index/x402search-mcp ?

Oui. Il attend PRIVATE_KEY, à renseigner dans sa configuration.

io.github.x402-index/x402search-mcp est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient io.github.x402-index/x402search-mcp ?

Il est publié par x402-index. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.