Coolify MCP
Manage Coolify deployments and API operations from your agent when you self-host apps on your own Coolify panel.
Overview
Coolify MCP is a MCP server for the Operate phase that exposes Coolify API operations to AI assistants for self-hosted deployment management.
What is this MCP server?
- npm package @fndchagas/coolify-mcp (v0.1.4) with stdio transport
- Requires COOLIFY_BASE_URL and secret COOLIFY_TOKEN
- COOLIFY_ALLOW_WRITE defaults true—toggle for read-only safety
- COOLIFY_STRICT_VERSION and optional COOLIFY_OPENAPI_REF for API alignment
- OpenAPI-driven Coolify API operations from the coding agent
- Package version 0.1.4
- npm identifier @fndchagas/coolify-mcp
- 5 documented environment variables (2 required)
What problem does it solve?
Self-hosting on Coolify still means repetitive panel and API chores that break flow when you are trying to ship fixes from the agent.
Who is it for?
Indie builders on Coolify who want agent-driven deploy and service ops from Claude Code or Cursor.
Skip if: Teams on Vercel-only or fully managed PaaS with no Coolify instance, or production panels where write MCP is banned.
What do I get? / Deliverables
With base URL and API token set, your agent can run Coolify MCP tools to inspect or manage hosting resources per your write permissions.
- Agent-invokable Coolify API operations via MCP
- Configurable read/write posture with COOLIFY_ALLOW_WRITE
- Version-aware API calls with optional strict mode
Recommended MCP Servers
Journey fit
Coolify MCP is shelved under Operate because it controls live hosting infrastructure after you chose self-managed deploy over purely local dev. Infra fits PaaS-style server, app, and environment operations exposed through Coolify’s API rather than application feature coding.
How it compares
Coolify control-plane MCP, not a generic Docker tutorial skill or cloud cost optimizer.
Common Questions / FAQ
Who is Coolify MCP for?
Solo builders and small teams self-hosting with Coolify who want MCP-backed API operations from their coding agent.
When should I use Coolify MCP?
Use it in operate/infra when redeploying services, auditing Coolify resources, or automating panel tasks during incident or release work.
How do I add Coolify MCP to my agent?
Install @fndchagas/coolify-mcp, configure stdio MCP in your agent, set COOLIFY_BASE_URL and COOLIFY_TOKEN, and adjust COOLIFY_ALLOW_WRITE and COOLIFY_STRICT_VERSION as needed.