MCP server
Give Claude, Cursor, VS Code, ChatGPT or any MCP client live Google search through SerpKite's remote MCP server: one URL, OAuth sign-in or an API key, 23 tools.
SerpKite runs a remote Model Context Protocol server. Any MCP client that speaks streamable HTTP can connect to it and call Google search, News, Maps, Scholar, a page fetcher, cited answers, deep research, AI assistants (ChatGPT, Gemini, Copilot Search, Google AI Mode, Brave) and more as tools. There is nothing to install or host.
| URL | https://api.serpkite.com/v1/mcp |
| Transport | Streamable HTTP (stateless) |
| Auth | OAuth 2.1 sign-in, or Authorization: Bearer skt_live_… |
| Protocol versions | 2025-06-18, 2025-03-26, 2024-11-05 |
| Billing | Same credits as the REST endpoints |
Clients that support MCP OAuth (Claude and ChatGPT connectors, Claude Code) only need the URL: they open a SerpKite sign-in page and you approve the connection. Everywhere else, send an API key in the Authorization header.
Claude (custom connector)
In Claude on the web or desktop, open Settings → Connectors → Add custom connector, name it SerpKite and enter https://api.serpkite.com/v1/mcp. Leave the OAuth client fields empty. Claude opens a SerpKite page: sign in, check that the page names Claude and claude.ai, and click Approve. The SerpKite tools then appear in the connector menu of a chat.
On Team and Enterprise plans an owner adds the connector once under Organization settings → Connectors, and each member connects their own SerpKite account.
Get a key
For clients that use an API key, create one in the dashboard under API keys (see API keys). For MCP use, a dedicated key with a monthly credit limit is a good idea: an agent in a loop can make many calls, and the limit caps what that key can spend. The examples below read the key from the SERPKITE_API_KEY environment variable.
Claude Code
One command adds the server to Claude Code:
claude mcp add --transport http serpkite https://api.serpkite.com/v1/mcp
Then run /mcp in Claude Code, pick serpkite and choose Authenticate: your browser opens the SerpKite approval page. To use an API key instead of OAuth, add --header "Authorization: Bearer $SERPKITE_API_KEY" to the command.
Run claude mcp list to check the connection, then ask Claude something that needs fresh results (“what changed in the latest Go release?”). Add --scope project to write the config to .mcp.json so your whole team gets it, but keep any key out of version control.
Claude Desktop with a config file
Claude Desktop launches local (stdio) servers from claude_desktop_config.json. To reach a remote server with a custom header, use the mcp-remote bridge, which runs through npx:
{
"mcpServers": {
"serpkite": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.serpkite.com/v1/mcp",
"--header",
"Authorization: Bearer ${SERPKITE_API_KEY}"
],
"env": {
"SERPKITE_API_KEY": "skt_live_..."
}
}
}
}
The file lives at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS and %APPDATA%\Claude\claude_desktop_config.json on Windows. Restart Claude Desktop after editing it. You need Node.js installed for npx.
A custom connector needs no config file, no Node.js and no key, so prefer it where your plan offers one.
Cursor
Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):
{
"mcpServers": {
"serpkite": {
"url": "https://api.serpkite.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${env:SERPKITE_API_KEY}"
}
}
}
}
Open Cursor Settings → MCP to check that the server is green and its tools are listed. If your Cursor version doesn’t expand ${env:…}, paste the key directly and keep the file out of git.
VS Code
VS Code (Copilot agent mode) reads .vscode/mcp.json. The inputs block prompts for the key once and stores it securely, so it never lands in the file:
{
"inputs": [
{
"type": "promptString",
"id": "serpkite-key",
"description": "SerpKite API key",
"password": true
}
],
"servers": {
"serpkite": {
"type": "http",
"url": "https://api.serpkite.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${input:serpkite-key}"
}
}
}
}
Start the server from the MCP: List Servers command, then pick the SerpKite tools in the agent tool picker.
ChatGPT
ChatGPT can connect remote MCP servers as connectors when developer mode is enabled for your workspace. Create a connector with the URL https://api.serpkite.com/v1/mcp and OAuth authentication; ChatGPT registers itself and sends you to the SerpKite approval page. For OpenAI models in your own code, use the tool calling guide instead, or the OpenAI Agents SDK, which accepts MCP server headers.
Other clients
Any client that supports streamable HTTP with custom headers works with the same two values: the URL and the Authorization header. Clients that only support stdio can use npx -y mcp-remote https://api.serpkite.com/v1/mcp --header "Authorization: Bearer …" as the command, as in the Claude Desktop example.
Sign in with OAuth
The server implements the MCP authorization spec, so an MCP client can connect with nothing but the URL.
- A request without a credential gets
401withWWW-Authenticate: Bearer resource_metadata="https://api.serpkite.com/.well-known/oauth-protected-resource/v1/mcp", scope="mcp". - That protected resource metadata names
https://app-api.serpkite.comas the authorization server, whose metadata is at/.well-known/oauth-authorization-server. - The client registers itself (dynamic client registration, or a Client ID Metadata Document URL as its
client_id) and starts an authorization code flow with PKCE (S256only) andresource=https://api.serpkite.com/v1/mcp. - You sign in to the SerpKite dashboard if needed and approve the request. The page shows the app’s name and the address your browser returns to; check both. If that address is on your own computer (
localhost), approve only a connection you just started. - The client gets an access token (
skt_oat_…, valid one hour) and a refresh token (skt_ort_…, 60 days, replaced on every use) and calls/v1/mcpwithAuthorization: Bearer skt_oat_….
Billing and limits. An approved connection runs as an API key named after the app, such as Claude (OAuth), which appears on your API keys page. Its calls are billed to your credits, count toward your spend cap and show up in the request log like any key’s. Give it a monthly credit limit to cap what the connection can spend, or revoke it to disconnect the app right away. Connecting the same app again reuses the key. A team member’s connection runs on the team account with the member key limit the owner set.
Scope. OAuth tokens work on /v1/mcp only; the REST endpoints need an API key. Tokens are stored as SHA-256 hashes, and a refresh token that is used twice ends the connection, in case it leaked.
Tools
All 23 tools return text formatted for a model. Search, webpage, answer and AI assistant tools use Markdown; map and extract format their results as text; crawl and research return a task ID, and crawl_result / research_result return its status, pages or report. Billing matches the corresponding REST operation, and polling is free. Every tool has a title and annotations: all are read-only (readOnlyHint: true) except crawl and research, which start paid tasks; none is destructive, and all reach the open web (openWorldHint: true).
| Tool | What it does | Inputs | Credits |
|---|---|---|---|
search |
Google web search: organic results, answer box, knowledge graph, People Also Ask, related searches, and optionally a cited answer | q, country, language, location, page, time, engine, num (10, 20, 30, 50, 100), include_content (0–5), highlights, include_answer, include_domains, exclude_domains, boost_domains, start_date, end_date |
1 per page, up to 7 for num: 100, +1 per fetched page; include_answer +2, or +4 with include_content (free if it fails) |
news |
Google News articles | q, country, language, location, page, time, engine, include_domains, exclude_domains, boost_domains, start_date, end_date |
1 |
maps |
Places with address, rating, phone, website, coordinates and the place_id / cid (or oid with engine: "yandex") the place tool takes |
q, country, language, location, ll, page, engine |
1 |
place |
One place’s details: address, hours, phones, time zone, description | place_id, cid, fid, oid, country, language |
1 (free when no place matches) |
scholar |
Academic papers with citations and PDF links | q, country, language, page |
1 |
patents |
Patent search | q, country, language, page |
1 |
shopping |
Products with prices and merchants | q, country, language, location, page |
1 |
images |
Image search | q, country, language, location, page, engine, include_domains, exclude_domains, start_date, end_date |
1 |
videos |
Video search | q, country, language, location, page, engine, include_domains, exclude_domains, start_date, end_date |
1 |
autocomplete |
Query suggestions | q, country, language |
0.5 |
chatgpt |
Ask ChatGPT as a logged-out user (searching the web): the answer as Markdown with the sources it cited and the products and places it showed | prompt, country, web_search, track |
5; takes 10–30 s |
gemini |
Ask Google Gemini as a logged-out user: the answer with the sources it grounded on | prompt, country, language, track |
5; takes 5–30 s |
copilot |
Ask Microsoft Copilot Search on Bing: the answer with cited sources and products | prompt, country, language, track |
3; takes 15–40 s |
ai_mode |
Ask Google AI Mode: the answer with cited sources | prompt, country, language, track |
3; takes 5–45 s |
brave_ai |
Ask Brave Search’s AI answer: cited sources, the searches it ran and products | prompt, country, language, track |
2; takes 1–10 s |
webpage |
Fetch a public URL (HTML or PDF) and return its main content as Markdown with metadata | url, country |
1 |
answer |
A short answer from live Google results with numbered [n] citations, written by Claude |
q, depth (fast, standard), num_sources (1–5), country, language, time, include_domains, exclude_domains |
3 fast, 8 standard with 3 pages; the model part is free if it fails |
extract |
Read up to 20 URLs (HTML or PDF) as Markdown, only the passages relevant to a query, a summary, or JSON for a schema | urls, query, highlights, max_tokens, country, timeout, summary, output_schema, prompt |
1 per URL read, +4 per summary, +4 per output_schema extraction (failed URLs and AI steps are free) |
crawl |
Start an async crawl of a site (or a section of it); returns an ID | url, limit, max_depth, query, include_paths, exclude_paths, max_tokens |
1 per page read (limit reserved, the rest refunded) |
crawl_result |
The status or the pages of a crawl started with crawl |
id |
Free |
map |
List a site’s URLs from its sitemaps and start page, optionally ranked by a search phrase | url, search, limit, include_paths, exclude_paths |
1 (free when nothing is found) |
research |
Start an async deep-research task: planned Google searches, page reading and a cited Markdown report; returns an ID | input, effort (lite, standard, deep) |
30, 75 or 200, charged only when the report is written |
research_result |
The status or the report of a task started with research |
id |
Free |
Query tools and answer require q; the AI assistant tools require prompt (up to 4,000 characters), and with track (up to 20 brands or domains) their Markdown ends with a Mentions section saying whether each was named or cited; place requires one of place_id, cid or fid (from a maps result); webpage, map and crawl require url; extract requires urls; research requires input; crawl_result and research_result require id. Search highlights is a boolean used with include_content; extract highlights is an integer passage count (0–10). time is one of hour, day, week, month, year. As with the REST API, failed and empty calls are not billed.
The MCP schemas expose a subset of REST options. Use tools/list to inspect the available inputs, or call REST/SDKs for options such as extract links/images, answer streaming and output_schema, research output_schema and webhooks, crawl and research cancellation and monitor management. The site ingestion guide and monitoring guide cover those workflows.
Test it with curl
The server is stateless: every POST carries one JSON-RPC 2.0 message (or a batch of up to 20) and gets a JSON reply. No session setup is needed, which makes it easy to test by hand.
Initialize:
curl https://api.serpkite.com/v1/mcp \
-H "Authorization: Bearer $SERPKITE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'
List the tools:
curl https://api.serpkite.com/v1/mcp \
-H "Authorization: Bearer $SERPKITE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
Call search:
curl https://api.serpkite.com/v1/mcp \
-H "Authorization: Bearer $SERPKITE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search","arguments":{"q":"best espresso machine 2026","country":"us"}}}'
The result’s content array holds a text item with the Markdown. Notifications (messages without an id) get an empty 202 Accepted. A missing or invalid key returns 401 with the usual error body and the OAuth WWW-Authenticate challenge described above.
Costs and safety
- Search and content-reading calls are billed like their REST equivalents;
crawl_resultandresearch_resultpolling is free. Failed and empty results are not billed, and neither is a failed AI step. - The
answer,researchand extract AI options send the question and page text to Anthropic (and OpenAI for decision checks) under their API terms, which exclude training on API data. See Privacy and data retention. - Give the MCP key a monthly
credit_limitso a runaway agent loop stops at a known cost. When the limit is hit, calls fail withkey_limit_reachedand nothing more is charged. See Spend controls. - The AI assistant tools send the prompt to the assistant you call (OpenAI’s ChatGPT, Google’s Gemini and AI Mode, Microsoft’s Copilot Search, Brave), as a logged-out visitor without your identity. Failed or refused answers are free. If
chatgptorgeminifails withupstream_timeoutsaying the answer is being finished in the background, call the tool again with the same arguments within 10 minutes to receive it. See AI assistants. - The server only fetches public, logged-out pages. The
webpagetool refuses private network addresses.
Related
Last updated: 2026-10-28