x402search — Pay-Per-Search API Discovery for AI Agents
About
Search 13,000+ x402-enabled APIs from your AI agent. Powered by x402search.xyz
Explore
- Searches 14,000+ x402-enabled HTTP APIs
- Pay-per-search with $0.01 USDC fee
- No account or registration needed
- Supports EVM private key authentication
- Available as a Virtuals ACP agent (ID 22531)
- Returns structured API endpoint URLs and payment metadata
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
x402search — Pay-Per-Search API Discovery for AI AgentsCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- A wallet private key (EVM)
- USDC on Base mainnet (eip155:8453)
- Get USDC on Base: https://www.coinbase.com/how-to-buy/usdc
---
Add to your claude_desktop_config.json:
{
"mcpServers": {
"x402search": {
"command": "npx",
"args": ["[email protected]"],
"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
---
claude mcp add x402search -- npx [email protected]
export EVM_PRIVATE_KEY=0xYOUR_PRIVATE_KEY_HERE
---
Add to .cursor/mcp.json:
{
"mcpServers": {
"x402search": {
"command": "npx",
"args": ["[email protected]"],
"env": {
"EVM_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
}
}
}
}
---
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"x402search": {
"command": "npx",
"args": ["[email protected]"],
"env": {
"EVM_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
}
}
}
}
---
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)
---
EVM_PRIVATE_KEY=0xYOUR_KEY npx [email protected]
---
Parameter
Type
query
string
network
string
max_price_usdc
number
limit
number
| 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) |
---
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"x402search \u2014 pay-per-search api discovery for ai agents": {
"x402search": {
"command": "npx",
"args": [
"-y",
"x402search-mcp"
],
"env": {
"WALLET_PRIVATE_KEY": "<YOUR_PRIVATE_KEY>"
}
}
}
}
}McpServers
{
"x402search": {
"command": "npx",
"args": [
"-y",
"x402search-mcp"
],
"env": {
"WALLET_PRIVATE_KEY": "<YOUR_PRIVATE_KEY>"
}
}
}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 yourclaude_desktop_config.json:
{
"mcpServers": {
"x402search": {
"command": "npx",
"args": ["[email protected]"],
"env": {
"EVM_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
}
}
}
}
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
---
Install: Claude Code
claude mcp add x402search -- npx [email protected]
export EVM_PRIVATE_KEY=0xYOUR_PRIVATE_KEY_HERE
---
Install: Cursor
Add to.cursor/mcp.json:
{
"mcpServers": {
"x402search": {
"command": "npx",
"args": ["[email protected]"],
"env": {
"EVM_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HERE"
}
}
}
}
---
Install: Windsurf
Add to~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"x402search": {
"command": "npx",
"args": ["[email protected]"],
"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)
---
Quick Test
EVM_PRIVATE_KEY=0xYOUR_KEY npx [email protected]
---
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.orgSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
