# Ground Control MCP server

> Enables AI agents to manage knowledge through graph-native memory, hybrid RAG, and codebase indexing.

- Repository: https://github.com/GCTRL-TECH/platform
- Page: https://hostedmcp.org/servers/gctrl-tech/gctrl
- Transport: stdio
- Stars: 7
- License: AGPL-3.0
- Latest version: 1.2.0

## Install

### Claude Code

```sh
claude mcp add --env 'GCTRL_API_TOKEN=<YOUR_GCTRL_API_TOKEN>' gctrl -- npx -y gctrl-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "gctrl": {
      "command": "npx",
      "args": [
        "-y",
        "gctrl-mcp"
      ],
      "env": {
        "GCTRL_API_TOKEN": "<YOUR_GCTRL_API_TOKEN>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "gctrl": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "gctrl-mcp"
      ],
      "env": {
        "GCTRL_API_TOKEN": "<YOUR_GCTRL_API_TOKEN>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"gctrl","type":"stdio","command":"npx","args":["-y","gctrl-mcp"],"env":{"GCTRL_API_TOKEN":"<YOUR_GCTRL_API_TOKEN>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "gctrl": {
      "command": "npx",
      "args": [
        "-y",
        "gctrl-mcp"
      ],
      "env": {
        "GCTRL_API_TOKEN": "<YOUR_GCTRL_API_TOKEN>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add gctrl --env 'GCTRL_API_TOKEN=<YOUR_GCTRL_API_TOKEN>' -- npx -y gctrl-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.gctrl]
command = "npx"
args = ["-y", "gctrl-mcp"]

[mcp_servers.gctrl.env]
GCTRL_API_TOKEN = "<YOUR_GCTRL_API_TOKEN>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'GCTRL_API_TOKEN=<YOUR_GCTRL_API_TOKEN>' gctrl npx -- -y gctrl-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "gctrl": {
      "command": "npx",
      "args": [
        "-y",
        "gctrl-mcp"
      ],
      "env": {
        "GCTRL_API_TOKEN": "<YOUR_GCTRL_API_TOKEN>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `GCTRL_API_TOKEN` | yes | yes | Scoped GCTRL Access Token (gctrl_â€¦) created in Settings â†’ Access Control |
| `GCTRL_API_URL` | no | no | Direct GCTRL API base URL (alternative to gateway mode), e.g. http://localhost:4000/api |
| `GCTRL_CODE_AUTO_INDEX` | no | no |  |
| `GCTRL_GATEWAY_URL` | no | no | URL of your GCTRL harness MCP gateway, e.g. http://localhost:4000/api/agent/mcp (recommended mode) |
| `GCTRL_MCP_TOOLS` | no | no |  |

## Tools (23)

- `gctrl_extract`
- `gctrl_query`
- `gctrl_search_entities`
- `gctrl_list_graphs`
- `gctrl_fuse`
- `gctrl_list_ontologies`
- `gctrl_list_extractions`
- `gctrl_store`
- `gctrl_schema`
- `gctrl_code_index`
- `gctrl_code_symbol`
- `gctrl_code_trace`
- `gctrl_code_impact`
- `gctrl_code_architecture`
- `borghive_extract`
- `borghive_query`
- `borghive_store`
- `borghive_fuse`
- `borghive_search_entities`
- `borghive_list_graphs`
- `borghive_list_ontologies`
- `borghive_list_extractions`
- `borghive_schema`

## FAQ

### How can I use GCTRL for coding tasks?

You can run the server in direct mode to provide local code tools like symbol searching, tracing, and impact analysis for your repository.

### What is required to use the gctrl_code_index tool?

The tool requires the optional gctrl-code-indexer package to be installed; otherwise, it will return an install hint.

### How does the security model work for GCTRL?

It uses scoped GCTRL Access Tokens with specific clearance levels and per-graph grants to ensure the agent only sees authorized data.
