Skip to main content
Glama

coolify-mcp

MCP server for managing Coolify instances (v4.3+ API). Control applications, databases, services, servers, and more directly from Claude or any MCP-compatible client.

136 tools | 7 resources | 4 prompts

Requires Coolify v4.3.0 or newer (/api/v1); v4.4.2 is recommended and is the integration-test target for MCP 4.2.0. Tools and options marked v4.4+ need Coolify v4.4.0 or newer and answer 404 or 422 on older instances. Legacy GET-based state-changing endpoints are not supported.

See the 4.2.0 API audit for pinned upstream sources, compatibility changes, and endpoints that are not wrapped. The 4.1.0 audit covers v4.3.23.

Installation

Claude Code

claude mcp add coolify \
  -e COOLIFY_API_URL=http://your-server:8000/api/v1 \
  -e COOLIFY_TOKEN=your-token \
  -- npx mcp-coolify

Codex

codex mcp add coolify \
  --env COOLIFY_API_URL=http://your-server:8000/api/v1 \
  --env COOLIFY_TOKEN=your-token \
  -- npx mcp-coolify

Other MCP clients

COOLIFY_API_URL=http://your-server:8000/api/v1 \
COOLIFY_TOKEN=your-token \
npx mcp-coolify

From source

git clone https://github.com/0xtlt/coolify-mcp
cd coolify-mcp && pnpm install
COOLIFY_API_URL=... COOLIFY_TOKEN=... pnpm start

Claude Desktop

Add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "coolify": {
      "command": "pnpm",
      "args": ["exec", "tsx", "/path/to/coolify-mcp/src/index.ts"],
      "env": {
        "COOLIFY_API_URL": "http://your-server:8000/api/v1",
        "COOLIFY_TOKEN": "your-token"
      }
    }
  }
}

Get your API token

Coolify dashboard: Keys & Tokens > API tokens

On Coolify v4.4+ pick the token abilities for what you want to do:

Ability

Needed for

read

List and get tools

read:sensitive

All log tools, coolify_list_server_registries, secrets in responses, audit event details, import output

write

[WRITE] and [DESTRUCTIVE] tools

deploy

Deploy, start, stop and restart tools, instant_deploy, coolify_deploy_application_preview, database imports from a server path

Related MCP server: Coolify MCP Server

Available Tools

Applications (8)

Tool

Description

coolify_list_applications

List all applications (summary)

coolify_get_application

Get application details

coolify_create_application

[WRITE] Create from public/private repo, Dockerfile, or Docker image

coolify_update_application

[WRITE] Update application config

coolify_start_application

[WRITE] Start a stopped application

coolify_stop_application

[DESTRUCTIVE] Stop an application

coolify_restart_application

[DESTRUCTIVE] Restart an application

coolify_delete_application

[DESTRUCTIVE] Delete an application

Preview Deployments (6)

Each tool takes the parent application uuid; all but the list take a pull_request_id between 1 and 2147483647. List, get and deploy need Coolify v4.4+.

Tool

Description

coolify_list_application_previews

List previews of an application (summary)

coolify_get_application_preview

Get one preview with its domains and status

coolify_deploy_application_preview

[WRITE] Open or redeploy the preview of a pull request (git_type/commit for Git apps, docker_tag for Docker Image apps)

coolify_get_application_preview_logs

Read preview runtime logs with the same filters as application logs

coolify_update_application_preview

[WRITE] Replace preview domains using domains or docker_compose_domains

coolify_delete_application_preview

[DESTRUCTIVE] Remove the preview, its containers, volumes, and networks

Databases (11)

Tool

Description

coolify_list_databases

List all databases (summary)

coolify_get_database

Get database details

coolify_create_database

[WRITE] Create PostgreSQL, MySQL, MariaDB, MongoDB, Redis, KeyDB, Dragonfly, ClickHouse, or SQLite (v4.4+)

coolify_update_database

[WRITE] Update database config

coolify_list_database_backups

List backups for a database

coolify_create_database_backup

[WRITE] Create a backup schedule (frequency required, optional backup_now)

coolify_delete_database_backup

[DESTRUCTIVE] Delete a scheduled backup config

coolify_start_database

[WRITE] Start a stopped database

coolify_stop_database

[DESTRUCTIVE] Stop a database

coolify_restart_database

[DESTRUCTIVE] Restart a database

coolify_delete_database

[DESTRUCTIVE] Delete a database

Backup Schedule Updates & Executions (3)

Tool

Description

coolify_update_database_backup

[WRITE] Update schedule, retention, S3 and missing-backup alerts

coolify_list_backup_executions

List execution history for a database backup schedule

coolify_delete_backup_execution

[DESTRUCTIVE] Delete a backup execution

Database Imports (4)

Coolify v4.4+. An import runs in the background: start it, then poll the status tool until status is finished or error. source is s3 (s3_storage_uuid + path), server (absolute path on the database server) or upload (upload_id of a file sent to POST .../imports/uploads).

Tool

