mcp -coolify

This MCP server provides a comprehensive integration with your Coolify PaaS, exposing a wide range of capabilities to manage infrastructure, applications, databases, services, environments, and deployments from a unified API. Once running, you can leverage pre-configured MCP commands to list, create, update, and delete resources such as teams, projects, servers, applications, databases, services, and environment variables. The server also supports lifecycle operations (start, stop, restart), command execution inside containers, health checks, and deployment triggers via webhooks. To get started, ensure your Coolify instance is reachable and your API token has read, write, and deploy permissions, then add the Coolify MCP server to your MCP settings with the provided environment variables for authentication and base URL. Typical usage includes listing projects, creating servers, deploying apps, and retrieving deployment logs through the corresponding MCP commands, all while handling differing Coolify versions gracefully.

Prerequisites:

• Node.js 18+ installed on the host
• Access to a Coolify instance (base URL and API token)

Install and run the MCP server:

1. Install globally (alternative to using npx): npm install -g @pashvc/mcp-server-coolify

2. Run with npx (recommended): npx -y @pashvc/mcp-server-coolify

3. Set up environment variables for Coolify:

   • COOLIFY_BASE_URL: https://your-coolify-instance
   • COOLIFY_TOKEN: your-api-token

4. Configure MCP settings in your environment to include the Coolify MCP server: Ensure mcpServers.coolify is defined with command: npx and args: [-y, @pashvc/mcp-server-coolify], and include the COOLIFY_BASE_URL and COOLIFY_TOKEN env vars.

5. (Optional) Windows users can specify an alternative command path in MCP settings if needed:

   • command: cmd
   • args: ["/c", "npx", "-y", "@pashvc/mcp-server-coolify"]
   • same env vars as above

6. Validate installation by starting the MCP server and invoking available tools via MCP Inspector or your MCP client.

Notes and tips:

• The server is designed to handle multiple Coolify versions; some endpoints may differ between versions. The MCP integration automatically adjusts response formats accordingly.
• Ensure your COOLIFY_BASE_URL uses the correct protocol (http/https) and is reachable from the MCP host.
• Tokens must have read, write, and deploy permissions for full functionality.
• If you encounter authentication or 404 issues, verify the token scope and that the Coolify instance is reachable at the provided base URL.
• In MCP settings, you can enable Windows-style command execution fallbacks, but using the standard npx configuration is recommended for simplicity.
• The repository includes a rich set of pre-configured prompts and tools; explore items like deploying apps, managing environments, and running health checks via the available commands.