Coolify MCP Server
A Model Context Protocol server that provides integration with the Coolify API. This server enables interaction with Coolify instances through MCP tools.
**Compatibility:** Tested with Coolify version 4.0.0-beta.397
Prerequisites
- Node.js 18 or higher
- Coolify Base URL
- Coolify API token
Features
- Teams management (list, get details, members)
- Server management (create, validate, resources, domains)
- Service lifecycle management (start, stop, restart)
- Application lifecycle management (start, stop, restart, execute commands)
- Deployment tracking
- Private key management
- Version and health checks
Installation
Configuration
The server requires two environment variables:
- `COOLIFY_BASE_URL`: The base URL of your Coolify instance
- `COOLIFY_TOKEN`: Your Coolify API token
Getting an API Token
- Go to your Coolify instance
- Navigate to `Keys & Tokens` / `API tokens`
- Create a new token with the following required permissions: - read (for fetching information) - write (for managing resources) - deploy (for deployment operations)
Usage
In MCP Settings
Add the following to your MCP settings configuration:
Windows Cline users may need the following:
Available Tools
Version & Health
- `get_version`: Get Coolify version information
- `health_check`: Check Coolify API health status
Teams
- `list_teams`: List all teams
- `get_team`: Get details of a specific team
- `get_current_team`: Get current team details
- `get_current_team_members`: Get current team members
Servers
- `list_servers`: List all servers
- `create_server`: Create a new server
- `validate_server`: Validate server configuration
- `get_server_resources`: Get server resource usage
- `get_server_domains`: Get server domains
Services
- `list_services`: List all services
- `create_service`: Create a new service
- `start_service`: Start a service
- `stop_service`: Stop a service
- `restart_service`: Restart a service
Applications
- `list_applications`: List all applications
- `create_application`: Create a new application
- `start_application`: Start an application
- `stop_application`: Stop an application
- `restart_application`: Restart an application
- `execute_command_application`: Execute command in application container
Deployments
- `list_deployments`: List all deployments
- `get_deployment`: Get deployment details
Private Keys
- `list_private_keys`: List all private keys
- `create_private_key`: Create a new private key
License
MIT