Coolify Diagnose

Install this skill pack (Cursor, Claude Code, Codex):

npx skills add clezcoding/awesome-coolify -a cursor -a claude-code -a codex

MCP prompt analog: diagnose (src/mcp/prompts.ts)

Related skills: coolify-setup · coolify-deploy · coolify-incident

Diagnose tool

Primary entry: MCP diagnose tool (diagnoseActionsCatalog):

Actions: app(query?, uuid?, name?, domain?, limit?) · server(query?, uuid?, name?, ip?, trigger_validate?) · scan(format?, page?, per_page?) · logs(uuid, mode?, lines?, max_chars?)

Workflow

1. Resolve UUID — from args, .coolify/manifest.json, or ask the user.

2. Application path:

   diagnose({ action: "app", uuid: "<uuid>" })

3. Server path:

   diagnose({ action: "server", uuid: "<server-uuid>" })

4. Fleet scan path:

   diagnose({ action: "scan" })

5. Application logs path:

   system({ action: "version" })
   diagnose({ action: "logs", mode: "full", uuid: "<uuid>" })

   logs combines application diagnosis with a bounded runtime tail. It is application-only in Coolify 4.1.x; service/database logs are unavailable because those REST endpoints do not exist.

6. Summarize findings by severity and recommend the next remediation step.

7. If remediation requires redeploy — use coolify-deploy deployment.watch flow:

   deployment({ action: "watch", deployment_uuid: "<deployment_uuid>", timeout: 300 })

Recipe context

When diagnosis points to missing infrastructure, use recipe actions:

• create-git-app · create-app-db · create-one-click

Or run coolify-setup for full greenfield wire.

Safety

• reveal opt-in — pass reveal: true on read/get actions only when the human explicitly needs unmasked secrets or env values. Default responses mask sensitive fields.
• confirm gates — destructive mutations (delete, emergency redeploy, force overrides) require explicit human approval and confirm: true on the second call after preview.

Example calls

diagnose({ action: "app", uuid: "<uuid>" })

diagnose({ action: "server", uuid: "<server-uuid>", trigger_validate: true })

diagnose({ action: "scan", per_page: 20 })

diagnose({ action: "logs", mode: "full", uuid: "<uuid>" })