Description

coolify_import_database

[DESTRUCTIVE] Restore a backup into a standalone database

coolify_get_database_import

Get the status of a standalone database import

coolify_import_service_database

[DESTRUCTIVE] Restore a backup into a database of a service

coolify_get_service_database_import

Get the status of a service database import

Services (8)

Tool

Description

coolify_list_services

List all services (summary)

coolify_get_service

Get service details

coolify_create_service

[WRITE] Create a one-click Docker Compose service

coolify_update_service

[WRITE] Update service config

coolify_start_service

[WRITE] Start a stopped service

coolify_stop_service

[DESTRUCTIVE] Stop a service

coolify_restart_service

[DESTRUCTIVE] Restart a service

coolify_delete_service

[DESTRUCTIVE] Delete a service

Servers (8)

Tool

Description

coolify_list_servers

List all servers (summary)

coolify_get_server

Get server details

coolify_create_server

[WRITE] Add a new server (requires SSH key)

coolify_update_server

[WRITE] Update server config

coolify_validate_server

[WRITE] Validate SSH connectivity and Docker (POST)

coolify_get_server_resources

List all resources on a server

coolify_get_server_domains

List all domains on a server

coolify_delete_server

[DESTRUCTIVE] Delete a server (delete_from_provider also deletes the cloud machine, v4.4+)

Docker Registry Logins (4)

Coolify v4.4+. Coolify runs docker login on the server and does not store the token. registry is a host such as ghcr.io or registry.example.com:5000.

Tool

Description

coolify_list_server_registries

List registries a server is logged in to and the ones its applications need

coolify_login_server_registry

[WRITE] Log in to a registry or update the login

coolify_check_server_registry

[WRITE] Check that a stored login still works

coolify_logout_server_registry

[DESTRUCTIVE] Log out of a registry

Private Keys (5)

Tool

Description

coolify_list_private_keys

List all SSH private keys (summary)

coolify_get_private_key

Get private key details

coolify_create_private_key

[WRITE] Create a new SSH key

coolify_update_private_key

[WRITE] Update an SSH key

coolify_delete_private_key

[DESTRUCTIVE] Delete an SSH key

Projects & Environments (9)

Tool

Description

coolify_list_projects

List all projects (summary)

coolify_get_project

Get project details

coolify_create_project

[WRITE] Create a new project

coolify_update_project

[WRITE] Update a project

coolify_delete_project

[DESTRUCTIVE] Delete a project

coolify_list_environments

List environments in a project

coolify_get_environment

Get environment details

coolify_create_environment

[WRITE] Create an environment

coolify_delete_environment

[DESTRUCTIVE] Delete an environment

Deployments (5)

Tool

Description

coolify_list_deployments

List currently running/queued deployments

coolify_list_application_deployments

List deployment history for an application (with pagination)

coolify_get_deployment

Get deployment details

coolify_trigger_deploy

[WRITE] Trigger a deployment (POST /deploy)

coolify_cancel_deployment

[WRITE] Cancel a running deployment

Application Env Vars (4)

Tool

Description

coolify_list_envs

List env vars for an application

coolify_create_env

[WRITE] Create an env var

coolify_update_envs_bulk

[WRITE] Bulk update env vars

coolify_delete_env

[DESTRUCTIVE] Delete an env var

Service Env Vars (4)

Tool

Description

coolify_list_service_envs

List env vars for a service

coolify_create_service_env

[WRITE] Create a service env var

coolify_update_service_envs_bulk

[WRITE] Bulk update service env vars

coolify_delete_service_env

[DESTRUCTIVE] Delete a service env var

Database Env Vars (4)

Tool

Description

coolify_list_database_envs

List env vars for a database

coolify_create_database_env

[WRITE] Create a database env var

coolify_update_database_envs_bulk

[WRITE] Bulk update database env vars

coolify_delete_database_env

[DESTRUCTIVE] Delete a database env var

Storages (12)

Tool

Description

coolify_list_application_storages

List application persistent + file storages

coolify_create_application_storage

[WRITE] Create storage (type: persistent|file)

coolify_update_application_storage

[WRITE] Update storage (body: uuid + type)

coolify_delete_application_storage

[DESTRUCTIVE] Delete application storage

coolify_list_database_storages

List database storages

coolify_create_database_storage

[WRITE] Create database storage

coolify_update_database_storage

[WRITE] Update database storage

coolify_delete_database_storage

[DESTRUCTIVE] Delete database storage

coolify_list_service_storages

List service storages

coolify_create_service_storage

[WRITE] Create service storage (resource_uuid required)

coolify_update_service_storage

[WRITE] Update service storage

coolify_delete_service_storage

[DESTRUCTIVE] Delete service storage

Volume Backups (9)

Tool

Description

coolify_set_application_storage_backup

[WRITE] Create/replace application volume backup schedule

coolify_run_application_storage_backup

[WRITE] Run on-demand application volume backup

coolify_delete_application_storage_backup

