MCP setup & clients

Pick your client. All you need is your serp.cheap API key.

claude mcp add google-cheap-search -e SERPCHEAP_API_KEY=your-key -- npx -y @serpcheap/mcp

Add to your client’s MCP config (claude_desktop_config.json, Cursor mcp.json, …):

{
  "mcpServers": {
    "google-cheap-search": {
      "command": "npx",
      "args": ["-y", "@serpcheap/mcp"],
      "env": { "SERPCHEAP_API_KEY": "your-key" }
    }
  }
}

Point any MCP client at the hosted server and pass your key as a bearer token:

{
  "mcpServers": {
    "google-cheap-search": {
      "url": "https://mcp.serp.cheap/mcp",
      "headers": { "Authorization": "Bearer your-key" }
    }
  }
}

CLI flags

serpcheap-mcp [--stdio | --http] [--host 127.0.0.1] [--port 7100] [--allowed-hosts <csv>] [-v]

Environment

Variable	Default	Notes
`SERPCHEAP_API_KEY`	—	Required for stdio (HTTP can use per-request auth).
`SERPCHEAP_BASE_URL`	`https://api.serp.cheap`	API base URL override.
`SERPCHEAP_TIMEOUT_MS`	`20000`	Upstream timeout (1000–120000).