x402search — Pay-Per-Search API Discovery for AI Agents

by x402-index

2 stars

272 downloads

Not rated

GitHub

About

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

Details

Author: x402-index
GitHub stars: 2
Downloads: 272
Categories: Developer Tools, Search

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 Agents

Command (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

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "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>"
                }
            }
        }
    }
}

JSON

{
    "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>"
                }
            }
        }
    }
}

JSON

{
    "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>"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "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>"
                }
            }
        }
    }
}

JSON

{
    "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>"
                }
            }
        }
    }
}

JSON

{
    "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>"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "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>"
                }
            }
        }
    }
}

JSON

{
    "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>"
                }
            }
        }
    }
}

JSON

{
    "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>"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "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>"
                }
            }
        }
    }
}

JSON

{
    "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>"
                }
            }
        }
    }
}

JSON

{
    "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>"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "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>"
                }
            }
        }
    }
}

JSON

{
    "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>"
                }
            }
        }
    }
}

JSON

{
    "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>"
                }
            }
        }
    }
}

From the repository

Install via npm or pip, then configure the MCP client with your EVM private key. For Claude Desktop, add the server to claude_desktop_config.json. For Python agents, install the package and call search_x402_apis(). The tool accepts a query string and optional network, max price, and limit parameters.

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 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

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

x402search MCP Server

Requirements

Install: Claude Desktop

Install: Claude Code

Install: Cursor

Install: Windsurf

Install: Python agents (LangChain, CrewAI, AutoGen, GAME SDK)

Quick Test

Tool: search_x402_apis

Virtuals ACP Integration

Links

Install

More like this

Sentry

Github

Brave Search

Git

GitLab

Context 7