SearchMCP
Skip to content
MCP Server

Overview

The SearchMCP MCP server exposes Google web search via Model Context Protocol. Connect agents over /mcp (StreamableHTTP) or /sse (legacy Server-Sent Events).

Endpoints

The SearchMCP MCP server exposes Google web search via Model Context Protocol. Connect agents over /mcp (StreamableHTTP) or /sse (legacy Server-Sent Events).

Usage

The SearchMCP server can be consumed by any client or framework that speaks the Model Context Protocol. This makes it highly flexible and broadly compatible across today’s LLM ecosystem:

  • Claude Desktop — add it in your claude_desktop_config.json for direct integration.
  • ChatGPT — connect via custom MCP server configuration for ChatGPT’s MCP client support.
  • AI SDKs in Node.js & Python — libraries like @ai-sdk/mcp (Node.js) can talk to the server out-of-the-box.
  • Agent toolchains — LangChain, Semantic Kernel, AutoGen, and other frameworks can consume MCP tools to enrich agents with live search capabilities.
  • Custom apps — any backend, script, or service can connect to the /mcp endpoint and use SearchMCP as a tool provider.

In practice, anywhere that supports MCP transports (StreamableHTTP or SSE) can use SearchMCP as a drop-in search capability for agents, copilots, or orchestration frameworks.

Endpoints
  • POST https://api.searchmcp.io/mcp — StreamableHTTP (modern)
  • GET https://api.searchmcp.io/sse — SSE stream (legacy)
  • POST https://api.searchmcp.io/message — SSE message endpoint

Authenticate with your X-API-Key. The modern /mcp endpoint is recommended for Claude Desktop and other MCP clients.

Request fields

Parameters accepted by the Search endpoint.

  • query
    string required

    The search query text. Example: 'apple inc'.

  • location
    enum | null
    Allowed: UK USA MEXICO JAPAN CALIFORNIA_USA SFO_USA NY_USA MUMBAI_INDIA LONDON_UK PARIS_FRANCE DUBAI BANGKOK SOHO_NYC_USA

    Physical/geographic location context for the search. Default: "UK".

  • country
    string(ISO-3166-1 alpha-2)

    Two-letter country code (e.g., 'US', 'GB', 'IN'). Used for search regionalization.

  • numberOfResults
    integer

    Maximum number of results to return. Default: 10.

  • dateRange
    enum | null
    Allowed: ANYTIME PAST_YEAR PAST_MONTH PAST_WEEK PAST_24_HOURS PAST_HOUR

    Time filter for results.

Quickstart usage
npx mcp-remote https://api.searchmcp.io/mcp --header "x-api-key: smcp_<YOUR_API_KEY>"
Responses fields

Parameters returned by the Search endpoint.

  • status
    enum required
    Allowed: UNAUTHORIZED INSUFFICIENT_CREDITS ERROR SUCCESS

    Execution status of the request.

  • searchParameters
    object required

    Echo of normalized parameters used by the engine.

    • query
      string required

      The search query string.

    • type
      string

      Search mode/type selected by backend.

    • engine
      string

      Engine/provider used for this search.

  • knowledgeGraph
    object|null

    Entity panel if Google returns one for the query.

    • title
      string

      Entity title.

    • imageUrl
      string(url)

      Entity image URL (if available).

    • description
      string

      Short summary text.

    • descriptionSource
      string

      Source label for description (e.g., Wikipedia).

    • descriptionLink
      string(url)

      Source URL for the description.

    • attributes
      map<string, string>

      Key–value facts about the entity (e.g., Headquarters, CEO).

  • organic
    array<object> required

    List of organic results in rank order.

    • title
      string required

      Result title.

    • link
      string(url) required

      Canonical result URL.

    • snippet
      string

      Short summary/excerpt from the page.

    • position
      integer

      1-based result rank for this page.

    • date
      string(ISO-8601)

      Published/seen date when available.

  • relatedSearches
    array<object>|null

    Suggested related queries.

    • query
      string required

      Suggested query text.

  • credits
    integer

    Credits billed for this request (typically 1 per search unless otherwise documented).