Komodo MCP Server

Get logs from a Docker container running on a Komodo Server. Requires both the server name and the container name. Optionally search for specific terms in the log output.

Get detailed information about a specific Komodo Deployment by name or ID. A Deployment is a single Docker container managed by Komodo. Returns configuration, image, state, container status, and current action state.

Get logs from a Komodo Deployment's Docker container. Optionally search for specific terms in the log output. A Deployment is a single Docker container managed by Komodo. Returns the most recent log lines from the container.

Get a summary of all Komodo Deployments. Returns aggregate counts by state: total, running, stopped, not deployed, unhealthy, and unknown.

Get detailed information about a specific Komodo Procedure by name or ID. A Procedure is an orchestrated sequence of stages. Returns stages with their operations and current action state.

Get detailed information about a specific Komodo Repo by name or ID. A Repo is a Git repository cloned to a server. Returns clone URL, branch, server, on_clone/on_pull commands, and current action state.

Get detailed information about a specific Komodo Resource Sync by name or ID. A Resource Sync manages Komodo resources from TOML files in a Git repo. Returns git configuration, managed resources, and current sync state.

Get detailed information about a specific Komodo Server by name or ID. A Server is a remote machine managed by Komodo's Periphery agent. Returns configuration, status, region, and current action state.

Get system information and running processes for a Komodo Server. A Server is a remote machine managed by Komodo's Periphery agent. Returns OS details, hardware info, and a list of active processes sorted by resource usage.

Get current resource usage statistics for a Komodo Server. A Server is a remote machine managed by Komodo's Periphery agent. Returns CPU percentage, memory usage, disk usage, and system load averages.

Get detailed information about a specific Komodo Stack by name or ID. A Stack is a multi-container deployment defined by a Docker Compose file. Returns configuration, state, services, git repo info, and current action state.

Get logs from a Komodo Stack's Docker Compose services. Optionally search for specific terms in the log output. A Stack is a multi-container deployment defined by a Docker Compose file. Returns the most recent log lines from all or specified services. A search with no hits reports 'No lines matched'; note that an unknown service name in services also yields no matches.

Get a summary of all Komodo Stacks. Returns aggregate counts by state: total, running, stopped, down, unhealthy, and unknown.

Get detailed information about a specific Komodo Update (operation record) by ID. Returns the full operation details including status, success/failure, operator, timestamps, and complete execution logs with stdout/stderr for each stage. Use this to check deploy results, diagnose failures, or monitor in-progress operations.

Inspect the Docker container associated with a Deployment. Returns the full container state including configuration, mounts, network settings, and runtime status (equivalent to docker inspect).

Inspect a Docker container on a Komodo Server. Returns the full container state including configuration, mounts, network settings, and runtime status (equivalent to docker inspect).

Inspect a Docker image on a Komodo Server. Returns the full image metadata including layers, configuration, labels, and creation info (equivalent to docker image inspect).

Inspect a Docker network on a Komodo Server. Returns the full network configuration including driver, IPAM settings, connected containers, and options (equivalent to docker network inspect).

Inspect a Docker volume on a Komodo Server. Returns the full volume metadata including driver, mount point, labels, and options (equivalent to docker volume inspect).

Inspect a Docker container for a specific service within a Stack. Returns the full container state including configuration, mounts, network settings, and runtime status (equivalent to docker inspect).

List all Komodo Actions. An Action is a custom TypeScript/Deno script that runs on the Komodo Core server. Returns name and state for each action.

List all Komodo Alerters. An Alerter is a notification endpoint (Slack, Discord, or custom webhook) for Komodo alerts and status changes. Returns name and type for each alerter.

List the API keys of a service user (admin only). Secrets are never returned

List all Komodo Builders. A Builder is a build server (or AWS instance) used to compile Docker images for Komodo Builds. Returns name and type for each builder.

List all Komodo Builds. A Build is a Docker image build configuration that compiles source code into container images using a configured Builder. Returns name and version info for each build.

List all Komodo Deployments. A Deployment is a single Docker container managed by Komodo, deployed to a specific server. Returns name, state, image, and server for each deployment.

List the permissions granted to a user or user group (admin only)

