MCP server

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

Tools

Tool	Args	Price
`web_search`	query, num	$0.01
`news_search`	query, num	$0.01
`extract`	url, maxChars	$0.003
`search_extract`	query, n (1-5), maxChars	$0.02
`batch_search`	queries (1-25), num	$0.15
`image_search`	query, num, gl	$0.01
`places_search`	query, num, gl, location	$0.01
`shopping_search`	query, num, gl	$0.01
`scholar_search`	query, num, gl	$0.01
`video_search`	query, num, gl	$0.01
`deep_research`	query, n (3-8), maxChars	$0.08
`ai_visibility_check`	brand, keywords (1-10), gl	$0.10

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 X-PAYMENT header 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 x402 / x402-fetch 1.2.x to sign payments.

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