coolify-mcp
Allows management of Docker-based applications and services on a Coolify instance, including creation from Dockerfiles or images, starting, stopping, and restarting.
Provides tools for managing MariaDB databases on a Coolify instance, including creation, backup, and lifecycle operations.
Provides tools for managing MongoDB databases on a Coolify instance, including creation, backup, and lifecycle operations.
Provides tools for managing MySQL databases on a Coolify instance, including creation, backup, and lifecycle operations.
Provides tools for managing PostgreSQL databases on a Coolify instance, including creation, backup, and lifecycle operations.
Provides tools for managing Redis databases on a Coolify instance, including creation, backup, and lifecycle operations.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@coolify-mcp list all applications"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-coolifyCodex
codex mcp add coolify \
--env COOLIFY_API_URL=http://your-server:8000/api/v1 \
--env COOLIFY_TOKEN=your-token \
-- npx mcp-coolifyOther MCP clients
COOLIFY_API_URL=http://your-server:8000/api/v1 \
COOLIFY_TOKEN=your-token \
npx mcp-coolifyFrom source
git clone https://github.com/0xtlt/coolify-mcp
cd coolify-mcp && pnpm install
COOLIFY_API_URL=... COOLIFY_TOKEN=... pnpm startClaude 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 |
| List and get tools |
| All log tools, |
| [WRITE] and [DESTRUCTIVE] tools |
| Deploy, start, stop and restart tools, |
Related MCP server: Coolify MCP Server
Available Tools
Applications (8)
Tool | Description |
| List all applications (summary) |
| Get application details |
| [WRITE] Create from public/private repo, Dockerfile, or Docker image |
| [WRITE] Update application config |
| [WRITE] Start a stopped application |
| [DESTRUCTIVE] Stop an application |
| [DESTRUCTIVE] Restart an 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 |
| List previews of an application (summary) |
| Get one preview with its domains and status |
| [WRITE] Open or redeploy the preview of a pull request ( |
| Read preview runtime logs with the same filters as application logs |
| [WRITE] Replace preview domains using |
| [DESTRUCTIVE] Remove the preview, its containers, volumes, and networks |
Databases (11)
Tool | Description |
| List all databases (summary) |
| Get database details |
| [WRITE] Create PostgreSQL, MySQL, MariaDB, MongoDB, Redis, KeyDB, Dragonfly, ClickHouse, or SQLite (v4.4+) |
| [WRITE] Update database config |
| List backups for a database |
| [WRITE] Create a backup schedule ( |
| [DESTRUCTIVE] Delete a scheduled backup config |
| [WRITE] Start a stopped database |
| [DESTRUCTIVE] Stop a database |
| [DESTRUCTIVE] Restart a database |
| [DESTRUCTIVE] Delete a database |
Backup Schedule Updates & Executions (3)
Tool | Description |
| [WRITE] Update schedule, retention, S3 and missing-backup alerts |
| List execution history for a database backup schedule |
| [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 |
| [DESTRUCTIVE] Restore a backup into a standalone database |
| Get the status of a standalone database import |
| [DESTRUCTIVE] Restore a backup into a database of a service |
| Get the status of a service database import |
Services (8)
Tool | Description |
| List all services (summary) |
| Get service details |
| [WRITE] Create a one-click Docker Compose service |
| [WRITE] Update service config |
| [WRITE] Start a stopped service |
| [DESTRUCTIVE] Stop a service |
| [DESTRUCTIVE] Restart a service |
| [DESTRUCTIVE] Delete a service |
Servers (8)
Tool | Description |
| List all servers (summary) |
| Get server details |
| [WRITE] Add a new server (requires SSH key) |
| [WRITE] Update server config |
| [WRITE] Validate SSH connectivity and Docker (POST) |
| List all resources on a server |
| List all domains on a server |
| [DESTRUCTIVE] Delete a server ( |
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 |
| List registries a server is logged in to and the ones its applications need |
| [WRITE] Log in to a registry or update the login |
| [WRITE] Check that a stored login still works |
| [DESTRUCTIVE] Log out of a registry |
Private Keys (5)
Tool | Description |
| List all SSH private keys (summary) |
| Get private key details |
| [WRITE] Create a new SSH key |
| [WRITE] Update an SSH key |
| [DESTRUCTIVE] Delete an SSH key |
Projects & Environments (9)
Tool | Description |
| List all projects (summary) |
| Get project details |
| [WRITE] Create a new project |
| [WRITE] Update a project |
| [DESTRUCTIVE] Delete a project |
| List environments in a project |
| Get environment details |
| [WRITE] Create an environment |
| [DESTRUCTIVE] Delete an environment |
Deployments (5)
Tool | Description |
| List currently running/queued deployments |
| List deployment history for an application (with pagination) |
| Get deployment details |
| [WRITE] Trigger a deployment (POST |
| [WRITE] Cancel a running deployment |
Application Env Vars (4)
Tool | Description |
| List env vars for an application |
| [WRITE] Create an env var |
| [WRITE] Bulk update env vars |
| [DESTRUCTIVE] Delete an env var |
Service Env Vars (4)
Tool | Description |
| List env vars for a service |
| [WRITE] Create a service env var |
| [WRITE] Bulk update service env vars |
| [DESTRUCTIVE] Delete a service env var |
Database Env Vars (4)
Tool | Description |
| List env vars for a database |
| [WRITE] Create a database env var |
| [WRITE] Bulk update database env vars |
| [DESTRUCTIVE] Delete a database env var |
Storages (12)
Tool | Description |
| List application persistent + file storages |
| [WRITE] Create storage ( |
| [WRITE] Update storage (body: uuid + type) |
| [DESTRUCTIVE] Delete application storage |
| List database storages |
| [WRITE] Create database storage |
| [WRITE] Update database storage |
| [DESTRUCTIVE] Delete database storage |
| List service storages |
| [WRITE] Create service storage ( |
| [WRITE] Update service storage |
| [DESTRUCTIVE] Delete service storage |
Volume Backups (9)
Tool | Description |
| [WRITE] Create/replace application volume backup schedule |
| [WRITE] Run on-demand application volume backup |
| [DESTRUCTIVE] Delete application volume backup schedule |
| [WRITE] Create/replace database volume backup schedule |
| [WRITE] Run on-demand database volume backup |
| [DESTRUCTIVE] Delete database volume backup schedule |
| [WRITE] Create/replace service volume backup schedule |
| [WRITE] Run on-demand service volume backup |
| [DESTRUCTIVE] Delete service volume backup schedule |
Scheduled Tasks (10)
Tool | Description |
| List application tasks |
| [WRITE] Create an application task |
| [WRITE] Update an application task |
| [DESTRUCTIVE] Delete an application task |
| List application task executions |
| List service tasks |
| [WRITE] Create a service task |
| [WRITE] Update a service task |
| [DESTRUCTIVE] Delete a service task |
| List service task executions |
GitHub Apps (6)
Tool | Description |
| List GitHub integrations |
| [WRITE] Create an integration |
| [WRITE] Update an integration |
| [DESTRUCTIVE] Delete an integration |
| List accessible repositories |
| List repository branches |
Logs (3)
Tool | Description |
| Get application logs with filtering |
| Get database logs with filtering |
| Get service logs with filtering |
System (3)
Tool | Description |
| Get Coolify instance version |
| Check if Coolify is healthy |
| List resources across projects |
Audit Log (1)
Coolify v4.4+. Requires a team admin/owner API token.
Tool | Description |
| List UI, API, MCP and webhook activity, newest first ( |
Secret Managers (2)
Coolify v4.4+. After linking, reference secrets in environment variables as {{vault.KEY}}.
Tool | Description |
| [WRITE] Store a Doppler, Infisical, or HashiCorp Vault token for the team |
| [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 |
| Read instance-wide SMTP and Resend settings |
| [WRITE] Update SMTP/Resend settings; |
Teams (5)
Tool | Description |
| List all teams |
| Get token team ( |
| [WRITE] Set the build server fallback of the token team (v4.4+) |
| List token team members ( |
| List members of a team by ID |
Available Resources
URI | Description |
| List of all applications |
| List of all databases |
| List of all services |
| List of all servers |
| List of all deployments |
| List of all projects |
| List of all SSH private keys |
Available Prompts
Prompt | Description |
| Step-by-step guide to debug a failed deployment |
| Get a complete overview of all infrastructure |
| Guided workflow to deploy an application |
| Guided workflow to create and configure a new app |
Safety Modes
Variable | Description |
| Only read operations available (list, get, logs) |
| Destructive operations require |
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 rangesearch: Case-insensitive text searchlines: Server lines to fetch (defaults tolimit, up to 10000;"all"or-1fetches all)show_timestamps: Include server timestamps (default true)limit: Max filtered entries returned (default 100, max 1000)tail: Get most recent logsservice_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:sensitiveon Coolify v4.4+. A token with onlyreadgets403from every log tool. Create a new token withread:sensitive, orroot.instant_deployon application, database and service creation, and on application updates, needs thedeployability on Coolify v4.4+.Servers have a
server_role(deployment,build,both).is_build_serverstill works but is deprecated; sending both with different meanings fails before the request.Scheduled task
timeoutis limited to 1-36000 seconds, as Coolify v4.4 validates it.Database start and restart answer
409while another start, restart or import runs.The multipart upload endpoint for imports (
POST .../imports/uploads, up to 10 GiB) is not wrapped. Usesource: "s3"orsource: "server", or upload the file yourself and pass itsupload_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 namedtype: "persistent"volume, or createtype: "file"withfs_pathand eitheris_directory: trueoris_host_file: true. Existing mount sources cannot be changed through the update endpoint.coolify_create_database_backupnow requiresfrequencyand creates a schedule; setbackup_now: trueto also execute it immediately. The result includes the schedule UUID. Create/update support retention, S3 (s3_storage_uuid), timeout, andmissing_backup_notification_days(0 disables alerts). The unsupported update fieldss3_storage_idanddatabase_name_prefixhave been removed.Preview-domain updates replace the entire domain configuration. Supply exactly one of
domains(regular app;nullclears it) ordocker_compose_domains(Compose app;[]clears it).
Environment Variables
Variable | Required | Description |
| Yes | Coolify API URL (e.g. |
| Yes | Bearer token from Coolify dashboard |
| No | Request timeout in ms (default: 30000) |
| No | Read-only mode (default: false) |
| No | Require confirmation for destructive ops (default: false) |
| 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 onlyLicense
MIT
Available Tools
136 toolscoolify_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
Scored across 136 tools
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.
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.
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.
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
Related MCP Connectors
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
MCP server for interacting with the Supabase platform
Devopness MCP server for DevOps happiness! Empower AI Agents to deploy apps and infra, to any cloud.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI assistants to manage infrastructure, applications, databases, and services through the Coolify PaaS platform.14 npm4MIT
- AlicenseBqualityDmaintenanceMCP server that integrates with Coolify to let AI assistants manage Coolify instances via a clean toolkit wrapping the official REST API.35370 npm7MIT
- AlicenseNot gradedqualityFmaintenanceMCP server for Coolify infrastructure management, providing 45 tools for servers, applications, databases, deployments, and diagnostics via natural language.17 npmMIT
- FlicenseBqualityDmaintenanceA unified MCP server for managing hosting fleets, enabling natural language control over SSH, WordPress, Cloudflare, MySQL, GitHub, Docker, Coolify, and more.381-