List all Komodo Procedures. A Procedure is an orchestrated sequence of parallel stages that run other Komodo operations (deploy, build, pull, etc.). Returns name and state for each procedure.

List all Komodo Repos. A Repo is a Git repository cloned to a server, optionally built using a Builder. Returns name, repo URL, server, and state for each repo.

List all Komodo Resource Syncs. A Resource Sync is a GitOps sync that manages Komodo resources from TOML configuration files in a Git repository. Returns name, state, and repo info for each sync.

List all Komodo Servers. A Server is a remote machine managed by Komodo's Periphery agent. Returns name, status, and region for each server.

List all services in a Komodo Stack. Returns the service name, Docker image, container state, and whether an image update is available for each service in the Compose file.

List all Komodo Stacks. A Stack is a multi-container deployment defined by a Docker Compose file, deployed to a specific server. Returns name, state, server, and service count for each stack.

List Komodo operation history (updates). Every execute operation (deploy, start, stop, build, pull, etc.) creates an Update record. Filter by resource type, resource name/ID, operation, or success status. Returns operation, target, status, and timestamp for each update. Use komodo_get_update with an update ID to see full logs.

List Komodo users, optionally filtering service users (admin only)

⚠️ PRUNE unused Docker resources on a specific Komodo Server. Removes stopped containers, dangling images, unused volumes, or unused networks depending on the resource type chosen. This frees disk space but deleted resources CANNOT BE RECOVERED. A Server is a remote machine managed by Komodo's Periphery agent.

⚠️ PULL the image for a Komodo Deployment (docker pull). Downloads the latest image without redeploying the container. Use this to pre-pull an image before a deploy, or to check for updates.

⚠️ PULL images for a Komodo Stack (docker compose pull). Downloads the latest images without redeploying. Use this to pre-pull images before a deploy, or to check for updates. Optionally filter to specific services.

⚠️ CLONE or PULL a Komodo Repo on its target server. 'clone' performs initial git clone (or pulls if already cloned). 'pull' performs git pull to get latest changes. Both may trigger on_clone/on_pull commands configured on the repo. A Repo is a Git repository cloned to a server.

⚠️ RUN a Komodo Action. This executes a custom TypeScript/Deno script on the Komodo Core server. Actions can perform arbitrary operations depending on their script content. An Action is a custom TypeScript/Deno script that runs on Komodo Core.

⚠️ RUN a Komodo Build to create a Docker image. This clones the repo (if needed), runs docker build, and pushes the resulting image to the configured registry. Builds can take several minutes. A Build is a Docker image build configuration that compiles source code into container images using a configured Builder.

⚠️ RUN a Komodo Procedure. This executes all stages in sequence, where each stage can run multiple operations in parallel. A Procedure may deploy stacks, run builds, pull repos, and perform other Komodo operations. Procedures can take several minutes depending on their stages. A Procedure is an orchestrated sequence of parallel stages.

⚠️ LIFECYCLE: Control a Komodo Stack's container lifecycle. Start brings up all containers, stop brings them down gracefully, restart stops then starts, pause freezes without stopping, unpause resumes. A Stack is a multi-container deployment defined by a Docker Compose file. Optionally limit the action to specific services within the stack.

⚠️ TRIGGER a Komodo Resource Sync. This pulls the latest TOML configuration from the Git repo and applies changes to managed Komodo resources. May create, update, or delete resources based on config changes. A Resource Sync is a GitOps sync that manages Komodo resources from TOML files in a Git repository.

Set a user or user group's base permission level on ALL resources of a type (admin only)

Set a user or user group's permission level on ONE specific resource (admin only)

Update a user's base flags: enabled, create servers, create builds (admin only)

Create, update, or delete any Komodo resource. Supports all 10 resource types: Stack, Deployment, Build, Repo, Procedure, Action, Alerter, Builder, ResourceSync, Variable. CREATE: Provide resource_type, action='create', name, and optional config. UPDATE: Provide resource_type, action='update', id (or name for Variable), and config with fields to change. Updates use partial merge -- only provided config fields are changed, others remain as-is. Use the corresponding get tool first to inspect current config before updating. DELETE: Provide resource_type, action='delete', and id (or name for Vari…