SerpApi Mcp

Name: SerpApi Mcp
Author: serpapi

@serpapi

Repository

About SerpApi Mcp

SerpApi MCP Server for Google and other search engine results

#search #google-search #ai-scraping

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "serpapi": {
      "url": "https://mcp.serpapi.com/YOUR_SERPAPI_API_KEY/mcp"
    }
  }
}

Tools

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

Overview

What is SerpApi Mcp?

SerpApi Mcp is a Model Context Protocol (MCP) server that integrates with SerpApi to provide search engine results and data extraction. It supports multiple search engines and returns structured JSON responses.

How to use SerpApi Mcp?

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.

Key features of SerpApi Mcp

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

Use cases of SerpApi Mcp

Search for local businesses (e.g., “coffee shops in Austin, TX”)
Retrieve current weather for any location (e.g., “weather in London”)
Look up stock information (e.g., “AAPL stock”)
Fetch news results using compact mode to reduce payload size

FAQ from SerpApi Mcp

What are the dependencies for running SerpApi Mcp?

Python 3.13+, uv, and a valid SerpApi API key. For self‑hosting, clone the repository and run uv sync && uv run src/server.py.

How do I authenticate with SerpApi Mcp?

Two methods: path‑based (/YOUR_API_KEY/mcp) or header‑based (Authorization: Bearer YOUR_API_KEY). The hosted server at mcp.serpapi.com uses the same approach.