Coolify MCP Server by StuMason: Setup for Claude, Cursor and Other Apps

• Counts everything in your Coolify

  Returns how many servers, projects, applications, databases and services your Coolify has, as a quick map of the estate.

  Try: “Give me an overview of my infrastructure.”

  Read · get_infrastructure_overview

• Scans your estate for problems

  Looks across all resources for ones that are unhealthy or misconfigured and lists what it found.

  Try: “Find any issues in my infrastructure.”

  Read · find_issues

• Works out why an app is unhealthy

  Takes an app UUID, name or domain and gathers its status, recent deployments and logs to explain what is wrong.

  Try: “Diagnose my shop.example.com app.”

  Read · diagnose_app

• Works out why a server is unhealthy

  Takes a server UUID, name or IP and gathers its status and resources to explain what is wrong.

  Try: “Diagnose the server at 10.0.0.5.”

  Read · diagnose_server

• Lists your applications

  Returns each application as a short summary with its UUID, name and status.

  Try: “List my applications.”

  Read · list_applications

• Shows one application in full

  Returns the full record for one application. Passwords, webhook secrets and compose bodies come back masked unless the call asks for them.

  Try: “Show me the settings for application abc123.”

  Read · get_application

• Lists your databases

  Returns each database as a short summary with its UUID, name and status.

  Try: “Which databases do I have running?”

  Read · list_databases

• Shows one database in full

  Returns the full record for one database. Passwords and connection URLs come back masked unless the call asks for them.

  Try: “Show the details of my Postgres database.”

  Read · get_database

• Lists your services

  Returns each service (a multi-container stack) as a short summary.

  Try: “List my services.”

  Read · list_services

• Shows one service in full

  Returns the full record for one service. Compose bodies and secrets come back masked unless the call asks for them.

  Try: “Show the details of my Plausible service.”

  Read · get_service

• Lists your servers

  Returns the servers Coolify manages, as short summaries.

  Try: “List my servers.”

  Read · list_servers

• Shows one server in full

  Returns the record for one server. Sentinel and log-drain credentials are always masked.

  Try: “Show details for server localhost.”

  Read · get_server

• Lists what runs on a server

  Returns the applications, databases and services placed on one server.

  Try: “What is running on my main server?”

  Read · server_resources

• Lists the domains on a server

  Returns the domains configured for the resources on one server.

  Try: “Which domains are on my main server?”

  Read · server_domains

• Lists Docker networks on a server

  Returns the Docker network destinations. You need one when a server has more than one and you create something new.

  Try: “Which Docker destinations does my server have?”

  Read · list_destinations

• Lists recent deployments

  Returns recent deployments as summaries with their status.

  Try: “Show my recent deployments.”

  Read · list_deployments

• Reads container logs

  Returns log lines from an application, database or service container, with an option to limit lines and show timestamps.

  Try: “Show the last 100 log lines for my API app.”

  Read · logs

• Reads app logs (older tool)

  Returns logs for one application. The docs say the logs tool replaces it and covers databases and services too.

  Try: “Show the logs for my web app.”

  Read · application_logs

• Gives the dashboard link for a resource

  Returns the Coolify dashboard URL for an application, database, service, deployment, server, project, environment or private key.

  Try: “Give me the dashboard link for my API app.”

  Read · coolify_url

• Searches the Coolify docs

  Searches a Coolify documentation index that ships with the server and returns matching pages with titles and links.

  Try: “How do I fix a 502 Bad Gateway error in Coolify?”

  Read · search_docs

• Shows your teams and members

  Lists teams, gets one, and shows the members of a team or of your current team.

  Try: “Who is on my current team?”

  Read · teams

• Shows the Coolify version

  Returns the version of the Coolify instance the server talks to.

  Try: “Which Coolify version am I on?”

  Read · get_version

• Deploys an app and waits for the result

  Deploys by tag or UUID. With wait on, it polls until the deployment ends and returns the end of the log if it failed. It can also redeploy a pull-request preview or roll back to an older image.

  Try: “Deploy application abc123 and wait for it to finish.”

  Write · deploy

• Inspects or cancels a deployment

  Gets a deployment, lists deployments for an app, lists images to roll back to, or cancels a deployment that is running.

  Try: “Cancel the running deployment for my API app.”

  Delete · deployment

• Starts, stops or restarts a resource

  Starts, stops or restarts an application, database or service.

  Try: “Restart my Redis database.”

  Write · control

• Creates, changes, moves or deletes an app

  Manages an application: create, update, move to another environment, delete, or delete a preview deployment. Delete asks you first on clients that support that.

  Try: “Create an application from my GitHub repo.”

  Delete · application

• Creates, changes, moves or deletes a database

  Manages a database. It can create eight database types, change limits or credentials, expose a public port, move or delete one.

  Try: “Create a Postgres database in the production environment.”

  Delete · database

• Manages multi-container services

  Creates, updates, moves or deletes a service, lists the containers inside it, and updates, starts, stops or restarts a single sub-application.

  Try: “List the containers inside my Plausible service.”

  Delete · service

