Configure groundcover's MCP Server

Set up your agent to talk to groundcover’s MCP server. Use OAuth for a quick login, or an API key for service accounts.

The MCP server supports two methods:

(Recommended for IDEs)

OAuth (recommended)

OAuth is the default if your agent supports it.

To get started, add the config below to your MCP client. Once you run it, your browser will open and prompt you to log in with your groundcover credentials.

🧘 Pro tip: You can copy a ready-to-go command from the UI. Go to the sidebar → Click your profile picture → "Connect to our MCP"

The tenant's UUID and your time zone will be auto-filled.

Configuration Example

{
  "mcpServers": {
    "groundcover": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.groundcover.com/api/mcp",
        "54278",
        "--header",
        "X-Timezone:<IANA_TIMEZONE>",
        "--header",
        "X-Tenant-Uuid:<TENANT_UUID>"
      ]
    }
  }
}

API Key

If your agent doesn’t support OAuth, or if you want to connect a service account, this is the way to go.

Prerequisites

Configuration Example

Parameters

AUTH_HEADER – your groundcover API key.
TIMEZONE – your time zone in IANA format.

{
  "mcpServers": {
    "groundcover": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.groundcover.com/api/mcp",
        "--header", "Authorization:${AUTH_HEADER}",
        "--header", "X-Timezone:${TIMEZONE}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <your_token>",
        "TIMEZONE": "<your_timezone>"
      }
    }
  }
}

Have a Multi‑backend setup?

If you're using a multi-backend setup (OAuth or API Key), just add the following header to the args list:

"--header", "X-Backend-Id:<BACKEND_ID>"

First, grab your backend ID (it’s basically the name):

Open Data Explorer in groundcover.
Click the Backend picker (top‑right) and copy the backend’s name.

How to find your time zone

command

macOS

sudo systemsetup -gettimezone

Linux

timedatectl grep "Time zone"

Windows PowerShell

Get-TimeZone

Client‑specific Guides

Depending on your client, you can usually set up the MCP server through the UI - or just ask the client to add it for you. Here are quick links for common tools:

Last updated 1 day ago