x402search MCP Server is an MCP-compatible server for AI agents, used to search x402-enabled HTTP APIs. Its core purpose is to let agents discover callable paid APIs by keyword during runtime.
Main capabilities
- Search 14,000+ x402-enabled HTTP APIs (the page also states 13,000+).
- Provides the tool search_x402_apis, returning structured results including endpoint URLs, payment metadata, networks, and relevance rankings.
- Supports invocation from any MCP-compatible agent.
- Also listed as a native ACP agent on the Virtuals protocol marketplace (Agent ID: 22531). The ACP integration accepts crypto, DeFi, and blockchain API discovery queries, and automatically rejects irrelevant requests at the request stage.
Fees and prerequisites
- Each search costs 0.01 USDC, settled via x402 micropayments on Base mainnet, with no account required.
- Requirements: an EVM wallet private key; USDC on Base mainnet (eip155:8453). The link to obtain USDC is https://www.coinbase.com/how-to-buy/usdc。
Version and license
- Version: 1.0.3; License: MIT.
Installation and integration methods The following integration paths are provided, and the page gives the corresponding configuration locations, but the specific configuration content (such as JSON snippets and command parameters) is not fully provided in the material:
- Claude Desktop: add configuration in claude_desktop_config.json. File locations: macOS is ~/Library/Application Support/Claude/claude_desktop_config.json; Windows is %APPDATA%\Claude\claude_desktop_config.json.
- Claude Code: set the key after installation.
- Cursor: add to .cursor/mcp.json.
- Windsurf: add to ~/.codeium/windsurf/mcp_config.json.
- Python agents (LangChain, CrewAI, AutoGen, GAME SDK): see the PyPI page for full documentation.
Related links
- npm:https://www.npmjs.com/package/x402search-mcp
- PyPI：https://pypi.org/project/x402search-mcp
- API：https://x402search.xyz
- Health check:https://x402search.xyz/health
- GitHub：https://github.com/x402-index/x402search-mcp
- x402 protocol:https://x402.org
- Virtuals ACP agent profile:https://app.virtuals.io/acp/agent-details/22531
Applicable scenarios Scenarios that require automatically discovering and retrieving available x402 paid APIs within agent workflows, especially crypto, DeFi, and blockchain-related API discovery queries.
Limitations Each search requires a payment of 0.01 USDC, and you must hold Base mainnet USDC and an EVM wallet private key; the ACP integration rejects requests unrelated to crypto, DeFi, and blockchain API discovery.
