MCP-server

De officiële Model Context Protocol-server stelt serp.cheap beschikbaar als tool die AI-agents kunnen aanroepen om live Google-resultaten te krijgen. Het is een pure API-client — hij praat alleen met het publieke POST /v1/search.

Pakket: @serpcheap/mcp (npx-bin serpcheap-mcp)
Tool: google_search
Transporten: stdio (standaard) en stateless Streamable HTTP

De `google_search`-tool

Argument	Type	Standaard	Opmerkingen
`q`	string (1–500)	—	De zoekopdracht (verplicht).
`gl`	enum	`us`	Land: `br us gb de fr es it mx ca au jp nl`.
`hl`	string	landstandaard	Resultaattaal (BCP-47, bijv. `en`, `pt-BR`).
`tbs`	enum	alle tijd	Tijdfilter: `qdr:h` / `qdr:d` / `qdr:w`.
`page`	int (1–99)	`1`	Resultaatpagina (~10 organische resultaten per pagina).

Hij geeft hetzelfde JSON terug als de REST-respons (organisch, Knowledge Graph, statistieken), weergegeven als leesbare markdown voor het model.

Snelste setup (Claude Code)

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

Voor Claude Desktop, Cursor, Windsurf en het remote HTTP-transport, zie Setup & clients.