Terrakube Model Context Protocol Server
Terrakube MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. Terrakube Model Context Protocol Server.
A Model Context Protocol (MCP) server for Terrakube operations, enabling workspace management, variable handling, module operations, and organization management.
The server ships on npm as @smithery/cli, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.
Once Terrakube is connected, these are the calls the assistant has available:
Workspaces — The Workspaces tool exposed by this servercreateWorkspace — Create a new workspace in Terrakube. - Inputs: - name (string): Name of the workspace - organization (string): Organization name - descriptionupdateWorkspace — Update an existing workspace. - Inputs: - name (string): Name of the workspace - organization (string): Organization name - description (optionaldeleteWorkspace — Delete a workspace. - Inputs: - name (string): Name of the workspace - organization (string): Organization name - Returns: Success statusgetWorkspace — Get details of a specific workspace. - Inputs: - name (string): Name of the workspace - organization (string): Organization name - ReturnslistWorkspaces — List all workspaces in an organization. - Inputs: - organization (string): Organization name - Returns: Array of workspace detailsVariables — The Variables tool exposed by this servercreateVariable — Create a new variable in a workspace. - Inputs: - name (string): Name of the variable - organization (string): Organization name - workspaceupdateVariable — Update an existing variable. - Inputs: - name (string): Name of the variable - organization (string): Organization name - workspace (string)deleteVariable — Delete a variable. - Inputs: - name (string): Name of the variable - organization (string): Organization name - workspace (string): WorkspacegetVariable — Get details of a specific variable. - Inputs: - name (string): Name of the variable - organization (string): Organization name - workspacelistVariables — List all variables in a workspace. - Inputs: - organization (string): Organization name - workspace (string): Workspace name - Returns: ArrayYou will need 4 environment variables: TERRAKUBE_API_URL, TERRAKUBE_PAT_TOKEN, YOUR_API_URL, YOUR_PAT_TOKEN. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.
Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Terrakube's toolset — Workspaces, createWorkspace, updateWorkspace and 11 more — is a fair guide to whether it matches your workflow. It is maintained by AzBuilder; worth a glance at recent repository activity before you build anything load-bearing on it.
We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.
| Tool | What it does |
|---|---|
| Workspaces | The Workspaces tool exposed by this server. |
| createWorkspace | Create a new workspace in Terrakube. - **Inputs**: - name (string): Name of the workspace - organization (string): Organization name - description (optional string): Workspace description - vcsProviderId (optional string |
| updateWorkspace | Update an existing workspace. - **Inputs**: - name (string): Name of the workspace - organization (string): Organization name - description (optional string): New workspace description - vcsProviderId (optional string): |
| deleteWorkspace | Delete a workspace. - **Inputs**: - name (string): Name of the workspace - organization (string): Organization name - **Returns**: Success status |
| getWorkspace | Get details of a specific workspace. - **Inputs**: - name (string): Name of the workspace - organization (string): Organization name - **Returns**: Workspace details |
| listWorkspaces | List all workspaces in an organization. - **Inputs**: - organization (string): Organization name - **Returns**: Array of workspace details |
| Variables | The Variables tool exposed by this server. |
| createVariable | Create a new variable in a workspace. - **Inputs**: - name (string): Name of the variable - organization (string): Organization name - workspace (string): Workspace name - value (string): Variable value - description (op |
| updateVariable | Update an existing variable. - **Inputs**: - name (string): Name of the variable - organization (string): Organization name - workspace (string): Workspace name - value (string): New variable value - description (optiona |
| deleteVariable | Delete a variable. - **Inputs**: - name (string): Name of the variable - organization (string): Organization name - workspace (string): Workspace name - **Returns**: Success status |
| getVariable | Get details of a specific variable. - **Inputs**: - name (string): Name of the variable - organization (string): Organization name - workspace (string): Workspace name - **Returns**: Variable details |
| listVariables | List all variables in a workspace. - **Inputs**: - organization (string): Organization name - workspace (string): Workspace name - **Returns**: Array of variable details |
| Modules | The Modules tool exposed by this server. |
| createModule | Create a new module. - **Inputs**: - name (string): Name of the module - organization (string): Organization name - provider (string): Module provider - description (optional string): Module description - **Returns**: Cr |
{
"mcpServers": {
"server-terrakube": {
"command": "npx",
"args": ["-y", "@smithery/cli"],
"env": {
"TERRAKUBE_API_URL": "your-value",
"TERRAKUBE_PAT_TOKEN": "your-value",
"YOUR_API_URL": "your-value",
"YOUR_PAT_TOKEN": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
| Variable | Description | Required |
|---|---|---|
| TERRAKUBE_API_URL | Endpoint or connection string the server talks to. | Yes |
| TERRAKUBE_PAT_TOKEN | Credential the server authenticates with. | Yes |
| YOUR_API_URL | Endpoint or connection string the server talks to. | Yes |
| YOUR_PAT_TOKEN | Credential the server authenticates with. | Yes |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.