Add live web search to Claude Code (or any MCP client)

Superhighway guides

One command gives any MCP client five tools: live web search, news search, image search, read-any-page-as-markdown, and one-call research.

1. Install the MCP server

For Claude Code, run:

claude mcp add superhighway -e AGENT_PRIVATE_KEY=0x... -- npx -y superhighway-mcp

For any other MCP client (Cursor, Windsurf, a custom agent), add this to its MCP config:

{
  "mcpServers": {
    "superhighway": {
      "command": "npx",
      "args": ["-y", "superhighway-mcp"],
      "env": { "AGENT_PRIVATE_KEY": "0x..." }
    }
  }
}

2. Fund the agent's wallet

AGENT_PRIVATE_KEY is the private key of a wallet the agent pays from — searches cost $0.001 each in USDC on Base, settled automatically per call via the x402 protocol. No signup and no API key: the agent pays for exactly what it uses. A few dollars of USDC funds thousands of searches, and payment is gasless for the buyer (no ETH needed).

Prefer a regular API key and a monthly plan instead of a wallet? Grab a free key (1,000 calls/month, email only) and call the REST API directly with Authorization: Bearer <key>.

3. Use the tools

Your agent now has:

Tool	What it does
`web_search`	Live, ranked web results as clean JSON
`news_search`	Recent news with published dates
`image_search`	Image search — direct URLs, thumbnails, source pages
`scrape`	Read any URL as title + clean markdown
`research`	Search and read the top pages in one call

Ask the agent something that needs fresh information — "what changed in the latest Node LTS?" — and it will search, read, and answer from the live web instead of guessing from training data.

Troubleshooting

If a tool call fails with a payment error, the wallet is unfunded or AGENT_PRIVATE_KEY is unset. Test the API without any setup at https://superhighway.walls.sh/try?q=hello (free, no wallet).

More examples (LangChain, LlamaIndex, CrewAI, plain REST): walls-mcp-examples.