# Superhighway

> Web search for AI agents. Search the live web, pull recent news, and read any page as clean
> markdown — paid per call in USDC over HTTP via the x402 protocol. No signup, no API key,
> no human in the loop. Wall #001 of walls.sh.

## How to pay
Each paid endpoint returns HTTP 402 with x402 payment requirements (USDC on Base). An x402 client
signs the payment and retries automatically. Free trial, no wallet: https://api-production-17e1.up.railway.app/try?q=hello

## Endpoints (USDC on Base via x402, or an API-key plan)
- GET https://api-production-17e1.up.railway.app/search?q=&limit= — live web search → {query,count,results[]} ($0.001)
- GET https://api-production-17e1.up.railway.app/news?q=&limit= — recent news with published dates ($0.001)
- GET https://api-production-17e1.up.railway.app/images?q=&limit= — image search → {query,count,results[{title,url,img_src,thumbnail}]} ($0.001)
- GET https://api-production-17e1.up.railway.app/scrape?url= — read any page as clean markdown → {title,markdown,text} ($0.002)
- GET https://api-production-17e1.up.railway.app/research?q=&pages= — search + read the top pages in ONE call → results + markdown ($0.005)
- GET https://api-production-17e1.up.railway.app/openapi.json — machine-readable spec

## Use as an MCP tool
Add to any MCP client: npx -y superhighway-mcp
(env: AGENT_PRIVATE_KEY = a funded Base wallet, X402_NETWORK = base)
Gives the tools: web_search, news_search, image_search, scrape, research.

## Links
- Guides (setup, pay-per-call flow, one-call research): https://api-production-17e1.up.railway.app/guides
- Examples + tutorial: https://github.com/patwalls/walls-mcp-examples
- How it compares: https://github.com/patwalls/walls-mcp-examples/blob/master/COMPARISON.md
- MCP package: https://github.com/patwalls/superhighway-mcp
- x402 protocol: https://x402.org
- Directory of agent-native businesses: https://walls.sh