home / mcp / coolify mcp server

Coolify MCP Server

MCP server for Coolify — 38 optimized tools for managing self-hosted PaaS through AI assistants

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "stumason-coolify-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@masonator/coolify-mcp"
      ],
      "env": {
        "COOLIFY_BASE_URL": "https://your-coolify-instance.com",
        "COOLIFY_ACCESS_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

You are equipped with a Model Context Protocol (MCP) server that enables AI assistants to manage and debug your Coolify instances through natural language. It provides a focused set of tools for infrastructure visibility, diagnostics, deployment actions, and batch operations, all optimized to minimize token usage while delivering practical control over your self-hosted PaaS.

How to use

You interact with the MCP server through an MCP client. Start by connecting to the Coolify MCP server, then issue natural language prompts or structured tool calls to perform actions such as listing resources, diagnosing issues, restarting apps, updating environment variables, deploying changes, and retrieving logs. The server returns context-optimized responses that summarize results and offer guided next steps without overwhelming you with raw data.

How to install

Prerequisites: ensure you have Node.js version 18 or higher installed on your machine. You should also have a running Coolify instance and a Coolify API access token.

Install the MCP client package and run it using the provided configuration. Use the following as your starting point.

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

Configuration and usage notes

The MCP server exposes a comprehensive set of tools designed to help you manage Coolify resources. These tools include infrastructure overview, diagnostics, batch operations, server and project management, application and database actions, deployments, keys, GitHub apps, teams, cloud tokens, and documentation search.

Environment variables shown in the examples must be provided to properly authenticate and target your Coolify instance. The key variables are COOLIFY_ACCESS_TOKEN for authentication and COOLIFY_BASE_URL for the base API URL. If you are using a local setup, you can default the base URL to http://localhost:3000.

Security and best practices

Keep your API token secret and rotate it periodically. Do not expose credentials in logs or shared prompts. Use read-only prompts for diagnostics when possible and reserve write actions for deployments, updates, or destructive operations with explicit confirmation.

Limit access to the MCP client to trusted users or AI assistants, and consider applying network restrictions to the Coolify API endpoint to reduce exposure.

Troubleshooting quick tips

Verify token
Check base URL
Review network connectivity

Available tools

get_infrastructure_overview

Return a high-level summary of all resources in your Coolify setup, including servers, projects, applications, databases, and services.

get_mcp_version

Query the MCP server version to verify the installed MCP tooling.

get_version

Query the Coolify API version.

diagnose_app

Provide comprehensive diagnostics for an application by UUID, name, or domain.

diagnose_server

Provide diagnostics for a server by UUID, name, or IP address.

find_issues

Scan the entire infrastructure for unhealthy resources and connectivity issues.

restart_project_apps

Restart all applications within a specified project.

bulk_env_update

Update or create environment variables across multiple applications with upsert behavior.

stop_all_apps

Emergency stop of all running applications (requires confirmation).

redeploy_project

Redeploy all applications in a project, with optional force rebuild.

list_servers

List all configured servers with a summary view.

get_server

Get detailed information about a specific server.

server_resources

View resources running on a given server.

server_domains

List domains configured on a server.

validate_server

Validate the connection and configuration of a server.

projects

Manage projects via actions: list, get, create, update, delete.

environments

Manage environments via actions: list, get, create, delete.

list_applications

List all applications with a summary view.

get_application

Get detailed information about a specific application.

application_logs

Retrieve logs for a specific application.

application

Create, update, or delete applications with various create options including public, GitHub, keys, Docker images, and deployments.

env_vars

Manage environment variables for applications or services.

control

Control resources by action: start, stop, restart for applications, databases, and services.

list_databases

List all databases with summary information.

get_database

Get detailed information about a database.

database

Create or delete databases of types such as postgresql, mysql, mariadb, mongodb, and more.

database_backups

Manage backup schedules and view executions for databases.

list_services

List all services with a summary view.

get_service

Get detailed information about a service.

service

Create, update, or delete services.

github_apps

Manage GitHub App integrations.

teams

Manage teams and access control.

cloud_tokens

Manage cloud provider tokens, with actions to list, get, create, update, delete, or validate.

private_keys

Manage SSH private keys.

deployment

Manage deployments including get, cancel, and list for an app.

deploy

Deploy an application by tag or UUID.

list_deployments

List running deployments for an application.

search_docs

Full-text search across Coolify documentation.

restart_project_apps

Restart all applications within a project.

environment

Manage environment variables across multiple resources.