Skip to main content
Glama
clezcoding

awesome-coolify-mcp

by clezcoding
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

deployment

List, inspect, cancel, watch, and roll back application releases on Coolify, with logs and preflight checks.

Instructions

List per-app deployments, get deployment details, or cancel an in-flight deployment. Actions: list(application_uuid, format?, page?, per_page?) · get(deployment_uuid, format?, projection?, reveal?) · cancel(deployment_uuid, format?, max_chars?) · watch(deployment_uuid, timeout?, min_interval?, max_interval?, include_logs?, format?, max_chars?, instance?) · logs(deployment_uuid|application_uuid, lines?, offset?, include_hidden?, type?, format?, max_chars?, instance?) · preflight(uuid|name|fqdn, format?, max_chars?, instance?) · rollback(uuid|name|fqdn, confirm?, force?, wait?, timeout?, format?, max_chars?, instance?) Safety: confirm for destructive ops · preflight is advisory read-only · rollback requires confirm:true · optional instance · reveal opt-in only

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
fqdnNoApplication FQDN for preflight/rollback
nameNoApplication name for preflight/rollback
pageNoPage number for pagination
typeNoFilter build-logs entries by type (default all — no filter). Applies only to the deployment_uuid (build-logs) path; ignored on runtime logs path.
uuidNoApplication UUID for preflight/rollback
waitNoPoll rollback deployment until terminal (rollback)
forceNoForce deploy on rollback (default false)
linesNoNumber of log lines to retrieve
actionYesThe action to run
formatNoOutput format style
offsetNoSkip first K lines of the FLATTENED log blob before applying lines (build-logs pagination applied AFTER parse+filter+flatten)
revealNoReveal sensitive/masked values in full projection (default false — secrets masked as ***)
confirmNoRequired true for rollback mutations
timeoutNoWatch timeout in seconds (default 300)
instanceNoCoolify instance name from registry (optional — uses env credentials or registry default)
per_pageNoItems per page
max_charsNoMaximum characters in text response before truncation
projectionNoDetail projection depth
include_fullNoAlias for projection: full
include_logsNoAttach capped build logs on success (default false)
max_intervalNoMaximum poll interval in seconds (default 30)
min_intervalNoMinimum poll interval in seconds (default 3)
include_hiddenNoInclude entries with hidden:true in build-logs output (default false — hidden entries are filtered out)
deployment_uuidNoDeployment UUID
application_uuidNoApplication UUID to list deployments for

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
okYes
dataNo
_metaNo
errorNo
_size_warningNo
_formattedTextNo

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Changed11 schema fields changedv1.1.4
    • changedInput schema / properties / action / enum
      Previous value: -[
-  "list",
-  "get",
-  "cancel",
-  "watch"
-]New value: +[
+  "list",
+  "get",
+  "cancel",
+  "watch",
+  "logs",
+  "preflight",
+  "rollback"
+]
    • addedInput schema / properties / confirm
      Added value: +{
+  "description": "Required true for rollback mutations",
+  "type": "boolean"
+}
    • addedInput schema / properties / force
      Added value: +{
+  "description": "Force deploy on rollback (default false)",
+  "type": "boolean"
+}
    • addedInput schema / properties / fqdn
      Added value: +{
+  "description": "Application FQDN for preflight/rollback",
+  "type": "string"
+}
    • addedInput schema / properties / include_hidden
      Added value: +{
+  "description": "Include entries with hidden:true in build-logs output (default false — hidden entries are filtered out)",
+  "type": "boolean"
+}
    • addedInput schema / properties / lines
      Added value: +{
+  "description": "Number of log lines to retrieve",
+  "maximum": 1000,
+  "minimum": 1,
+  "type": "integer"
+}
    • addedInput schema / properties / name
      Added value: +{
+  "description": "Application name for preflight/rollback",
+  "type": "string"
+}
    • addedInput schema / properties / offset
      Added value: +{
+  "default": 0,
+  "description": "Skip first K lines of the FLATTENED log blob before applying lines (build-logs pagination applied AFTER parse+filter+flatten)",
+  "maximum": 9007199254740991,
+  "minimum": 0,
+  "type": "integer"
+}
    • addedInput schema / properties / type
      Added value: +{
+  "description": "Filter build-logs entries by type (default all — no filter). Applies only to the deployment_uuid (build-logs) path; ignored on runtime logs path.",
+  "enum": [
+    "stdout",
+    "stderr",
+    "all"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / uuid
      Added value: +{
+  "description": "Application UUID for preflight/rollback",
+  "type": "string"
+}
    • addedInput schema / properties / wait
      Added value: +{
+  "description": "Poll rollback deployment until terminal (rollback)",
+  "type": "boolean"
+}
  2. Changed5 schema fields changedv1.0.0
    • addedInput schema / additionalProperties
      Added value: +false
    • removedInput schema / oneOf
      Removed value: -[
-  {
-    "properties": {
-      "action": {
-        "const": "list",
-        "type": "string"
-      },
-      "application_uuid": {
-        "description": "Application UUID to list deployments for",
-        "type": "string"
-      },
-      "format": {
-        "default": "pretty",
-        "description": "Output format style",
-        "enum": [
-          "pretty",
-          "json",
-          "table"
-        ],
-        "type": "string"
-      },
-      "include_full": {
-        "description": "Alias for projection: full",
-        "type": "boolean"
-      },
-      "max_chars": {
-        "default": 16000,
-        "description": "Maximum characters in text response before truncation",
-        "maximum": 100000,
-        "minimum": 1000,
-        "type": "integer"
-      },
-      "page": {
-        "default": 1,
-        "description": "Page number for pagination",
-        "maximum": 9007199254740991,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "per_page": {
-        "default": 10,
-        "description": "Items per page (default 10, max 50)",
-        "maximum": 50,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "projection": {
-        "default": "summary",
-        "description": "Detail projection depth",
-        "enum": [
-          "summary",
-          "full"
-        ],
-        "type": "string"
-      },
-      "reveal": {
-        "default": false,
-        "description": "Reveal sensitive/masked values in full projection (default false — secrets masked as ***)",
-        "type": "boolean"
-      }
-    },
-    "required": [
-      "action",
-      "application_uuid"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "action": {
-        "const": "get",
-        "type": "string"
-      },
-      "deployment_uuid": {
-        "description": "Deployment UUID",
-        "type": "string"
-      },
-      "format": {
-        "default": "pretty",
-        "description": "Output format style",
-        "enum": [
-          "pretty",
-          "json",
-          "table"
-        ],
-        "type": "string"
-      },
-      "include_full": {
-        "description": "Alias for projection: full",
-        "type": "boolean"
-      },
-      "max_chars": {
-        "default": 16000,
-        "description": "Maximum characters in text response before truncation",
-        "maximum": 100000,
-        "minimum": 1000,
-        "type": "integer"
-      },
-      "page": {
-        "default": 1,
-        "description": "Page number for pagination",
-        "maximum": 9007199254740991,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "per_page": {
-        "default": 10,
-        "description": "Items per page",
-        "maximum": 100,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "projection": {
-        "default": "summary",
-        "description": "Detail projection depth",
-        "enum": [
-          "summary",
-          "full"
-        ],
-        "type": "string"
-      },
-      "reveal": {
-        "default": false,
-        "description": "Reveal sensitive/masked values in full projection (default false — secrets masked as ***)",
-        "type": "boolean"
-      }
-    },
-    "required": [
-      "action",
-      "deployment_uuid"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "action": {
-        "const": "cancel",
-        "type": "string"
-      },
-      "deployment_uuid": {
-        "description": "Deployment UUID to cancel",
-        "type": "string"
-      },
-      "format": {
-        "default": "pretty",
-        "description": "Output format style",
-        "enum": [
-          "pretty",
-          "json",
-          "table"
-        ],
-        "type": "string"
-      },
-      "max_chars": {
-        "default": 16000,
-        "description": "Maximum characters in text response before truncation",
-        "maximum": 100000,
-        "minimum": 1000,
-        "type": "integer"
-      }
-    },
-    "required": [
-      "action",
-      "deployment_uuid"
-    ],
-    "type": "object"
-  }
-]
    • addedInput schema / properties
      Added value: +{
+  "action": {
+    "description": "The action to run",
+    "enum": [
+      "list",
+      "get",
+      "cancel",
+      "watch"
+    ],
+    "type": "string"
+  },
+  "application_uuid": {
+    "description": "Application UUID to list deployments for",
+    "type": "string"
+  },
+  "deployment_uuid": {
+    "description": "Deployment UUID",
+    "type": "string"
+  },
+  "format": {
+    "description": "Output format style",
+    "enum": [
+      "pretty",
+      "json",
+      "table"
+    ],
+    "type": "string"
+  },
+  "include_full": {
+    "description": "Alias for projection: full",
+    "type": "boolean"
+  },
+  "include_logs": {
+    "default": false,
+    "description": "Attach capped build logs on success (default false)",
+    "type": "boolean"
+  },
+  "instance": {
+    "description": "Coolify instance name from registry (optional — uses env credentials or registry default)",
+    "pattern": "^[a-z][a-z0-9_-]{1,31}$",
+    "type": "string"
+  },
+  "max_chars": {
+    "description": "Maximum characters in text response before truncation",
+    "maximum": 100000,
+    "minimum": 1000,
+    "type": "integer"
+  },
+  "max_interval": {
+    "default": 30,
+    "description": "Maximum poll interval in seconds (default 30)",
+    "maximum": 9007199254740991,
+    "minimum": 1,
+    "type": "integer"
+  },
+  "min_interval": {
+    "default": 3,
+    "description": "Minimum poll interval in seconds (default 3)",
+    "maximum": 9007199254740991,
+    "minimum": 1,
+    "type": "integer"
+  },
+  "page": {
+    "description": "Page number for pagination",
+    "maximum": 9007199254740991,
+    "minimum": 1,
+    "type": "integer"
+  },
+  "per_page": {
+    "description": "Items per page",
+    "maximum": 100,
+    "minimum": 1,
+    "type": "integer"
+  },
+  "projection": {
+    "description": "Detail projection depth",
+    "enum": [
+      "summary",
+      "full"
+    ],
+    "type": "string"
+  },
+  "reveal": {
+    "description": "Reveal sensitive/masked values in full projection (default false — secrets masked as ***)",
+    "type": "boolean"
+  },
+  "timeout": {
+    "default": 300,
+    "description": "Watch timeout in seconds (default 300)",
+    "maximum": 1800,
+    "minimum": 10,
+    "type": "integer"
+  }
+}
    • addedInput schema / required
      Added value: +[
+  "action"
+]
    • addedOutput schema / properties / _meta / properties / envOverride
      Added value: +{
+  "type": "boolean"
+}
  3. First observedv0.1.2

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Given annotations only include openWorldHint, the description carries the burden of behavioral disclosure. It openly states that cancel and rollback are destructive ('confirm for destructive ops', 'rollback requires confirm:true'), preflight is read-only, and reveal is opt-in. This goes beyond annotations and adds meaningful safety context, though it does not detail watch or logs behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured and efficient: an overview sentence, a compact action list with parameter signatures, and a safety note. Every line carries distinct information with no redundancy, making it easy to parse despite the breadth of actions.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With 25 parameters, an output schema, and 7 actions, the description provides a comprehensive overview, action signatures, and safety caveats. It does not delve into when to prefer one action over another (e.g., watch vs. logs), but the schema and output schema fill many gaps. Overall, it is sufficiently complete for an agent to select and invoke actions correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Although schema coverage is 100% (baseline 3), the description adds value by grouping parameters into action signatures and clarifying alternative inputs (e.g., 'deployment_uuid|application_uuid' for logs, 'uuid|name|fqdn' for preflight/rollback). The safety notes also clarify semantic constraints (confirm required, reveal opt-in), enriching beyond the schema's descriptive text.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with 'List per-app deployments, get deployment details, or cancel an in-flight deployment,' which clearly identifies the tool as deployment management. The subsequent 'Actions:' list enumerates all seven operations, distinguishing it from sibling tools like 'application' or 'service' by explicitly focusing on deployment lifecycle.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides contextual usage guidance through the 'Safety:' note, indicating that confirm is required for destructive operations, preflight is advisory read-only, and rollback requires confirm:true. It lacks explicit 'when not to use' or alternative tool references, but the action names and parameter lists imply appropriate scenarios, giving clear context without exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/clezcoding/awesome-coolify'

If you have feedback or need assistance with the MCP directory API, please join our Discord server