English Français العربية

io.github.x402-index/x402search-mcp

Official registry Search and web

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

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

Environment variables

  • PRIVATE_KEY required secret EVM private key for x402 payment signing

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  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

Frequently asked questions

What is io.github.x402-index/x402search-mcp?

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

How do I install io.github.x402-index/x402search-mcp?

It runs on your machine. In Claude Code: claude mcp add x402search-mcp -e 'PRIVATE_KEY=<your private_key>' -- npx -y x402search-mcp@1.0.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.x402-index/x402search-mcp need an API key?

Yes. It expects PRIVATE_KEY, which you set in its configuration.

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

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.x402-index/x402search-mcp?

It is published by x402-index. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.