SerpApi MCP Server
This server gives you live, structured search-engine data and web page extraction through SerpApi, spanning many engines and result types.
Search across many engines – Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay, Baidu, and more, with default
google_light.Get real-time data cards – weather forecasts, stock/financial data, news, images, shopping, local businesses, jobs, flights, hotels, and knowledge-graph entities.
Control output format – JSON by default, Markdown via
output: "md"for lower token usage, pluscompactorcompleteresponse modes.Extract web content – scrape a single page, map a site's URLs, or crawl multiple pages (up to 100) with Markdown or JSON output.
Discover engine parameters – browse
serpapi://enginesresources for per-engine schemas and supported options.Guided searches – supports clients that can be prompted for missing parameters (e.g., flight airports/dates, hotel stay dates).
Interactive UI tools –
search_tableandsearch_dashboardrender sortable tables, charts, and detail panels in MCP Apps–capable hosts.Flexible deployment – hosted at mcp.serpapi.com or self-hosted, with header- or path-based API key auth and a one-click Claude Desktop bundle.
Retrieves parsed search results from Baidu search engine via SerpApi
Performs searches on DuckDuckGo and retrieves parsed search results via SerpApi
Retrieves parsed search results from eBay marketplace via SerpApi
Manages environment variables for the MCP server, specifically for storing and accessing the SerpApi API key
Performs searches on Google and retrieves parsed search results pages via SerpApi
Retrieves parsed search results from Walmart online store via SerpApi
Performs searches on YouTube and retrieves parsed video search results via SerpApi
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@SerpApi MCP Server search for best coffee shops in Seattle with outdoor seating"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
SerpApi MCP Server
A Model Context Protocol (MCP) server implementation that integrates with SerpApi for comprehensive search engine results and data extraction.
Features
Multi-Engine Search: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay, and more
Engine Resources: Per-engine parameter schemas available via MCP resources (see Search Tool)
Real-time Weather Data: Location-based weather with forecasts via search queries
Stock Market Data: Company financials and market data through search integration
Dynamic Result Processing: Automatically detects and formats different result types
Flexible Response Modes: Complete or compact JSON responses
JSON Responses (default): Structured JSON output with complete or compact modes
Markdown Responses: Cut token usage by 50% on average and by more than 90% for APIs with complex nested JSON.
Interactive UI (MCP Apps): Opt-in
search_tableandsearch_dashboardtools that render results as an interactive UI in supporting hostsClaude Desktop Extension: One-click local install from an MCP Bundle (
.mcpb), see below
Related MCP server: SearXNG MCP Server
Quick start
SerpApi MCP Server is available as a hosted service at mcp.serpapi.com. In order to connect to it, you need to provide an API key. You can find your API key on your SerpApi dashboard.
You can configure Claude Desktop to use the hosted server:
{
"mcpServers": {
"serpapi": {
"type": "http",
"url": "https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp"
}
}
}You can also add the hosted server to these MCP clients:
OpenClaw
openclaw mcp add serpapi --url https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp --transport streamable-httpClaude Code
claude mcp add --transport http serpapi https://mcp.serpapi.com/mcp --header "Authorization: Bearer YOUR_SERPAPI_API_KEY"Hermes
hermes mcp add serpapi --url https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcpCodex (reads the key from SERPAPI_API_KEY in your shell)
codex mcp add serpapi --url https://mcp.serpapi.com/mcp --bearer-token-env-var SERPAPI_API_KEYSelf-hosting
git clone https://github.com/serpapi/serpapi-mcp.git
cd serpapi-mcp
uv sync && uv run src/server.pyConfigure Claude Desktop:
{
"mcpServers": {
"serpapi": {
"type": "http",
"url": "http://localhost:8000/YOUR_SERPAPI_API_KEY/mcp"
}
}
}Get your API key: serpapi.com/manage-api-key
Claude Desktop Extension (MCP bundle)
For a local, one-click install, download the .mcpb bundle from the latest release and open it with Claude Desktop (or drop it onto Settings → Extensions). Claude Desktop asks for your SerpApi API key during install, stores it as a sensitive setting, and runs the server locally over stdio. It provisions Python and dependencies with uv at install time. The same bundle works on macOS, Windows and Linux.
The same stdio entry point works with any local MCP host that launches servers as a subprocess:
{
"mcpServers": {
"serpapi": {
"command": "uv",
"args": ["run", "--directory", "/path/to/serpapi-mcp", "--frozen", "--no-dev", "src/stdio.py"],
"env": { "SERPAPI_API_KEY": "YOUR_SERPAPI_API_KEY" }
}
}
}Authentication
Two methods are supported:
Header-based:
Authorization: Bearer YOUR_API_KEY(recommended: the key stays out of URLs and logs)Path-based:
/YOUR_API_KEY/mcp, for clients that cannot set headers
Examples:
# Header-based
curl "https://mcp.serpapi.com/mcp" -H "Authorization: Bearer your_key" -d '...'
# Path-based
curl "https://mcp.serpapi.com/your_key/mcp" -d '...'No key is needed to connect, list tools or read resources. search and the App tools need one and return an error without it.
Search tool
The MCP server has one main search tool that supports all SerpApi engines and result types. You can find all available parameters on the SerpApi API reference.
Engine parameter schemas are also exposed as MCP resources: serpapi://engines (index) and serpapi://engines/<engine>.
Clients that support argument completion can request engine-name suggestions for serpapi://engines/{engine_name}. For example, the prefix google_f suggests matching engine identifiers. This completes the resource URI parameter, not arbitrary search queries.
The parameters you can provide are specific for each API engine. Some sample parameters are provided below:
params.q(required): Search queryparams.engine: Search engine (default: "google_light")params.location: Geographic filterparams.output: Response format; omit for JSON (default), or set to"md"for Markdownmode: Response mode;"compact"removes metadata from JSON, while Markdown is returned unchanged...see other parameters on the SerpApi API reference
Examples:
{"name": "search", "arguments": {"params": {"q": "coffee shops", "location": "Austin, TX"}}}
{"name": "search", "arguments": {"params": {"q": "weather in London"}}}
{"name": "search", "arguments": {"params": {"q": "AAPL stock"}}}
{"name": "search", "arguments": {"params": {"q": "news"}, "mode": "compact"}}
{"name": "search", "arguments": {"params": {"q": "detailed search"}, "mode": "complete"}}
{"name": "search", "arguments": {"params": {"q": "news", "output": "md"}}}
{"name": "search", "arguments": {"params": {"engine": "amazon", "k": "mechanical keyboards", "amazon_domain": "amazon.com", "output": "md"}}}
{"name": "search", "arguments": {"params": {"engine": "google_scholar", "q": "retrieval augmented generation"}}}
{"name": "search", "arguments": {"params": {"engine": "youtube", "search_query": "how to make espresso"}}}
{"name": "search", "arguments": {"params": {"engine": "apple_app_store", "term": "habit tracker"}}}
{"name": "search", "arguments": {"params": {"engine": "ebay", "_nkw": "vintage mechanical keyboard"}}}Supported engines: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay, and more (see serpapi://engines).
Result types: Answer boxes, organic results, news, images, shopping - automatically detected and formatted.
Search responses preserve the existing MCP structuredContent.result string and include the same string in text content. For JSON output, result contains serialized JSON; existing clients can continue parsing it with JSON.parse(response.structuredContent.result). For Markdown output, it contains the unchanged Markdown. Errors and cancellations use the same wrapper. Search execution failures set isError: true; clients using FastMCP's high-level call_tool() should handle ToolError, or use call_tool_mcp() to inspect the result flag. See MCP tool results.
search uses the engine catalog and engine-specific rules to identify missing parameters. Supporting MCP 2026-07-28 clients receive a form before any search runs. Accepted answers are validated; decline or cancellation runs no search. Legacy clients and clients without form elicitation receive an error listing the missing parameters so the agent can ask in conversation. See MCP input requests.
Google Flights: departure and arrival identifiers, departure date, and a return date for round trips. Dates and airport identifiers are checked. Token-based searches, multi-city itineraries, and
selected_flights_jsonretain their existing behavior.Google Hotels: destination or hotel query, check-in date, and check-out date. Check-out must follow check-in. Guest counts and other optional filters keep the caller's values or the API defaults.
Google Maps Directions: missing start and destination addresses. Coordinates or place data IDs already supplied satisfy the corresponding endpoint.
Other catalog engines use their required fields, such as YouTube's
search_query, Yelp'sfind_loc, and Amazon'sk. Engine rules account for known defaults and alternatives, including Amazon category nodes, eBay categories, and Google Scholar citation searches.
If an answer introduces another requirement, the tool lists the remaining fields for the agent to supply in a new call. Forms support strings, numbers, booleans, and single-choice fields; unsupported complex fields receive the missing-parameter error. Unknown engines pass through to SerpApi.
Extract tool
The extract tool reads web pages and returns their content as structured JSON or Markdown. You can extract a single page, discover a website's URLs, or crawl multiple pages. Find all available parameters on the Extract API reference or in the serpapi://engines/extract resource.
Some parameters you can provide:
params.url(required): Page or website URLparams.mode: Extraction mode;"scrape"(default) reads one page,"map"discovers URLs, and"crawl"extracts multiple pagesparams.include_markdown: Include the page's content as Markdown; defaults totruefor scrape and crawl, or set tofalseto disable itparams.output: Response format; defaults to"json"in complete mode and"md"in compact mode. Set it explicitly to override the format.params.max_pages: Maximum pages to crawl, including the starting page (default: 10, maximum: 100)params.json_restrictor: Choose which fields to return, such as"markdown,error"mode: Response mode;"complete"(default) returns the full response."compact"defaults to native Markdown. With an explicitparams.output="json", single-page compact extraction keeps the top-levelmarkdownfield when present and retains API errors. Responses without Markdown, including results redirected to another engine, keep their data with metadata removed. Explicitparams.json_restrictorvalues andparams.include_markdown=falsetake precedence when using JSON. For map and crawl, compact JSON removes metadata. Markdown output is returned unchanged.
Examples:
{"name": "extract", "arguments": {"params": {"url": "https://example.com"}}}
{"name": "extract", "arguments": {"params": {"url": "https://example.com"}, "mode": "compact"}}
{"name": "extract", "arguments": {"params": {"url": "https://example.com", "output": "md"}}}
{"name": "extract", "arguments": {"params": {"url": "https://example.com", "mode": "map"}}}
{"name": "extract", "arguments": {"params": {"url": "https://example.com", "mode": "crawl", "max_pages": 2}}}For a single page's content as native Markdown, use mode="compact". Add params.output="json" to receive JSON containing the markdown field instead. Complete JSON includes that field by default; crawl JSON includes it in each pages entry. Setting params.output="json" and params.include_markdown=false keeps the remaining structured fields without Markdown.
Crawling consumes one search credit per successfully extracted page on an uncached request. Use params.max_pages to limit how many pages are extracted.
Interactive UI (MCP apps)
The search tool returns JSON by default. For hosts that support the MCP Apps extension (SEP-1865), two opt-in tools render results as an interactive UI directly in the conversation, so the bulk SERP JSON never enters the model's context window:
search_table: organic results as a sortable, searchable table.search_dashboard: summary metrics, a source-breakdown chart, and a results table with a click-to-expand detail panel.
Both accept the same params as search. Hosts that don't support MCP Apps simply ignore these tools.
Troubleshooting
"Missing API key": Include key in URL path
/{YOUR_KEY}/mcpor headerBearer YOUR_KEY"Invalid key": Verify at serpapi.com/dashboard
"Rate limit exceeded": Wait or upgrade your SerpApi plan
"No results": Try different query or engine
Privacy policy
Sent: only the parameters the MCP host passes to a tool call. The server never sees the rest of the conversation, or files, memory or history on the host.
Forwarded: each search goes to
serpapi.comwith your API key; results come back unchanged. See the SerpApi Privacy Policy for how SerpApi handles searches and accounts.Kept:
mcp.serpapi.comrecords request metrics (method, status code, duration) and stores no queries or results. A key in the URL path can appear in request logs, so prefer the header.Local bundle: the Claude Desktop extension runs on your machine, keeps the key in Claude Desktop's settings and calls
serpapi.comdirectly. Nothing passes throughmcp.serpapi.com.Contact: privacy@serpapi.com, or open an issue.
Contributing
See CONTRIBUTING.md for development setup, schema refresh commands, testing, Docker and MCP Bundle builds, and releases.
License
MIT License - see LICENSE file for details.
Available Tools
4 toolsextractSerpApi extractARead-only
Extract content from a public http(s) URL, discover site URLs, or crawl pages.
API options go in params: url is required; params.mode is scrape (default), map, or crawl. See serpapi://engines/extract for all options.
Top-level mode controls the response:
complete (default): full JSON.
compact: native Markdown by default.
params.output selects the format and overrides either default:
"md": return native Markdown unchanged in either response mode.
"json": return JSON, with filtering determined by the response mode.
Compact JSON removes metadata. For scrape responses containing markdown, it also keeps only markdown and any error field. include_markdown=false or an explicit json_restrictor skips this extra filtering. Map/crawl and responses without markdown keep their remaining fields. Use complete with output="json" for full JSON.
Crawl max_pages defaults to 10 (maximum 100). Each successfully extracted, uncached page consumes one credit.
Examples: Full scrape JSON: {"params":{"url":"https://example.com"},"mode":"complete"} Scrape Markdown: {"params":{"url":"https://example.com"},"mode":"compact"} Map URLs as JSON: {"params":{"url":"https://example.com","mode":"map"},"mode":"complete"} Crawl pages as Markdown: {"params":{"url":"https://example.com","mode":"crawl","max_pages":2},"mode":"compact"}
Inputs: mode, params. Returns: result
searchSerpApi searchARead-only
Universal search tool supporting all SerpApi engines and result types.
When to use:
- Any query needing live, structured SERP data: web results, news, product listings, job postings, local businesses, flight/hotel prices, video results, images, stock/weather cards, knowledge graph entities.
Engine discovery via MCP resources:
- serpapi://engines lists all engines supported by this tool.
- serpapi://engines/<engine> provides engine-specific parameters and supported options.
- Example: serpapi://engines/google_news
Input schema:
params: JSON object containing SerpApi engine parameters.
Common parameters:
- q: Search query. Required for most engines.
- engine: SerpApi engine name. Defaults to "google_light".
- location: Optional geographic location for localized results.
- output: Optional response format. Omit for JSON (default), or set to "md" for Markdown.
Engine-specific parameters are available via MCP resources:
- serpapi://engines lists all supported engines.
- serpapi://engines/<engine> provides parameters and options for one engine.
mode: Response mode. Defaults to "complete".
- "complete": Return the full SerpApi response.
- "compact": Remove metadata fields from JSON responses. Markdown is returned unchanged.
Output schema:
structuredContent.result contains the response string: serialized JSON or unchanged Markdown.
The same string is included in text content. Tool failures preserve this wrapper and set isError to true.
Guided search:
Searches can request missing engine parameters from supporting clients using the engine catalog and engine-specific rules.
Flights collect airports and dates, hotels collect the destination and stay dates, and directions collect missing endpoints.
Other clients receive a missing-parameter error. Cancellation does not run a search.
Examples:
Weather: {"params": {"q": "weather in London", "engine": "google"}, "mode": "complete"}
Stock: {"params": {"q": "AAPL stock", "engine": "google"}, "mode": "complete"}
General: {"params": {"q": "coffee shops", "engine": "google_light", "location": "Austin, TX"}, "mode": "complete"}
Compact: {"params": {"q": "news"}, "mode": "compact"}
Markdown: {"params": {"q": "news", "output": "md"}}
Supported engines include (not limited to):
- google
- google_light
- google_flights
- google_hotels
- google_images
- google_news
- google_local
- google_shopping
- google_jobs
- bing
- yahoo
- duckduckgo
- youtube_search
- baidu
- ebay
Inputs: mode, params. Returns: result
search_dashboardSerpApi search (dashboard)ARead-only
Interactive dashboard variant of search: returns summary metrics, a source breakdown chart, and a results table with a click-to-expand detail panel, all rendered in the conversation. Same params as search. Use for a richer visual overview of a query's results. Automatically selects an engine-specific dashboard when available (e.g. google_flights gets price intelligence charting).
Inputs: params.
search_tableSerpApi search (table)ARead-only
Interactive UI variant of search: returns organic results as a sortable, searchable table rendered in the conversation. Same params as search. Use when the host supports MCP Apps and the user wants to browse results visually rather than read JSON.
Inputs: params.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Three of the four tools (search, search_dashboard, search_table) take identical params and hit the same underlying query, differing only in response rendering, so an agent must judge presentation intent rather than operation. Descriptions do help ('same params as search', dashboard vs sortable table vs raw JSON/Markdown), but the boundaries are softer than ideal, especially when the host lacks MCP Apps support.
Names are all snake_case and the three search variants follow a clear search_<modifier> pattern. `extract` deviates as a bare verb with no noun, but it is a single predictable outlier.
Four tools for a universal SerpApi wrapper is lean and well-scoped, since one generic `search` tool absorbs dozens of engines instead of exploding into per-engine tools. Slightly thin, but every tool earns its place.
The surface covers the two core domain operations: universal SERP search (all engines) and URL extraction/map/crawl. Minor gaps exist — no direct tool for account/credit status or engine discovery, which is only available via MCP resources rather than tools.
Maintenance
Related MCP Connectors
Official SerpApi MCP server for Google, Bing, and other search engines.
MCP server for Google search results via SERP API
Web search API and MCP server for developers building AI agents.
Unofficial SerpApi MCP — wraps SerpApi (serpapi.com) search engines
Related MCP Servers
- AlicenseBqualityCmaintenanceAn MCP server that integrates with the SearXNG API to provide comprehensive web search capabilities with features like time filtering, language selection, and safe search. It also enables users to fetch and convert web content from specific URLs into markdown format.24MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables web search capabilities by integrating with a SearXNG instance to aggregate results from over 130 engines. It allows users to perform filtered searches across categories like news, science, and social media while supporting advanced parameters for language and time range.14MIT
- AlicenseAqualityDmaintenanceAn MCP server that integrates the SearXNG API for web search and URL content extraction with advanced features like pagination, caching, and proxy support.414,717 npm2MIT
- AlicenseNot gradedqualityFmaintenanceAn MCP server that integrates the SearXNG API to provide web search with pagination, filtering, and URL content extraction.11 npmMIT