Komodo MCP Server

Create or update a Komodo Builder (PATCH-style). Attach a builder to a Build's `builder_id` before running it. action="create": new builder. Required: name. In `config` set `builder_type` ("Url", "Server", or "Aws") and the fields for that backend (e.g. Server → server_id; Url → address; Aws → region, instance_type). action="update": existing builder (`builder` required). Only the `config` fields you set change.

Create a new Komodo Builder named `name`, copying the configuration of the builder at `id`.

Unregister a Builder from Komodo. Builds that reference this builder's id will fail until re-attached.

Get the full Komodo Builder resource (type, connection/instance configuration). Offloaded via a session-scoped resource link unless `inline_full` is set.

List all builders registered in Komodo. Builders are compute targets Komodo uses to run Docker builds (Periphery address, a connected server, or an on-demand AWS EC2 instance).

Rename a Komodo Builder.

Run a lifecycle action on a Docker container: start, stop, restart, pause, or unpause. The container must exist on the target server. Note: pause/unpause use cgroups freezer; restart is stop+start.

Get detailed low-level information about a container. Returns Docker inspect data including configuration, state, network settings, mounts, and process info.

List all containers on a server, including running, stopped, and paused containers. Shows container name, state, and image.

Get stdout and stderr logs from a container. Useful for debugging, monitoring application output, and troubleshooting issues.

Search container logs for specific patterns or keywords. Retrieves logs and filters them client-side. Returns matching lines with a count of matches. Large match sets are offloaded as a session-scoped resource link unless `inline_full` is set.

Lifecycle action on a deployment: deploy (recreate container), pull (image only), start, restart, pause, unpause, stop, destroy (remove container). destroy is destructive; config preserved.

Create or update a Komodo deployment (Docker container, PATCH-style). action="create": new deployment. Required: name. Recommended: server_id, image. action="update": existing deployment (`deployment` required). Only fields in `config` change. Image accepts a string ("nginx:1.25") or { type: "Image"|"Build", params: {…} }.

Delete a Komodo deployment. Removes the deployment configuration and stops/removes the associated container.

Get detailed information about a Komodo-managed deployment, including its configuration, current state, and assigned server.

List all Komodo-managed deployments. Deployments are single-container applications managed by Komodo. Shows deployment name, ID, and current state.

Get the layer history of a Docker image (each build step, its size, and the command that produced it).

Get detailed Docker inspect data for an image (config, layers, exposed ports, env, labels).

List Docker images cached locally on a server, with size and in-use status.

Get detailed Docker inspect data for a network (subnets, connected containers, IPAM config).

List Docker networks on a server, with driver and scope.

Get detailed Docker inspect data for a volume (labels, driver options, scope).

List Docker volumes on a server, with driver, mountpoint, and in-use status.

Execute a shell command on a Komodo target. `target` selects the context: server (server[, shell, terminal]) | container (server, container[, shell]) | deployment (deployment[, shell]) | stack_service (stack, service[, shell]). Output ≤50 KB; timeout 5 min.

Check the Komodo connection status. Returns health, authentication status, and API version. Works without an active connection (reports unconfigured state).

Procedure action. action='run': run a Komodo Procedure end-to-end (long-running — polls until the underlying Update reaches Complete and returns the per-stage logs).

Create or update a Komodo Procedure (PATCH-style). A procedure is a multi-stage workflow run manually or on schedule. action="create": new procedure. Required: name. action="update": existing procedure (`procedure` required). Only fields in `config` change.

Unregister a Procedure from Komodo. Cancels any future scheduled runs.

Get the full Komodo Procedure resource (configuration, stages, schedule).

List all procedures registered in Komodo. A procedure is a multi-stage workflow that can be triggered manually or on a schedule.

Lifecycle action on a Komodo Repo. clone/pull/build are long-running and polled to completion. cancel_build is fire-and-forget.

Create or update a Komodo Repo (PATCH-style). Not cloned automatically — call `komodo_repo_action` clone afterwards. action="create": new repo. Required: name. action="update": existing repo (`repo` required). Only fields in `config` change.

Unregister a Repo from Komodo. Does not affect the cloned working copy on the server.

Get the full Komodo Repo resource (configuration + last clone/build metadata).

List all repos registered in Komodo. Shows id, name, state, attached server/builder, configured repo+branch, and the cloned/built/latest short commit hashes.

Lifecycle action on a Komodo ResourceSync. 'run' executes the sync (applies pending changes — long-running, polled). 'refresh' updates the pending-changes preview without applying anything.

Create or update a Komodo ResourceSync (PATCH-style on update). Not executed automatically — call `komodo_resource_sync_action` with action='run' afterwards. action="create": new sync. Required: name. Provide `config` with repo+branch+resource_path or inline file_contents. action="update": existing sync (`resource_sync` required). Only fields in `config` change.

