x402serps

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

Web search MCP server for Claude Code, Cursor and n8n

Hosted web search MCP server with 19 tools: web, news, images, places, scholar, extract and research. $0.004 a search via x402 or card credits.

Source: https://x402serps.com/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

Remote MCP endpoint https://x402serps.com/api/mcp. One-click links below include the free-trial header X-Trial: 1 where the client supports it.

One-click installVS CodeOne-clickVS Code InsidersOne-clickClaudeOne-clickGooseOne-clickLM StudioOne-clickOne-click installAgent skillOne-click

CursorVS CodeVS Code InsidersClaudeClaude CodeClaude DesktopGooseLM StudioKiroWindsurf / DevinChatGPTCodex CLIGemini CLIZedClineWarpRaycastAgent skill

Cursor

~/.cursor/mcp.json or .cursor/mcp.json

Copy

Official Cursor install link. Opens Cursor and prompts to add the server.

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

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.ai

Settings → Connectors → add https://x402serps.com/api/mcp, or use the mcp-remote bridge JSON below so the trial header is set.

{ "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 / Devin Desktop

~/.config/devin/mcp_config.json (older installs: ~/.codeium/windsurf/mcp_config.json)

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

Codex CLI

codex mcp add x402serps --url https://x402serps.com/api/mcp

[mcp_servers.x402serps] url = "https://x402serps.com/api/mcp" http_headers = { "X-Trial" = "1" }

Gemini CLI

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

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

Cline

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

{ "mcpServers": { "x402serps": { "type": "streamableHttp", "url": "https://x402serps.com/api/mcp", "headers": { "X-Trial": "1" }, "disabled": false, "autoApprove": [] } } }

Zed

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

Warp

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

LM Studio

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

Kiro

{ "mcpServers": { "x402serps": { "url": "https://x402serps.com/api/mcp", "headers": { "X-Trial": "1" }, "disabled": false, "autoApprove": [] } } }

Raycast

Install MCP Server → Transport: HTTP → URL https://x402serps.com/api/mcp, header X-Trial: 1.

ChatGPT

Developer mode → Plugins → Add custom MCP server → URL https://x402serps.com/api/mcp.

Goose

goose session --with-streamable-http-extension "https://x402serps.com/api/mcp"

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: (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>

---

Agents: llms.txt https://x402serps.com/llms.txt · OpenAPI https://x402serps.com/openapi.json · MCP https://x402serps.com/api/mcp · Contact hello@x402serps.com