Skip to main content

​
MCP integration

Ground exposes an MCP server so coding agents can call search, package search, Rover, and related tools using your API key. Usage follows the same rate limits and quotas as the REST API for your account.

​
Endpoint

https://api.trygroundai.com/mcp
Use Streamable HTTP transport (POST). Send your API key on every request: 
Authorization: Bearer gnd_your_api_key
Some clients also support the X-API-Key header with the same gnd_… value—check your client’s docs.

​
Configure your client

Add a server entry that points at the URL above and forwards your key. Example shape (field names depend on the product): 
{
  "mcpServers": {
    "ground": {
      "url": "https://api.trygroundai.com/mcp",
      "headers": {
        "Authorization": "Bearer gnd_your_api_key"
      }
    }
  }
}

​
Tools (overview)

Tools map to documented REST capabilities—for example hybrid search, RMH search, on-demand package search, and Rover jobs. Tool names and parameters match what the MCP server publishes in its manifest; refer to the API reference for request semantics and response shapes.

​
Source code

The MCP server implementation lives in the open-source repo under mcp-server/. Build and run it locally only if you are developing Ground; production traffic should use https://api.trygroundai.com/mcp.

​
Support

Documentation questions: ali@trygroundai.com