[DESTRUCTIVE] Delete application volume backup schedule

coolify_set_database_storage_backup

[WRITE] Create/replace database volume backup schedule

coolify_run_database_storage_backup

[WRITE] Run on-demand database volume backup

coolify_delete_database_storage_backup

[DESTRUCTIVE] Delete database volume backup schedule

coolify_set_service_storage_backup

[WRITE] Create/replace service volume backup schedule

coolify_run_service_storage_backup

[WRITE] Run on-demand service volume backup

coolify_delete_service_storage_backup

[DESTRUCTIVE] Delete service volume backup schedule

Scheduled Tasks (10)

Tool

Description

coolify_list_application_scheduled_tasks

List application tasks

coolify_create_application_scheduled_task

[WRITE] Create an application task

coolify_update_application_scheduled_task

[WRITE] Update an application task

coolify_delete_application_scheduled_task

[DESTRUCTIVE] Delete an application task

coolify_list_application_scheduled_task_executions

List application task executions

coolify_list_service_scheduled_tasks

List service tasks

coolify_create_service_scheduled_task

[WRITE] Create a service task

coolify_update_service_scheduled_task

[WRITE] Update a service task

coolify_delete_service_scheduled_task

[DESTRUCTIVE] Delete a service task

coolify_list_service_scheduled_task_executions

List service task executions

GitHub Apps (6)

Tool

Description

coolify_list_github_apps

List GitHub integrations

coolify_create_github_app

[WRITE] Create an integration

coolify_update_github_app

[WRITE] Update an integration

coolify_delete_github_app

[DESTRUCTIVE] Delete an integration

coolify_list_github_app_repositories

List accessible repositories

coolify_list_github_app_branches

List repository branches

Logs (3)

Tool

Description

coolify_get_logs

Get application logs with filtering

coolify_get_database_logs

Get database logs with filtering

coolify_get_service_logs

Get service logs with filtering

System (3)

Tool

Description

coolify_get_version

Get Coolify instance version

coolify_healthcheck

Check if Coolify is healthy

coolify_list_resources

List resources across projects

Audit Log (1)

Coolify v4.4+. Requires a team admin/owner API token.

Tool

Description

coolify_list_audit_events

List UI, API, MCP and webhook activity, newest first (search, action, source, page, per_page)

Secret Managers (2)

Coolify v4.4+. After linking, reference secrets in environment variables as {{vault.KEY}}.

Tool

Description

coolify_create_integration_token

[WRITE] Store a Doppler, Infisical, or HashiCorp Vault token for the team

coolify_update_application_secret_manager

[WRITE] Link an application to a secret manager token

Instance Email Settings (2)

Verified on Coolify v4.3.23. Requires a root-team admin/owner API token. Reading secret values requires read:sensitive or root; updating requires write:sensitive.

Tool

Description

coolify_get_instance_email_settings

Read instance-wide SMTP and Resend settings

coolify_update_instance_email_settings

[WRITE] Update SMTP/Resend settings; null clears nullable fields

Teams (5)

Tool

Description

coolify_list_teams

List all teams

coolify_get_current_team

Get token team (GET /team)

coolify_update_current_team

[WRITE] Set the build server fallback of the token team (v4.4+)

coolify_get_current_team_members

List token team members (GET /team/members)

coolify_get_team_members

List members of a team by ID

Available Resources

URI

Description

coolify://applications

List of all applications

coolify://databases

List of all databases

coolify://services

List of all services

coolify://servers

List of all servers

coolify://deployments

List of all deployments

coolify://projects

List of all projects

coolify://private-keys

List of all SSH private keys

Available Prompts

Prompt

Description

troubleshoot_deployment

Step-by-step guide to debug a failed deployment

infrastructure_overview

Get a complete overview of all infrastructure

deploy_application

Guided workflow to deploy an application

setup_new_application

Guided workflow to create and configure a new app

Safety Modes

Variable

Description

COOLIFY_READONLY=true

Only read operations available (list, get, logs)

COOLIFY_REQUIRE_CONFIRM=true

Destructive operations require confirm: true

Log Filtering

The coolify_get_logs, coolify_get_application_preview_logs, coolify_get_database_logs, and coolify_get_service_logs tools support:

  • level: Minimum log level (debug, info, warn, error, fatal)

  • since/until: ISO 8601 timestamps for time range

  • search: Case-insensitive text search

  • lines: Server lines to fetch (defaults to limit, up to 10000; "all" or -1 fetches all)

  • show_timestamps: Include server timestamps (default true)

  • limit: Max filtered entries returned (default 100, max 1000)

  • tail: Get most recent logs

  • service_name (application and preview logs, v4.4+): Compose service whose container to read

Coolify v4.4+ only serves logs to tokens with the read:sensitive ability.