Unregister a ResourceSync from Komodo. Resources created via previous syncs are not removed.

Get the full Komodo ResourceSync resource including pending diffs.

List all resource syncs registered in Komodo. Shows configured repo+branch, managed mode, and last successful sync timestamp/hash.

Host-level operations on a Komodo server: batch container lifecycle (start/restart/pause/unpause/stop all), Docker resource pruning (containers, images, volumes, networks, system, builders, buildx), or deletion of named networks/images/volumes. Destructive — frees disk space or stops workloads.

Create or update a Komodo Server (PATCH-style; safe to call repeatedly). action="create": new server. Required: name. Periphery agent must be reachable at config.address. action="update": existing server (`server` required). Only fields in `config` change.

Delete (unregister) a server

Get detailed information about a specific server

List all servers registered in Komodo. Shows server name, ID, status (healthy/unhealthy/disabled), Periphery version, and region.

Get server health status and state. Returns whether the Periphery agent is reachable and the server is healthy. For detailed system metrics, use komodo_server_info.

Lifecycle action on a Compose stack: deploy (up), pull, start, restart, pause, unpause, stop, destroy (down — removes containers). destroy is destructive; config preserved.

Create or update a Docker Compose stack in Komodo (PATCH-style). action="create": new stack. Required: name. Recommended: server_id (Compose) or swarm_id (Swarm). action="update": existing stack (`stack` required). Only fields in `config` change. File source on create: file_contents | repo+branch | files_on_host.

Delete a Compose stack from Komodo. This removes the stack configuration but does not affect running containers.

Get detailed information about a Compose stack including configuration, current state, compose file contents, services, and environment variables.

List all Komodo-managed Compose stacks. Shows stack name, ID, and current state.

Swarm management. update_node: change availability/labels/role. remove_nodes: force-remove. remove_services / remove_stacks: equivalents of docker service rm / docker stack rm.

Create or update a Komodo Swarm (PATCH-style). Servers in config.server_ids form one Docker Swarm cluster. action="create": new swarm. Required: name. Recommended: config.server_ids. action="update": existing swarm (`swarm` required). Only fields in `config` change.

Unregister a Swarm from Komodo. Does NOT teardown the underlying Docker Swarm — it only removes the Komodo resource entry.

Get the full Komodo Swarm resource (manager server ids, links, alert/maintenance configuration). Large payloads are offloaded via a session-scoped resource link when available.

List all swarms registered in Komodo. Each swarm groups one or more Server resources that act as Docker Swarm managers.

List the Docker nodes participating in a Komodo Swarm.

List Docker services running on a Komodo Swarm.

Create or update a Komodo Tag. Tags label resources for filtering/grouping. action="create": new tag. Required: name. Optional: color (default Slate). action="update": existing tag (`tag` required). Provide `name` to rename and/or `color` to recolor — at least one; each triggers its own API call (there is no combined update endpoint).

Delete a Komodo Tag. Also removes this tag from every resource it was attached to.

Get the full Komodo Tag resource (id, name, owner, color). Tags are small — always returned inline.

List all tags registered in Komodo. Tags are labels attached to resources for filtering/grouping.

Export every resource the caller can view as sync TOML — the same format komodo_resource_sync_* reads from a git repo. Secret values (variable values, server passkeys, alerter webhook URLs) are redacted, so the export is for inspection and diffing, not for re-applying verbatim via ResourceSync. Large output is offloaded as a session-scoped resource link unless `inline_full` is set.

Export a specific set of resources and/or user groups as sync TOML. Secret values are redacted, so the export is for inspection and diffing, not for re-applying verbatim via ResourceSync.

Get the full update payload for a single operation, including per-stage logs (stdout/stderr).

List Komodo update history (audit log of operations like Deploy/RunBuild/RunSync). Newest first. Supports filtering by operation name and resource target. Pagination uses an opaque cursor string (Komodo backend is page-based).

Create a new API key for the currently authenticated Komodo user. Returns the key and secret — the secret is shown only once and cannot be retrieved later. NOTE: the one-time secret is intentionally NOT redacted from this result and persists in the client transcript — rotate the key if the transcript is untrusted. Optionally set an expiry time.

Delete an API key for the currently authenticated Komodo user. Accepts either the key name or the full K_... key string. Use komodo_user_list_api_keys to see available keys.

List all API keys for the currently authenticated Komodo user. Shows key name, key ID (not secret), creation date, and expiry.

Create or update a Komodo Variable (PATCH-style on update). action="create": new variable. Required: name. Optional: value, description, is_secret. action="update": existing variable (name required). Each of value, description, is_secret triggers a separate update call when provided.

Delete a Komodo Variable. Stacks/Deployments referencing it via `[[variable.name]]` will fail to interpolate afterwards.

Get a single Komodo variable. Secret variables are redacted for non-admin users.

List all global variables registered in Komodo. Secret variables have their value redacted for non-admin users.