Komodo MCP Server

Run a Komodo Action end-to-end (long-running — polls until the underlying Update reaches Complete and returns the run logs). action='run' is currently the only verb.

Create or update a Komodo Action (PATCH-style). An Action is a scheduled Deno/TypeScript script that runs against the Komodo API. action="create": new Action. Required: name. action="update": existing Action (`action_id` required). Only fields in `config` change.

Unregister an Action from Komodo. Cancels any future scheduled runs.

Get the full Komodo Action resource (script body, schedule, webhook config). The TypeScript script body is offloaded via a session-scoped resource link when available.

List all Actions registered in Komodo. An Action is a scheduled Deno/TypeScript script that runs against the Komodo API.

Create or update a Komodo Alerter (PATCH-style). Alerters route monitoring alerts to external sinks (Slack, Discord, custom HTTP, ...). action="create": new alerter. Required: name. Provide `config.endpoint` with discriminated `type` and provider params. action="update": existing alerter (`alerter` required). Only fields in `config` change.

Unregister an Alerter from Komodo. Future alerts that would have been routed here are dropped.

Get the full Komodo Alerter resource (endpoint configuration, alert filters, maintenance windows). Sensitive fields like webhook URLs are offloaded via a session-scoped resource link when available.

List all alerters registered in Komodo. Alerters are sinks (Slack, Discord, Custom HTTP, ...) that receive alerts when monitored resources change state.

Run a lifecycle action on a Komodo Build. action=run: trigger build (long-running; polled to completion). action=cancel: abort in-progress build (fire-and-forget). Returns the resulting Update.

Create or update a Komodo Build (PATCH-style). Does not trigger a build — call `komodo_build_action` run afterwards. action="create": new build. Required: name. Provide repo/branch/builder in config. action="update": existing build (`build` required). Only fields in `config` change.

Unregister a Build from Komodo. Does not delete previously pushed images from the registry.

Get the full Komodo Build resource for a single build, including its configuration (builder, repo/branch, image, dockerfile, build args, labels) and last-built metadata.

List all builds registered in Komodo. Shows build id, name, current state (Building/Ok/Failed/Unknown), version, attached builder, source repo and branch.

Fetch per-stage logs from a previous build run. Pass the `update_id` returned by `komodo_build_action`.

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.