API Compatibility Notes for 4.2.0

  • Logs need read:sensitive on Coolify v4.4+. A token with only read gets 403 from every log tool. Create a new token with read:sensitive, or root.

  • instant_deploy on application, database and service creation, and on application updates, needs the deploy ability on Coolify v4.4+.

  • Servers have a server_role (deployment, build, both). is_build_server still works but is deprecated; sending both with different meanings fails before the request.

  • Scheduled task timeout is limited to 1-36000 seconds, as Coolify v4.4 validates it.

  • Database start and restart answer 409 while another start, restart or import runs.

  • The multipart upload endpoint for imports (POST .../imports/uploads, up to 10 GiB) is not wrapped. Use source: "s3" or source: "server", or upload the file yourself and pass its upload_id.

API Compatibility Notes for 4.1.0

  • Storage creation/update no longer accepts host_path. Calls supplying it receive a migration error before contacting Coolify. Use a named type: "persistent" volume, or create type: "file" with fs_path and either is_directory: true or is_host_file: true. Existing mount sources cannot be changed through the update endpoint.

  • coolify_create_database_backup now requires frequency and creates a schedule; set backup_now: true to also execute it immediately. The result includes the schedule UUID. Create/update support retention, S3 (s3_storage_uuid), timeout, and missing_backup_notification_days (0 disables alerts). The unsupported update fields s3_storage_id and database_name_prefix have been removed.

  • Preview-domain updates replace the entire domain configuration. Supply exactly one of domains (regular app; null clears it) or docker_compose_domains (Compose app; [] clears it).

Environment Variables

Variable

Required

Description

COOLIFY_API_URL

Yes

