protogrid

Search / io.github.serpapi/serpapi-mcp

SerpApi

R1· needs a key

Official SerpApi MCP server for Google, Bing, and other search engines.

v2.0.0 · active · repository · website · descriptor JSON · versions

An agent can connect on its own if it already holds SERPAPI_API_KEY.Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.
Quality92strong
Trust97of 100
Uptime, 30 days97%
Latency p50196 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "serpapi-mcp": {
      "type": "http",
      "url": "https://mcp.serpapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${SERPAPI_API_KEY}"
      }
    }
  }
}
claude mcp add --transport http serpapi-mcp https://mcp.serpapi.com/mcp --header "Authorization: Bearer ${SERPAPI_API_KEY}"
[mcp_servers.serpapi-mcp]
url = "https://mcp.serpapi.com/mcp"
bearer_token_env_var = "SERPAPI_API_KEY"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "serpapi-mcp": {
      "type": "remote",
      "url": "https://mcp.serpapi.com/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:SERPAPI_API_KEY}"
      }
    }
  }
}
{
  "mcpServers": {
    "serpapi-mcp": {
      "type": "http",
      "url": "https://mcp.serpapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${SERPAPI_API_KEY}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=serpapi-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLnNlcnBhcGkuY29tL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke1NFUlBBUElfQVBJX0tFWX0ifX0%3D"
}
{
  "servers": {
    "serpapi-mcp": {
      "type": "http",
      "url": "https://mcp.serpapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${SERPAPI_API_KEY}"
      }
    }
  }
}
{
  "mcpServers": {
    "serpapi-mcp": {
      "httpUrl": "https://mcp.serpapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${SERPAPI_API_KEY}"
      }
    }
  }
}
extensions:
  "serpapi-mcp":
    enabled: true
    name: "serpapi-mcp"
    type: streamable_http
    uri: "https://mcp.serpapi.com/mcp"
    headers:
      "Authorization": "Bearer ${SERPAPI_API_KEY}"
    timeout: 300

Placeholders to fill from your own secret store: ${SERPAPI_API_KEY}. The registry never accepts secret values.

Quality 92 / 100strong

protocol88 · weight 25
  • pass
    protocol.modernsupports 2026-07-28 (server/discover)
  • pass
    protocol.statelessanswers without a session
  • pass
    protocol.transportstreamable HTTP
  • warn
    protocol.list_ttltools/list declares ttlMs 0, so clients re-fetch it on every use
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene93 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • warn
    tools.description_length1 tools have descriptions over 1,024 characters, which crowds the context
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations3 of 3 tools declare readOnlyHint or destructiveHint
  • pass
    tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
  • pass
    tools.token_costabout 1,220 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changesno tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

3 tools, about 1,220 tokens to load them all · tool set 9f6bfe39673a · checked 2026-10-19 10:20 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 97 / 100

provenance90
liveness99
freshness100
hygiene100

+repository +namespace-matches-repo +website +reachable +uptime-97% +updated-27d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://mcp.serpapi.com/mcp streamable-httpapi_key ${SERPAPI_API_KEY}yes97%196 ms2026-07-282026-10-19

Tools (3)

searchread-onlyUniversal 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
search_dashboardread-onlyInteractive 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).
search_tableread-onlyInteractive 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.

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "io.github.serpapi/serpapi-mcp",
  "title": "SerpApi",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://mcp.serpapi.com/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "value": "Bearer {SERPAPI_API_KEY}",
          "isSecret": true,
          "variables": {
            "SERPAPI_API_KEY": {
              "isSecret": true,
              "isRequired": true,
              "description": "Your SerpApi API key. Get one at https://serpapi.com/manage-api-key",
              "placeholder": "your-serpapi-api-key"
            }
          },
          "isRequired": true,
          "description": "Bearer token authentication using your SerpApi API key."
        }
      ]
    }
  ],
  "version": "2.0.0",
  "repository": {
    "url": "https://github.com/serpapi/serpapi-mcp",
    "source": "github"
  },
  "websiteUrl": "https://serpapi.com/",
  "description": "Official SerpApi MCP server for Google, Bing, and other search engines."
}