x402serps

npx add-mcp 'https://x402serps.com/api/mcp'

Web search MCP server

A hosted MCP server for AI agents: web, news, image, places, shopping, scholar and video search, plus extract, research and crawl. Search is $0.004 a call, paid with USDC over x402 (no account) or with card credits. Results come from a third-party search provider.

Setup guides: Claude Code · Cursor · OpenCode · n8n · all 20 guides · Search API for AI agents · x402 search API

Endpoint (streamable HTTP, JSON): https://x402serps.com/api/mcp

Add to Cursor Install in VS Code VS Code (web link) Claude setup Agent skill file

Claude Code: claude mcp add --transport http x402serps https://x402serps.com/api/mcp --header "X-Trial: 1" · Claude Desktop: Settings → Connectors → add https://x402serps.com/api/mcp, or use the JSON config below. Free trial header included; swap for Authorization: Bearer xs_... once you have a credit key.

Tools

Tool	Args	Price
web_search	q, num, freshness, dateFrom, dateTo, tbs, gl, hl, page	$0.004/10 results
news_search	q, num, freshness, dateFrom, dateTo, tbs, gl, hl, page	$0.004/10 results
extract	url, urls, maxChars	$0.003/URL
search_extract	q, n, maxChars	$0.02
batch_search	queries, num	$0.08
image_search	q, num, gl	$0.004
places_search	q, num, gl, location	$0.004
shopping_search	q, num, gl	$0.004
scholar_search	q, num, gl	$0.004
video_search	q, num, gl	$0.004
deep_research	q, n, maxChars	$0.08
ai_visibility_check	brand, keywords, gl	$0.10
competitor_report	domain, keywords, gl	$0.30
lead_finder	q, location, num, gl	$0.25
seo_audit	domain, brand, pages, gl	$0.20
news_digest	topics, num, since, gl	$0.05
answer	q, n, freshness, gl	$0.02
crawl_site	url, limit, maxChars, include	$0.002/page
map_site	url, limit, search	$0.002

How payment works over MCP

initialize and tools/list are free. Each tools/call is paid with x402: the client sends a signed USDC payment (Base or Solana) in the PAYMENT-SIGNATURE header (v2; legacy v1 clients may use X-PAYMENT) of the MCP HTTP request. If it is missing, the tool result contains the x402 payment requirements (price, network, payTo) so an x402-aware agent can pay and retry. Use the v2 client @x402/fetch with @x402/evm (Base) or @x402/svm (Solana) to sign payments; see docs.

Free trial over MCP

Add the header X-Trial: 1 to the MCP connection (the configs below already do). You get 25 free calls per network (IPv4 /24), at most 10 a minute, on single-query tools. After that, calls return the normal payment requirements. Remove the header once you pay with x402.

Claude Code

claude mcp add --transport http x402serps https://x402serps.com/api/mcp --header "X-Trial: 1"

Claude Desktop

claude_desktop_config.json (uses the mcp-remote bridge; or add https://x402serps.com/api/mcp under Settings → Connectors)

{
  "mcpServers": {
    "x402serps": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://x402serps.com/api/mcp",
        "--header",
        "X-Trial:1"
      ]
    }
  }
}

Cursor

~/.cursor/mcp.json or.cursor/mcp.json — or one-click install in Cursor

{
  "mcpServers": {
    "x402serps": {
      "url": "https://x402serps.com/api/mcp",
      "headers": {
        "X-Trial": "1"
      }
    }
  }
}

VS Code

.vscode/mcp.json (or run the command below)

{
  "servers": {
    "x402serps": {
      "type": "http",
      "url": "https://x402serps.com/api/mcp",
      "headers": {
        "X-Trial": "1"
      }
    }
  }
}

code --add-mcp '{"name":"x402serps","type":"http","url":"https://x402serps.com/api/mcp","headers":{"X-Trial":"1"}}'

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "x402serps": {
      "serverUrl": "https://x402serps.com/api/mcp",
      "headers": {
        "X-Trial": "1"
      }
    }
  }
}

Generic streamable-HTTP client

URL:       https://x402serps.com/api/mcp
Transport: streamable HTTP (POST JSON-RPC, JSON responses)
Headers:   X-Trial: 1      (free trial)  or  X-PAYMENT: <x402 payload>  (paid)

curl -s -X POST https://x402serps.com/api/mcp -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

curl -s -X POST https://x402serps.com/api/mcp -H 'content-type: application/json' -H 'X-Trial: 1' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"web_search","arguments":{"query":"x402"}}}'

Registry metadata: /server.json (MCP Registry name com.x402serps/search) · /.well-known/mcp.json