Enables deployment of BookStack documentation platform instances through Coolify templates, with support for MySQL and PostgreSQL databases.
Supports deployment of Docker-based applications and Docker images through Coolify's application management tools.
Allows creation and deployment of applications from Git repositories, with support for branch specification and automated deployments.
Enables deployment of applications from GitHub repositories through Coolify's Git integration capabilities.
Provides template-based deployment of GitLab instances with PostgreSQL and Redis services through Coolify.
Supports deployment of applications requiring MongoDB as a service, such as Rocket.Chat instances through Coolify templates.
Enables deployment of applications with MySQL database services through Coolify's template system, including Strapi and BookStack.
Allows deployment of n8n workflow automation instances through Coolify templates, with PostgreSQL and Redis support.
Provides template-based deployment of Plausible Analytics instances with PostgreSQL database configuration through Coolify.
Supports deployment of applications with PostgreSQL database services through Coolify's template system, including multiple pre-configured application templates.
Enables deployment of applications requiring Redis as a service through Coolify templates, including n8n, GitLab, and Saleor.
Allows deployment of Strapi headless CMS instances from Git repositories through Coolify templates, with PostgreSQL or MySQL database support.
Coolify MCP Server
A Model Context Protocol (MCP) server that exposes Coolify API functionality as safe, structured tools for AI agents. This enables AI-driven app marketplaces where users can deploy applications on Coolify with a single click.
🚀 Features
Project Management: List, create, and manage Coolify projects
Application Lifecycle: Create, update, delete, and manage applications
Deployment Control: Deploy applications and monitor their status
Template Marketplace: Pre-configured templates for popular applications
Safety Guardrails: Quota checking, name conflict detection, and resource limits
Comprehensive Logging: Full audit trail of all AI operations
📋 Prerequisites
Node.js 18+
A running Coolify instance
Coolify API token with appropriate permissions
Docker (for running the MCP server)
🛠️ Installation
Option 1: Clone and Build
Option 2: Docker (Recommended)
⚙️ Configuration
Create a .env file based on .env.example:
Getting Your Coolify API Token
Log into your Coolify instance
Go to Settings → API Tokens
Create a new token with permissions for:
Projects: Read/Write
Applications: Read/Write/Delete
Deployments: Read/Write
🏃 Running the Server
Development
Production
Docker
🔧 MCP Client Configuration
Add to your MCP client configuration:
📚 Available Tools
Projects
coolify.list_projects- List all projectscoolify.create_project- Create a new project
Applications
coolify.list_apps- List applications in a projectcoolify.get_app- Get application detailscoolify.create_app- Create a new applicationcoolify.update_app- Update an applicationcoolify.delete_app- Delete an application
Deployments
coolify.deploy_app- Deploy an applicationcoolify.get_deployment_status- Check deployment statuscoolify.get_deployment_logs- Get deployment logs
Templates
coolify.deploy_template- Deploy from a pre-configured templatecoolify.list_templates- List available templates
Safety
coolify.check_quota- Check project quotacoolify.check_name_conflicts- Check if application name is available
🎯 Quick Start Examples
Deploy Plausible Analytics
Deploy Custom Application
📦 Available Templates
Template | Description | Type | Services |
plausible | Privacy-friendly analytics | Docker Image | PostgreSQL |
strapi | Headless CMS | Git | PostgreSQL, MySQL |
saleor | E-commerce platform | Docker Image | PostgreSQL, Redis |
n8n | Workflow automation | Docker Image | PostgreSQL, Redis |
uptime-kuma | Monitoring tool | Docker Image | - |
gitlab | Git repository manager | Docker Image | PostgreSQL, Redis |
rocketchat | Communication platform | Docker Image | MongoDB |
bookstack | Documentation platform | Docker Image | MySQL, PostgreSQL |
See examples/tool-calls.md for detailed examples.
🔒 Security
API tokens are stored server-side and never exposed to AI agents
All inputs are validated with strict schemas
Project-level isolation prevents cross-project access
Built-in quota and rate limiting
Comprehensive audit logging
See docs/SECURITY.md for detailed security considerations.
📝 API Reference
The MCP server exposes the following endpoints through the Model Context Protocol:
Response Format
All responses follow this structure:
Or for errors:
Error Codes
UNAUTHORIZED- Invalid API tokenFORBIDDEN- Insufficient permissionsNOT_FOUND- Resource doesn't existCONFLICT- Resource conflict (e.g., duplicate name)VALIDATION_ERROR- Invalid input dataRATE_LIMIT- Too many requestsQUOTA_EXCEEDED- Project quota exceededNETWORK_ERROR- Failed to connect to CoolifyUNKNOWN_ERROR- Unexpected error
🤝 Contributing
Fork the repository
Create a feature branch:
git checkout -b feature/amazing-featureCommit your changes:
git commit -m 'Add amazing feature'Push to the branch:
git push origin feature/amazing-featureOpen a Pull Request
Development Setup
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🆘 Support
🙏 Acknowledgments
Coolify - The amazing self-hosting platform
Model Context Protocol - The protocol that makes this possible
All contributors and users of this project
Built with ❤️ by the community