MCP server
The official Model Context Protocol server exposes serp.cheap as tools that AI agents can call to get live Google results. It’s a pure API client — it talks only to the public REST API.
- Package:
@serpcheap/mcp(npx binserpcheap-mcp) - Tools:
google_search,seo_rank - Transports: stdio (default) and stateless Streamable HTTP
The google_search tool
Section titled “The google_search tool”| Argument | Type | Default | Notes |
|---|---|---|---|
q | string (1–500) | — | The search query (required). |
gl | enum | us | Country: br us gb de fr es it mx ca au jp nl. |
hl | string | country default | Result language (BCP-47, e.g. en, pt-BR). |
tbs | enum | all time | Time filter: qdr:h / qdr:d / qdr:w. |
page | int (1–99) | 1 | Result page (~10 organic results each). |
It returns the same JSON as the REST response (organic, Knowledge Graph, stats), rendered as readable markdown for the model.
The seo_rank tool
Section titled “The seo_rank tool”Finds where a site ranks for a keyword — the MCP wrapper for POST /v1/rank.
| Argument | Type | Default | Notes |
|---|---|---|---|
url | string (1–2048) | — | Domain or full URL to locate (required). |
q | string (1–500) | — | The keyword to rank for (required). |
gl | enum | us | Country: br us gb de fr es it mx ca au jp nl. |
hl | string | country default | Result language (BCP-47). |
tbs | enum | all time | Time filter: qdr:h / qdr:d / qdr:w. |
pages | int (1–10) | 1 | Result pages to scan (10 = top 100). Billed per page. |
match_type | enum | domain | domain (incl. subdomains/paths) or exact. |
It returns the absolute rank of the best match, every matches[] position, and partial/pages_failed.
Fastest setup (Claude Code)
Section titled “Fastest setup (Claude Code)”claude mcp add google-cheap-search -e SERPCHEAP_API_KEY=your-key -- npx -y @serpcheap/mcpFor Claude Desktop, Cursor, Windsurf and the remote HTTP transport, see Setup & clients.