MCP server

GroundRoute hosts a Model Context Protocol (MCP) server so any MCP-capable agent can use web search as a native tool.

• Endpoint: https://api.groundroute.ai/mcp
• Transport: streamable HTTP
• Auth: Authorization: Bearer <api_key> — the same gr_live_… key that works for the REST API

A missing or invalid Bearer token is rejected with 401 before any tool runs.

Connect a client

Add GroundRoute to your MCP client config. The shape is the same for Claude Desktop, Cursor, and most MCP clients.

{
  "mcpServers": {
    "groundroute": {
      "type": "http",
      "url": "https://api.groundroute.ai/mcp",
      "headers": { "Authorization": "Bearer gr_live_YOUR_KEY" }
    }
  }
}

Restart the client. The search tool appears under the groundroute server.

The search tool

Search the web via GroundRoute. Returns ranked results, an optional synthesized answer, and citations.

Parameters

Result shape

The MCP tool returns a compact, agent-friendly shape (a subset of the REST response):

{
  "results": [
    {
      "url": "https://...",
      "title": "…",
      "snippet": "…",
      "source_engine": "serper",
      "published_at": null
    }
  ],
  "answer": null,
  "citations": [
    { "url": "https://...", "title": "…", "index": 0 }
  ],
  "meta": {
    "request_id": "…",
    "cache_tier": "miss",
    "degraded": false,
    "cost_usd": 0.001
  }
}

For the full meta surface — routing candidates, cache keys, quality scores — call the REST /v1/search endpoint directly.