SerpApi Mcp
About
SerpApi MCP Server for Google and other search engine results
Details
- Author
- serpapi
- Downloads
- 239
- Categories
- Search, Knowledge Base, Other
Jump to
- Multi‑engine search: Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay, and more
- Real‑time weather data and forecasts via search queries
- Stock market data: company financials and market data
- Dynamic result processing with automatic type detection
- Flexible response modes: complete or compact JSON
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
SerpApi McpCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Configure Claude Desktop to use the hosted server at https://mcp.serpapi.com by providing your SerpApi API key in the URL path. For self-hosting, clone the repo, run uv sync && uv run src/server.py, then configure Claude Desktop to point to http://localhost:8000. The server exposes a single search tool that accepts parameters like q, engine, location, and mode.
search
Universal search tool supporting all SerpApi engines and result types. This tool consolidates weather, stock, and general search functionality into a single interface. It processes multiple result types and returns structured JSON output. Args: params: Dictionary of engine-specific parameters. Common parameters include: - q: Search query (required for most engines) - engine: Search engine to use (default: "google_light") - location: Geographic location filter - num: Number of results to return mode: Response mode (default: "complete") - "complete": Returns full JSON response with all fields - "compact": Returns JSON response with metadata fields removed Returns: A JSON string containing search results or an error message. 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"} Supported engines: - google - google_light - google_flights - google_hotels - google_images - google_news - google_local - google_shopping - google_jobs - bing - yahoo - duckduckgo - youtube_search - baidu - ebay
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"serpapi mcp": {
"serpapi": {
"url": "https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp"
}
}
}
}McpServers
{
"serpapi": {
"url": "https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp"
}
}- Multi-engine search— Ask for results from Google, Bing, YouTube, eBay, or other engines via thesearchtool with engine-specific parameters.
- Location-aware queries— Get geographically filtered results, such as "coffee shops in Austin, TX," by specifyingparams.location.
- Real-time data lookups— Retrieve current weather, stock quotes, or news by querying terms like "weather in London" or "AAPL stock."
- Compact or complete responses— Control output detail by settingmodeto"compact"for metadata-free JSON or"complete"for full results.
- Markdown output— Reduce token usage by requestingoutput: "md"for concise, formatted results instead of verbose JSON.
- Interactive result tables— In supporting hosts, usesearch_tableorsearch_dashboardto view organic results as sortable tables or dashboards.
A Model Context Protocol (MCP) server implementation that integrates withSerpApifor comprehensive search engine results and data extraction.
SerpApi MCP Server is available as a hosted service atmcp.serpapi.com. In order to connect to it, you need to provide an API key. You can find your API key on yourSerpApi 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 mcp add serpapi --url https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp --transport streamable-http
claude mcp add --transport http serpapi https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp
hermes mcp add serpapi --url https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp
codex mcp add serpapi --url https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp
git clone https://github.com/serpapi/serpapi-mcp.git cd serpapi-mcp uv sync && uv run src/server.py
{ "mcpServers": { "serpapi": { "type": "http", "url": "http://localhost:8000/YOUR_SERPAPI_API_KEY/mcp" } } }
Get your API key:serpapi.com/manage-api-key
- Path-based:/YOUR_API_KEY/mcp(recommended)
- Header-based:Authorization: Bearer YOUR_API_KEY
# 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 '...'
The MCP server has one main Search Tool that supports all SerpApi engines and result types. You can find all available parameters on theSerpApi API reference. Engine parameter schemas are also exposed as MCP resources:serpapi://engines(index) andserpapi://engines/<engine>.
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
- params.output: Response format; omit for JSON (default), or set to"md"for Markdown
- mode: Response mode;"compact"removes metadata from JSON, while Markdown is returned unchanged
- ...see other parameters on theSerpApi API reference
{"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 (seeserpapi://engines).
Result Types:Answer boxes, organic results, news, images, shopping - automatically detected and formatted.
The defaultsearchtool returns JSON and is unchanged. For hosts that support theMCP 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 sameparamsassearch. Hosts that don't support MCP Apps simply ignore these tools.
Preview them locally without an MCP host:
# Local development uv sync && uv run src/server.py # Docker docker build -t serpapi-mcp . && docker run -p 8000:8000 serpapi-mcp # Regenerate engine resources (Playground scrape) python build-engines.py # Testing with MCP Inspector npx @modelcontextprotocol/inspector # Configure: URL mcp.serpapi.com/YOUR_KEY/mcp, Transport "Streamable HTTP transport"
- "Missing API key": Include key in URL path/{YOUR_KEY}/mcpor headerBearer YOUR_KEY
- "Invalid key": Verify atserpapi.com/dashboard
- "Rate limit exceeded": Wait or upgrade your SerpApi plan
- "No results": Try different query or engine
- Fork the repository
- Create your feature branch:git checkout -b feature/amazing-feature
- Install dependencies:uv install
- Make your changes
- Commit changes:git commit -m 'Add amazing feature'
- Push to branch:git push origin feature/amazing-feature
- Open a Pull Request
MIT License - seeLICENSEfile for details.
Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.
Fetch, convert, and search AWS documentation pages, with recommendations for related content.
Search campgrounds around the world on campertunity, check availability, and provide booking links.
The Ferryhopper MCP Server exposes ferry routes, schedules and booking redirects so an AI assistant can discover connections across Europe and the Mediterranean and send users to Ferryhopper to complete bookings.
All-in-One SEO & Web Intelligence Toolkit API from FetchSERP.
MCP server that provides read-only access to HyperKitty, the web-based email archive component of Mailman 3.
At Sunrise Apps, we believe AI agents should be limitless, especially when it comes to visual data. We created ImageSorcery to bridge the critical gap in AI's ability to interact with and manipulate images directly, all while upholding the highest standards of privacy and security.
Just Domain is the domain registrar for businesses built with AI. Its remote MCP server checks availability and returns first-year and renewal pricing, plus a link to register on justdomain.ai, with DNS and WHOIS privacy in the same place. No account, no API key, read only. Endpoint: https://mcp.justdomain.ai/
Research tools, including a Sqlite-backed document stash
Semantic search over 9 free-license stock photo sources. Hosted remote server with OAuth — no API key to paste.
Access to your site's SEO data — crawl results, Search Console and Analytics, so your assistant can tell you what's broken, what's ranking, and what to fix next.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
