keboola-cli-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| KBC_WORKING_DIR | No | Working directory for CLI operations | . |
| KBC_MAPPING_FILE | No | Path to branch mapping file | branch-mapping.json |
| GIT_DEFAULT_BRANCH | No | Default branch name (maps to production) | main |
| KBC_MCP_PROXY_MODE | No | Set to 'true' to enable proxy mode for remote Keboola MCP tools | false |
| KBC_STORAGE_API_HOST | Yes | Storage API host (without protocol), e.g., connection.keboola.com | |
| KBC_STORAGE_API_TOKEN | Yes | Keboola Storage API token |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| link_branchA | Links the current git branch to a Keboola development branch. If no Keboola branch with the specified name exists, creates one. The Keboola branch name defaults to the git branch name if not specified. |
| unlink_branchA | Removes the branch mapping for the current git branch. Does NOT delete the Keboola development branch - only removes the local mapping. Use the Keboola UI or API to delete the branch if needed. Note: Cannot unlink default branches (main/master) as they are implicitly mapped to production. Returns: Dictionary with git_branch, unlinked_keboola_branch_id, and message |
| get_mappingA | Gets the Keboola branch mapping for the current git branch. This is a safe, read-only operation that always succeeds. Returns: Dictionary with git_branch, keboola_branch_id, linked, and is_production |
| list_mappingsA | Lists all git-to-Keboola branch mappings. Returns: Dictionary with mappings dict and current_git_branch |
| kbcA | Execute a Keboola CLI command with automatic branch context. The current git branch is automatically resolved to its mapped Keboola branch, and the KBC_BRANCH_ID environment variable is set accordingly. |
| search_cli_docsA | Search Keboola CLI documentation for commands, flags, environment variables, and workflows. Use this to find information about kbc commands like sync, push, pull, remote, local, branch management, environment variables (KBC_BRANCH_ID, KBC_STORAGE_API_TOKEN), and DevOps workflows. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
All six tools have distinct purposes: getting a single mapping, listing all mappings, linking, unlinking, executing CLI commands, and searching documentation. There is no overlap or ambiguity.
Five tools follow a clear verb_noun pattern (get_mapping, link_branch, list_mappings, unlink_branch, search_cli_docs), but 'kbc' deviates as a short acronym, breaking the pattern slightly.
Six tools is well-scoped for managing branch mappings and CLI execution. Each tool serves a necessary function without being excessive or sparse.
The set covers the core lifecycle of branch mappings (create via link, read via get_mapping and list_mappings, delete via unlink) and includes CLI execution and docs search. An explicit update tool is missing, but linking may also update.