superhighway-mcp

A web_search tool for AI agents that pays for itself.

An MCP server that gives any MCP-speaking agent (Claude Desktop, etc.) a real-time web search tool. Under the hood it pays Superhighway $0.001 per search in USDC via the x402 protocol, using your wallet — no API key, no signup, no human in the loop.

Install

Add to your MCP client config (e.g. Claude Desktop's claude_desktop_config.json):

{
  "mcpServers": {
    "superhighway": {
      "command": "npx",
      "args": ["-y", "github:patwalls/superhighway-mcp"],
      "env": {
        "AGENT_PRIVATE_KEY": "0xYOUR_FUNDED_BASE_WALLET_KEY",
        "X402_NETWORK": "base"
      }
    }
  }
}

Restart your client. The agent now has a web_search(query, limit?) tool.

Wallet

AGENT_PRIVATE_KEY is a wallet you control, funded with a little USDC on Base (each search costs $0.001; gas is covered by the facilitator, so you don't need ETH). The key only ever signs tiny USDC payments — keep it to a small balance.

Want to try free first? Set X402_NETWORK=base-sepolia and fund the wallet from a Base Sepolia faucet to pay in test USDC.

What you get

web_search returns ranked organic results as JSON:

{ "query": "...", "count": 5, "results": [ { "title": "...", "url": "...", "description": "..." } ] }

Powered by Superhighway — the web-search API agents pay for.