coolify-mcp

Appearance

coolify-mcpA Coolify control surface for your AI assistant

42 token-optimized MCP tools. Use it with Claude, Cursor, or any MCP client to manage your self-hosted infrastructure through natural language.

Get started →
Quickstart
GitHub
coolify-mcp
⚡

Ready-to-use MCP server

Set one environment variable and start. Works in Claude Desktop, Claude Code, Cursor, and any other MCP-aware client.

🎯

42 consolidated tools

v2.0 collapsed 60+ tools into a small set of action-driven tools. The count is at 42 today after new tool families landed in v2.11. LLM tool-list tokens dropped ~85% (43k → 6.6k).

🔒

Secure by default

env_vars list responses mask secrets. Opt-in reveal. Bulk-update doesn't echo values back. Token never leaves your machine.

🩺

Smart diagnostics

Tools like diagnose_app and find_issues combine multiple endpoints into one call. The LLM can answer "why is this broken?" without making 5 separate tool calls.

🚀

Tested against a live server

Every release is verified against a production Coolify. Known quirks in the Coolify API are documented in the repo so contributors do not need to rediscover them.

🛣️

Public v3 roadmap

Resources, Tasks, Prompts, and a streamable HTTP transport. The next major version reframes coolify-mcp as a live, subscribable surface. RFCs are published here first.

Install in 60 seconds ​

For Claude Desktop, Claude Code, Cursor, or any MCP-aware client, add this to your MCP config:

json
{
  "mcpServers": {
    "coolify": {
      "command": "npx",
      "args": ["-y", "@masonator/coolify-mcp"],
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify.example.com",
        "COOLIFY_ACCESS_TOKEN": "your-api-token"
      }
    }
  }
}

Restart the client. Ask your assistant: "What's the Coolify version?" It should reply with your instance's version string.

See Installation for per-client details, Quickstart for things to try.

What you can do with it ​

What's coming in v3 ​

Three new MCP primitives that reshape the experience:

  • Resources — subscribe to coolify://applications/{uuid} and get pushed updates on status change
  • Tasks — deploy returns immediately with a task ID; client polls or streams progress instead of blocking for minutes
  • Prompts — /diagnose-app, /cleanup-stale-previews, /promote-staging-to-prod as single-command shortcuts
  • Streamable HTTP transport — host coolify-mcp alongside Coolify itself. Each instance is a single URL.

Read the v3 vision →

License & contributing ​

MIT licensed, open contribution. The contributing guide explains how to add a tool from scratch: types → client → MCP layer → tests → CHANGELOG.