About io.github.x402-index/x402search-mcp
io.github.x402-index/x402search-mcp is an MCP server published by x402-index in the Blockchain category: search 13,000+ x402-enabled APIs from your AI agent. Powered by x402search.xyz.
The repository has 2 stars and 0 forks, with the last commit 6 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
claude mcp add io-github-x402-index-x402search-mcp -- npx -y x402search-mcpnpx -y x402search-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (1)
search_x402_apisSearch 14,000+ x402-enabled HTTP APIs by capability, category, network, or keyword. Returns ranked results with endpoint URLs, pricing, and payment metadata. Use this to discover paid APIs for any capability your agent needs. Costs $0.01 USDC per search on Base mainnet.
Parameters not published.
Ask AI
Ask AI about io.github.x402-index/x402search-mcp
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.