• Manages projects

  Lists, gets, creates, updates or deletes projects.

  Try: “Create a project called Staging.”

  Delete · projects

• Manages environments

  Lists, gets, creates or deletes environments, and can check that an app belongs to a named environment before you change it.

  Try: “Verify app abc123 is in the production environment.”

  Delete · environments

• Manages environment variables

  Lists, creates, updates, deletes or bulk-updates environment variables on an app, service or database. Values show as masked unless you ask for one exact key.

  Try: “Update the DATABASE_URL env var for application abc123.”

  Delete · env_vars

• Manages persistent storage and volume backups

  Lists, creates, changes or deletes storages on an app, database or service. It also sets, deletes or runs a backup schedule for a volume.

  Try: “Add a persistent volume to my app.”

  Delete · storages

• Manages scheduled commands

  Lists, creates, changes or deletes cron-style tasks on an app or service, shows their runs, or runs a command once and returns its output.

  Try: “Run this command once on my app and show the output.”

  Delete · scheduled_tasks

• Manages database backups

  Lists backup schedules and runs, creates, changes or deletes a schedule, and deletes a backup run.

  Try: “Show the backup schedule for my Postgres database.”

  Delete · database_backups

• Tags resources

  Lists tags, attaches them to apps, databases or services, or removes them. A deploy can then target a tag.

  Try: “Tag my three web apps with web.”

  Write · tags

• Manages SSH keys

  Lists, gets, creates, updates or deletes SSH keys. Key material is never returned.

  Try: “List my SSH keys.”

  Delete · private_keys

• Manages GitHub Apps

  Lists, gets, creates, updates or deletes GitHub App connections, and lists their repositories and branches.

  Try: “List the repositories my GitHub App can reach.”

  Delete · github_apps

• Manages cloud provider tokens

  Lists, gets, creates, updates, deletes or validates Hetzner and DigitalOcean tokens.

  Try: “Validate my Hetzner token.”

  Delete · cloud_tokens

• Lists Hetzner options and creates servers

  Lists locations, server types, images and SSH keys, and can create a new Hetzner server with the token you stored.

  Try: “Create a Hetzner server in Falkenstein.”

  Write · hetzner

• Checks a server connection

  Asks Coolify to validate its connection to a server. Running it again converges on the same state.

  Try: “Validate my new server.”

  Write · validate_server

• Checks health and switches the Coolify API

  Reports health, lists all resources, and can enable or disable the Coolify API itself. Disabling it cuts off every other tool.

  Try: “Is my Coolify healthy?”

  Write · system

• Updates one env var across many apps

  Sets one variable on several applications at once. It asks you first when more than three apps are affected.

  Try: “Set LOG_LEVEL=debug on all apps in staging.”

  Write · bulk_env_update

• Restarts every app in a project

  Restarts all the applications in one project, after asking you.

  Try: “Restart all apps in project abc123.”

  Write · restart_project_apps

• Redeploys every app in a project

  Queues a fresh deployment for all applications in a project, after asking you.

  Try: “Redeploy everything in the staging project.”

  Write · redeploy_project

• Stops all running apps

  The emergency stop: stops every running application, after asking you with the number of apps and servers.

  Try: “Emergency stop everything.”

  Write · stop_all_apps

• Used by the assistant behind the scenes

  Shows the MCP server version

  Returns this MCP server version from a local constant, without calling Coolify.

  Try: “Which version of the Coolify MCP server is running?”

  Read · get_mcp_version

Watch out for

• It can delete apps, databases and keys

  Delete actions cover applications, databases, services, projects, environments, storages, backups, SSH keys, GitHub Apps and cloud tokens. Deleting a resource can remove its volumes too, so read the prompt before you approve. github.com

• One call can stop or redeploy everything

  Tools can stop all running apps, redeploy or restart a whole project, change one variable across many apps, and switch the Coolify API off. These ask you first, but only on clients that support that prompt. github.com

• It can run commands on your containers

  The scheduled task tool can run a command once on an app or service and return the output. Treat it as shell access to those containers. github.com

• It can create servers that cost money

  The Hetzner tool can create a new server with a cloud token stored in Coolify. The source marks it as one that spends real money. github.com

• No confirm prompt in some apps, no read-only mode

  Confirmations need a client that supports elicitation. Claude Desktop and claude.ai run these calls without that prompt over stdio. A read-only switch exists only in the HTTP mode. github.com

• It can reveal secrets when asked

  Env var values, database passwords and webhook secrets come back masked, but a call with reveal set returns one exact key in plain text. Your assistant then sees that secret. github.com

• Your Coolify token sits in the client config

  The API token and Coolify URL are environment variables. Use a token with only the access you need, or point to a token file so you can rotate it. github.com

• Log text is wrapped as untrusted data

  Logs come back inside a marked boundary so a poisoned log line reads as data. This lowers the risk and does not remove it. github.com

• It fetches one docs file from coolify.io

  Apart from your Coolify instance, the only outbound request is a documentation index refresh from coolify.io with no credentials. The project states it has no telemetry. github.com

Security advisories