Which integrations are available for this server?

Retrieves parsed search results from [Baidu](/mcp/servers/integrations/baidu) search engine via SerpApi Performs searches on [DuckDuckGo](/mcp/servers/integrations/duckduckgo) and retrieves parsed search results via SerpApi Retrieves parsed search results from [eBay](/mcp/servers/integrations/ebay) marketplace via SerpApi Manages environment variables for the MCP server, specifically for storing and accessing the SerpApi API key Performs searches on [Google](/mcp/servers/integrations/google) and retrieves parsed search results pages via SerpApi Retrieves parsed search results from [Walmart](/mcp/servers/integrations/walmart) online store via SerpApi Performs searches on [YouTube](/mcp/servers/integrations/youtube) and retrieves parsed video search results via SerpApi

SerpApi MCP Server

A Model Context Protocol (MCP) server implementation that integrates with SerpApi for comprehensive search engine results and data extraction.

Python 3.13+ MIT License

Features

Multi-Engine Search: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay, and more
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: Structured JSON output with complete or compact modes

Related MCP server: G-Search MCP

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": { "url": "https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp" } } }

Self-Hosting

git clone https://github.com/serpapi/serpapi-mcp.git cd serpapi-mcp uv sync && uv run src/server.py

Configure Claude Desktop:

{ "mcpServers": { "serpapi": { "url": "http://localhost:8000/YOUR_SERPAPI_API_KEY/mcp" } } }

Get your API key: serpapi.com/manage-api-key

Authentication

Two methods are supported:

Path-based: /YOUR_API_KEY/mcp (recommended)
Header-based: Authorization: Bearer YOUR_API_KEY

Examples:

# Path-based curl "https://mcp.serpapi.com/your_key/mcp" -d '...' # Header-based curl "https://mcp.serpapi.com/mcp" -H "Authorization: Bearer your_key" -d '...'

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.

The parameters you can provide are specific for each API engine. Some sample parameters are provided below:

params.q (required): Search query
params.engine: Search engine (default: "google_light")
params.location: Geographic filter
mode: Response mode - "complete" (default) or "compact"
...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"}}

Supported Engines: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay, and more.

Result Types: Answer boxes, organic results, news, images, shopping - automatically detected and formatted.

Development

# Local development uv sync && uv run src/server.py # Docker docker build -t serpapi-mcp . && docker run -p 8000:8000 serpapi-mcp # Testing with MCP Inspector npx @modelcontextprotocol/inspector # Configure: URL mcp.serpapi.com/YOUR_KEY/mcp, Transport "Streamable HTTP transport"

Troubleshooting

"Missing API key": Include key in URL path /{YOUR_KEY}/mcp or header Bearer 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