Coolify API URL (e.g. http://your-server:8000/api/v1)

COOLIFY_TOKEN

Yes

Bearer token from Coolify dashboard

COOLIFY_TIMEOUT

No

Request timeout in ms (default: 30000)

COOLIFY_READONLY

No

Read-only mode (default: false)

COOLIFY_REQUIRE_CONFIRM

No

Require confirmation for destructive ops (default: false)

DEBUG

No

Enable debug logging (default: false)

Development

pnpm install             # Install dependencies
pnpm run dev             # Watch mode
pnpm run inspect         # MCP Inspector
pnpm run check           # Lint + typecheck + test
pnpm test                # Run tests only

License

MIT

Available Tools

136 tools
coolify_cancel_deploymentC

[WRITE] Cancel a running or queued deployment

Inputs: uuid (required).

coolify_check_server_registryA

[WRITE] Check that the stored login of a server for a Docker registry still works (Coolify v4.4+). Changes nothing, but the API requires write ability.

Inputs: uuid (required), registry (required).

coolify_create_applicationC

[WRITE] Create a new Coolify application from various sources

Inputs: server_uuid (required), source_type (required), project_uuid (required), environment_name (required), +15 more.

coolify_create_application_scheduled_taskC

[WRITE] Create a scheduled task for a Coolify application

Inputs: name (required), uuid (required), command (required), frequency (required), +3 more.

coolify_create_application_storageA

[WRITE] Add a persistent or file storage mount to a Coolify application

Inputs: type (required), uuid (required), mount_path (required), name, +5 more.

coolify_create_databaseC

[WRITE] Create a new Coolify database

Inputs: type (required), server_uuid (required), project_uuid (required), environment_name (required), +10 more.

coolify_create_database_backupB

[WRITE] Create a database backup schedule (frequency required). Set backup_now=true to also run it immediately.

Inputs: uuid (required), frequency (required), enabled, save_s3, +12 more.

coolify_create_database_envB

[WRITE] Create a new environment variable for a Coolify database

Inputs: key (required), uuid (required), value (required), comment, +4 more.

coolify_create_database_storageA

[WRITE] Add a persistent or file storage mount to a Coolify database

Inputs: type (required), uuid (required), mount_path (required), name, +5 more.

coolify_create_envB

[WRITE] Create a new environment variable for a Coolify application

Inputs: key (required), uuid (required), value (required), comment, +4 more.

coolify_create_environmentC

[WRITE] Create a new environment in a Coolify project

Inputs: name (required), project_uuid (required).

coolify_create_github_appC

[WRITE] Create a new GitHub App integration in Coolify

Inputs: name (required), custom_fields.

coolify_create_integration_tokenA

[WRITE] Store a Doppler, Infisical, or HashiCorp Vault token for the team (Coolify v4.4+). Coolify validates the token against the provider before saving it.

Inputs: name (required), token (required), provider (required), metadata.

coolify_create_private_keyB

[WRITE] Create a new SSH private key for server/application authentication

Inputs: name (required), private_key (required), description.

coolify_create_projectC

[WRITE] Create a new Coolify project

Inputs: name (required), description.

coolify_create_serverC

[WRITE] Create a new Coolify server (requires SSH private key)

Inputs: ip (required), name (required), private_key_uuid (required), port, +5 more.

coolify_create_serviceB

[WRITE] Create a new Coolify service (one-click Docker Compose service)

Inputs: type (required), server_uuid (required), project_uuid (required), environment_name (required), +4 more.

coolify_create_service_envC

[WRITE] Create a new environment variable for a Coolify service

Inputs: key (required), uuid (required), value (required), comment, +4 more.

coolify_create_service_scheduled_taskB

[WRITE] Create a scheduled task for a Coolify service

Inputs: name (required), uuid (required), command (required), frequency (required), +3 more.

coolify_create_service_storageB

[WRITE] Add a persistent or file storage mount to a Coolify service sub-resource

Inputs: type (required), uuid (required), mount_path (required), resource_uuid (required), +6 more.

coolify_delete_applicationA

[DESTRUCTIVE] Permanently delete a Coolify application

Inputs: uuid (required), confirm, delete_volumes, docker_cleanup.

coolify_delete_application_previewA

[DESTRUCTIVE] Delete a preview deployment, cancel its deployments, and remove its containers, volumes, and networks.

Inputs: uuid (required), pull_request_id (required), confirm.

coolify_delete_application_scheduled_taskB

[DESTRUCTIVE] Delete a scheduled task from a Coolify application

Inputs: uuid (required), task_uuid (required), confirm.

coolify_delete_application_storageA

[DESTRUCTIVE] Remove a persistent or file storage mount from a Coolify application

Inputs: uuid (required), storage_uuid (required), confirm.

coolify_delete_application_storage_backupB

[DESTRUCTIVE] Delete the backup schedule and archives for an application storage

Inputs: uuid (required), storage_uuid (required), confirm.

coolify_delete_backup_executionC

[DESTRUCTIVE] Delete a specific backup execution record

Inputs: uuid (required), backup_uuid (required), execution_uuid (required), confirm.

coolify_delete_databaseB

[DESTRUCTIVE] Permanently delete a Coolify database

Inputs: uuid (required), confirm, delete_volumes, docker_cleanup.

coolify_delete_database_backupB

[DESTRUCTIVE] Delete a scheduled backup configuration for a Coolify database

Inputs: uuid (required), backup_uuid (required), confirm, delete_s3.

coolify_delete_database_envC

[DESTRUCTIVE] Delete an environment variable from a Coolify database

Inputs: uuid (required), env_uuid (required), confirm.

coolify_delete_database_storageB

[DESTRUCTIVE] Remove a persistent or file storage mount from a Coolify database

Inputs: uuid (required), storage_uuid (required), confirm.

coolify_delete_database_storage_backupB

[DESTRUCTIVE] Delete the backup schedule and archives for a database storage

Inputs: uuid (required), storage_uuid (required), confirm.

coolify_delete_envB

[DESTRUCTIVE] Delete an environment variable from a Coolify application

Inputs: uuid (required), env_uuid (required), confirm.

coolify_delete_environmentC

[DESTRUCTIVE] Delete an environment from a Coolify project. Environment must be empty.

Inputs: project_uuid (required), environment_name_or_uuid (required), confirm.

coolify_delete_github_appB

[DESTRUCTIVE] Delete a GitHub App integration from Coolify

Inputs: id (required), confirm.

coolify_delete_private_keyB

[DESTRUCTIVE] Delete an SSH private key. Blocked if in use by any server or application.

Inputs: uuid (required), confirm.

coolify_delete_projectA

[DESTRUCTIVE] Permanently delete a Coolify project and all its environments

Inputs: uuid (required), confirm.

coolify_delete_serverB

[DESTRUCTIVE] Permanently delete a server and stop all its resources

Inputs: uuid (required), force, confirm, delete_from_provider.

coolify_delete_serviceB

[DESTRUCTIVE] Permanently delete a Coolify service

Inputs: uuid (required), confirm, delete_volumes, docker_cleanup, +1 more.

coolify_delete_service_envB

[DESTRUCTIVE] Delete an environment variable from a Coolify service

Inputs: uuid (required), env_uuid (required), confirm.

coolify_delete_service_scheduled_taskB

[DESTRUCTIVE] Delete a scheduled task from a Coolify service

Inputs: uuid (required), task_uuid (required), confirm.

coolify_delete_service_storageA

[DESTRUCTIVE] Remove a persistent or file storage mount from a Coolify service

Inputs: uuid (required), storage_uuid (required), confirm.

coolify_delete_service_storage_backupA

[DESTRUCTIVE] Delete the backup schedule and archives for a service storage

Inputs: uuid (required), storage_uuid (required), confirm.

coolify_deploy_application_previewA

[WRITE] Open or redeploy the preview of a pull request (Coolify v4.4+; token needs deploy). Git apps take git_type/commit, Docker Image apps take docker_tag.

Inputs: uuid (required), pull_request_id (required), force, commit, +4 more.

coolify_get_applicationB

Get detailed information about a specific Coolify application

Inputs: uuid (required).

coolify_get_application_previewA

Get one preview deployment of an application by pull request number (Coolify v4.4+)

Inputs: uuid (required), pull_request_id (required).

coolify_get_application_preview_logsA

Retrieve runtime container logs for an application preview by pull request number (Coolify v4.3.23), with level/time/text filtering.

Inputs: uuid (required), pull_request_id (required), tail, level, +7 more.

coolify_get_current_teamA

Get the team bound to the API token (GET /team)

Inputs: no named parameters.

coolify_get_current_team_membersA

List members of the team bound to the API token (GET /team/members)

Inputs: no named parameters.

coolify_get_databaseB

Get detailed information about a specific Coolify database

Inputs: uuid (required).

coolify_get_database_importB

Get the status of a standalone database import (Coolify v4.4+). output needs the read:sensitive token ability.

Inputs: uuid (required), activity_id (required).

coolify_get_database_logsC

Retrieve logs for a Coolify database with optional filtering by level, time range, or text search

Inputs: uuid (required), tail, level, limit, +5 more.

coolify_get_deploymentB

Get detailed information about a specific deployment

Inputs: uuid (required).

coolify_get_environmentB

Get detailed information about a specific environment in a project

Inputs: project_uuid (required), environment_name (required).

coolify_get_instance_email_settingsA

Get instance-wide SMTP/Resend settings (Coolify v4.3.23). Requires a root-team admin/owner token; secrets require read:sensitive or root ability.

Inputs: no named parameters.

coolify_get_logsB

Retrieve logs for a Coolify application with optional filtering by level, time range, or text search

Inputs: uuid (required), tail, level, limit, +6 more.

coolify_get_private_keyB

Get detailed information about a specific SSH private key

Inputs: uuid (required).

coolify_get_projectC

Get detailed information about a specific Coolify project

Inputs: uuid (required).

coolify_get_serverB

Get detailed information about a specific Coolify server

Inputs: uuid (required).

coolify_get_server_domainsA

List all domains configured on a server with their resource mappings

Inputs: uuid (required).

coolify_get_server_resourcesB

List all resources (applications, databases, services) deployed on a server

Inputs: uuid (required).

coolify_get_serviceC

Get detailed information about a specific Coolify service

Inputs: uuid (required).

coolify_get_service_database_importA

Get the status of a service database import (Coolify v4.4+). output needs the read:sensitive token ability.

Inputs: uuid (required), activity_id (required), database_uuid (required).

coolify_get_service_logsC

Retrieve logs for a Coolify service with optional filtering by level, time range, or text search

Inputs: uuid (required), tail, level, limit, +5 more.

coolify_get_team_membersA

List members of a specific team by ID (GET /teams/{id}/members)

Inputs: team_id (required).

coolify_get_versionB

Get the Coolify instance version

Inputs: no named parameters.

coolify_healthcheckA

Check if the Coolify instance is healthy and reachable

Inputs: no named parameters.

coolify_import_databaseA

[DESTRUCTIVE] Restore a backup into a standalone database from S3, a server path, or an earlier upload (Coolify v4.4+). Runs in the background; poll coolify_get_database_import. source=server also needs the deploy token ability.

Inputs: uuid (required), source (required), path, confirm, +7 more.

coolify_import_service_databaseA

[DESTRUCTIVE] Restore a backup into a database of a service from S3, a server path, or an earlier upload (Coolify v4.4+). Runs in the background; poll coolify_get_service_database_import. source=server also needs the deploy token ability.

Inputs: uuid (required), source (required), database_uuid (required), path, +8 more.

coolify_list_application_deploymentsA

List deployment history for a specific application (all statuses: finished, failed, queued, in_progress, cancelled). Supports pagination.

Inputs: uuid (required), skip, take.

coolify_list_application_previewsA

List preview deployments of an application (Coolify v4.4+; returns summary: uuid, pull_request_id, status, domains, git_type)

Inputs: uuid (required).

coolify_list_applicationsA

List all applications managed by Coolify (returns summary: uuid, name, status, fqdn)

Inputs: no named parameters.

coolify_list_application_scheduled_task_executionsB

List executions of a scheduled task for a Coolify application

Inputs: uuid (required), task_uuid (required).

coolify_list_application_scheduled_tasksB

List all scheduled tasks for a Coolify application

Inputs: uuid (required).

coolify_list_application_storagesC

List persistent and file storages for a Coolify application

Inputs: uuid (required).

coolify_list_audit_eventsA

List the team audit log, newest first (Coolify v4.4+). Requires a team admin/owner token; actor email, token, metadata, changes, and IP need read:sensitive.

Inputs: page, action, search, source, +1 more.

coolify_list_backup_executionsB

List executions of a database backup schedule

Inputs: uuid (required), backup_uuid (required).

coolify_list_database_backupsB

List backups for a specific database

Inputs: uuid (required).

coolify_list_database_envsB

List all environment variables for a Coolify database

Inputs: uuid (required).

coolify_list_databasesA

List all databases managed by Coolify (returns summary: uuid, name, database_type, status)

Inputs: no named parameters.

coolify_list_database_storagesC

List persistent and file storages for a Coolify database

Inputs: uuid (required).

coolify_list_deploymentsA

List currently running/queued deployments only (returns summary). For deployment history, use coolify_list_application_deployments instead.

Inputs: limit.

coolify_list_environmentsB

List all environments in a Coolify project

Inputs: project_uuid (required).

coolify_list_envsA

List all environment variables for a Coolify application

Inputs: uuid (required).

coolify_list_github_app_branchesC

List branches for a repository accessible by a GitHub App

Inputs: id (required), repo (required), owner (required).

coolify_list_github_app_repositoriesB

List repositories accessible by a GitHub App

Inputs: id (required).

coolify_list_github_appsA

List all GitHub App integrations configured in Coolify

Inputs: no named parameters.

coolify_list_private_keysA

List all SSH private keys (returns summary: uuid, name, description, fingerprint)

Inputs: no named parameters.

coolify_list_projectsA

List all projects in Coolify (returns summary: uuid, name, description)

Inputs: no named parameters.

coolify_list_resourcesA

List all resources (applications, databases, services) across all projects

Inputs: no named parameters.

coolify_list_server_registriesA

List the Docker registries a server is logged in to and the registries its applications need (Coolify v4.4+; token needs read:sensitive)

Inputs: uuid (required).

coolify_list_serversA

List all servers managed by Coolify (returns summary: uuid, name, ip)

Inputs: no named parameters.

coolify_list_service_envsA

List all environment variables for a Coolify service

Inputs: uuid (required).

coolify_list_servicesA

List all services managed by Coolify (returns summary: uuid, name, status, service_type)

Inputs: no named parameters.

coolify_list_service_scheduled_task_executionsC

List executions of a scheduled task for a Coolify service

Inputs: uuid (required), task_uuid (required).

coolify_list_service_scheduled_tasksB

List all scheduled tasks for a Coolify service

Inputs: uuid (required).

coolify_list_service_storagesB

List persistent and file storages for a Coolify service (includes sub-resource UUIDs)

Inputs: uuid (required).

coolify_list_teamsA

List all teams (returns summary: id, name, description)

Inputs: no named parameters.

coolify_login_server_registryA

[WRITE] Log a server in to a Docker registry, or update the login (Coolify v4.4+). Coolify runs docker login on the server and does not store the token.

Inputs: uuid (required), password (required), registry (required), username (required).

coolify_logout_server_registryB

[DESTRUCTIVE] Log a server out of a Docker registry (Coolify v4.4+). Deployments that pull private images from it will fail.

Inputs: uuid (required), registry (required), confirm.

coolify_restart_applicationA

[DESTRUCTIVE] Restart a Coolify application. Causes brief downtime.

Inputs: uuid (required), confirm.

coolify_restart_databaseA

[DESTRUCTIVE] Restart a Coolify database. Causes brief downtime.

Inputs: uuid (required), confirm.

coolify_restart_serviceA

[DESTRUCTIVE] Restart a Coolify service. Causes brief downtime.

Inputs: uuid (required), confirm.

coolify_run_application_storage_backupC

[WRITE] Run an on-demand backup for an application storage

Inputs: uuid (required), storage_uuid (required).

coolify_run_database_storage_backupC

[WRITE] Run an on-demand backup for a database storage

Inputs: uuid (required), storage_uuid (required).

coolify_run_service_storage_backupA

[WRITE] Run an on-demand backup for a service storage

Inputs: uuid (required), storage_uuid (required).

coolify_set_application_storage_backupC

[WRITE] Create or replace a backup schedule for an application persistent volume/directory

Inputs: uuid (required), frequency (required), storage_uuid (required), enabled, +12 more.

coolify_set_database_storage_backupC

[WRITE] Create or replace a backup schedule for a database persistent volume/directory

Inputs: uuid (required), frequency (required), storage_uuid (required), enabled, +12 more.

coolify_set_service_storage_backupC

[WRITE] Create or replace a backup schedule for a service persistent volume/directory

Inputs: uuid (required), frequency (required), storage_uuid (required), enabled, +12 more.

coolify_start_applicationB

[WRITE] Start a stopped Coolify application

Inputs: uuid (required).

coolify_start_databaseA

[WRITE] Start a stopped Coolify database

Inputs: uuid (required).

coolify_start_serviceB

[WRITE] Start a stopped Coolify service

Inputs: uuid (required).

coolify_stop_applicationA

[DESTRUCTIVE] Stop a running Coolify application. Causes downtime.

Inputs: uuid (required), confirm, docker_cleanup.

coolify_stop_databaseA

[DESTRUCTIVE] Stop a running Coolify database. Causes downtime.

Inputs: uuid (required), confirm, docker_cleanup.

coolify_stop_serviceB

[DESTRUCTIVE] Stop a running Coolify service. Causes downtime.

Inputs: uuid (required), confirm, docker_cleanup.

coolify_trigger_deployB

[WRITE] Trigger a new deployment for a resource (application, service, or database)

Inputs: uuid (required), force.

coolify_update_applicationC

[WRITE] Update configuration of a Coolify application

Inputs: uuid (required), fqdn, name, is_static, +14 more.

coolify_update_application_previewA

[WRITE] Replace preview deployment domains (Coolify v4.3.23). Provide domains for a regular app or docker_compose_domains for a Compose app.

Inputs: uuid (required), pull_request_id (required), domains, force_domain_override, +1 more.

coolify_update_application_scheduled_taskB

[WRITE] Update a scheduled task for a Coolify application

Inputs: uuid (required), task_uuid (required), name, command, +4 more.

coolify_update_application_secret_managerA

[WRITE] Link an application to a secret manager so {{vault.KEY}} references resolve on deploy (Coolify v4.4+). settings: Doppler service account needs project+config; Infisical needs project_id+environment; Vault needs mount+path.

Inputs: uuid (required), integration_token_uuid (required), settings.

coolify_update_application_storageB

[WRITE] Update a persistent or file storage for a Coolify application (PATCH body includes storage uuid + type)

Inputs: type (required), uuid (required), storage_uuid (required), name, +4 more.

coolify_update_current_teamA

[WRITE] Update the team bound to the API token (Coolify v4.4+). Sets whether builds fall back to the deployment server when no build server is usable.

Inputs: is_build_server_fallback_enabled (required).

coolify_update_databaseB

[WRITE] Update configuration of a Coolify database

Inputs: uuid (required), name, image, is_public, +5 more.

coolify_update_database_backupC

[WRITE] Update a database backup schedule configuration

Inputs: uuid (required), backup_uuid (required), enabled, save_s3, +13 more.

coolify_update_database_envs_bulkB

[WRITE] Bulk update environment variables for a Coolify database (creates or updates)

Inputs: envs (required), uuid (required).

coolify_update_database_storageB

[WRITE] Update a persistent or file storage for a Coolify database (PATCH body includes storage uuid + type)

Inputs: type (required), uuid (required), storage_uuid (required), name, +4 more.

coolify_update_envs_bulkC

[WRITE] Bulk update environment variables for a Coolify application (creates or updates)

Inputs: envs (required), uuid (required).

coolify_update_github_appC

[WRITE] Update a GitHub App integration in Coolify

Inputs: id (required), name, custom_fields.

coolify_update_instance_email_settingsA

[WRITE] Update instance-wide SMTP/Resend settings (Coolify v4.3.23). Requires a root-team admin/owner token with write:sensitive ability. Null clears a field.

Inputs: smtp_host, smtp_port, smtp_enabled, smtp_timeout, +8 more.

coolify_update_private_keyC

[WRITE] Update an existing SSH private key

Inputs: uuid (required), name, description, private_key.

coolify_update_projectC

[WRITE] Update a Coolify project

Inputs: uuid (required), name, description.

coolify_update_serverC

[WRITE] Update configuration of a Coolify server

Inputs: uuid (required), ip, name, port, +6 more.

coolify_update_serviceC

[WRITE] Update configuration of a Coolify service

Inputs: uuid (required), name, description, custom_fields, +1 more.

coolify_update_service_envs_bulkA

[WRITE] Bulk update environment variables for a Coolify service (creates or updates)

Inputs: envs (required), uuid (required).

coolify_update_service_scheduled_taskC

[WRITE] Update a scheduled task for a Coolify service

Inputs: uuid (required), task_uuid (required), name, command, +4 more.

coolify_update_service_storageB

[WRITE] Update a persistent or file storage for a Coolify service (PATCH body includes storage uuid + type)

Inputs: type (required), uuid (required), storage_uuid (required), name, +4 more.

coolify_validate_serverC

[WRITE] Validate a Coolify server (SSH connectivity and Docker prerequisites). Requires POST on Coolify v4.2+.

Inputs: uuid (required), install.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 136 tools

    Disambiguation3/5

    The resource-prefixed tool families (application/service/database/server) are mostly distinct, but several tools overlap or are inconsistently qualified. For example, coolify_get_logs and coolify_list_envs apply specifically to applications while database/service variants are explicitly named, and backup/storage/import tools across resources can be confused. An agent can usually infer intent, but the volume of parallel triplets creates real misselection risk.

    Naming Consistency4/5

    The overwhelming majority of tools follow a predictable coolify_verb_noun pattern in snake_case, with clear resource qualifiers like coolify_list_application_scheduled_tasks. Minor deviations exist, such as coolify_healthcheck, coolify_get_logs, and coolify_trigger_deploy, which are less structurally consistent than the rest.

    Tool Count2/5

    136 tools is far too many for practical agent selection, even for a broad platform like Coolify. Many operations are repeated across applications, services, and databases in parallel triplets, and consolidation into resource-scoped or parameterized tools would substantially reduce the surface.

    Completeness5/5

    The surface covers lifecycle operations across applications, databases, services, servers, projects, environments, storages, backups, deployments, previews, scheduled tasks, GitHub Apps, registries, teams, private keys, and instance settings. CRUD, start/stop/restart, logs, backup/import, and deployment control are all represented, leaving no obvious dead ends.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers