@masonator/coolify-mcp 0.3.1 → 0.7.0

package/dist/lib/mcp-server.js

@@ -19,8 +19,8 @@
 // @ts-nocheck
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import { CoolifyClient } from './coolify-client.js';
-const VERSION = '0.3.1';
+import { CoolifyClient, } from './coolify-client.js';
+const VERSION = '0.7.0';
 /** Wrap tool handler with consistent error handling */
 function wrapHandler(fn) {
     return fn()
@@ -55,10 +55,53 @@ export class CoolifyMcpServer extends McpServer {
     registerTools() {
         // Version
         this.tool('get_version', 'Get Coolify API version', {}, async () => wrapHandler(() => this.client.getVersion()));
+        // Infrastructure Overview - high-level view of all resources
+        this.tool('get_infrastructure_overview', 'Get a high-level overview of all infrastructure (servers, projects, applications, databases, services). Returns counts and summaries. Start here to understand the infrastructure.', {}, async () => wrapHandler(async () => {
+            const results = await Promise.allSettled([
+                this.client.listServers({ summary: true }),
+                this.client.listProjects({ summary: true }),
+                this.client.listApplications({ summary: true }),
+                this.client.listDatabases({ summary: true }),
+                this.client.listServices({ summary: true }),
+            ]);
+            const extract = (result) => result.status === 'fulfilled' ? result.value : [];
+            const servers = extract(results[0]);
+            const projects = extract(results[1]);
+            const applications = extract(results[2]);
+            const databases = extract(results[3]);
+            const services = extract(results[4]);
+            const errors = results
+                .map((r, i) => {
+                if (r.status === 'rejected') {
+                    const names = ['servers', 'projects', 'applications', 'databases', 'services'];
+                    return `${names[i]}: ${r.reason instanceof Error ? r.reason.message : String(r.reason)}`;
+                }
+                return null;
+            })
+                .filter(Boolean);
+            return {
+                summary: {
+                    servers: servers.length,
+                    projects: projects.length,
+                    applications: applications.length,
+                    databases: databases.length,
+                    services: services.length,
+                },
+                servers,
+                projects,
+                applications,
+                databases,
+                services,
+                ...(errors.length > 0 && { errors }),
+            };
+        }));
         // =========================================================================
         // Servers (5 tools)
         // =========================================================================
-        this.tool('list_servers', 'List all servers', {}, async () => wrapHandler(() => this.client.listServers()));
+        this.tool('list_servers', 'List all servers (returns summary: uuid, name, ip, status). Use get_server for full details.', {
+            page: z.number().optional().describe('Page number for pagination'),
+            per_page: z.number().optional().describe('Items per page (default: all)'),
+        }, async ({ page, per_page }) => wrapHandler(() => this.client.listServers({ page, per_page, summary: true })));
         this.tool('get_server', 'Get server details', { uuid: z.string().describe('Server UUID') }, async ({ uuid }) => wrapHandler(() => this.client.getServer(uuid)));
         this.tool('get_server_resources', 'Get resources running on a server', { uuid: z.string().describe('Server UUID') }, async ({ uuid }) => wrapHandler(() => this.client.getServerResources(uuid)));
         this.tool('get_server_domains', 'Get domains configured on a server', { uuid: z.string().describe('Server UUID') }, async ({ uuid }) => wrapHandler(() => this.client.getServerDomains(uuid)));
@@ -66,7 +109,10 @@ export class CoolifyMcpServer extends McpServer {
         // =========================================================================
         // Projects (5 tools)
         // =========================================================================
-        this.tool('list_projects', 'List all projects', {}, async () => wrapHandler(() => this.client.listProjects()));
+        this.tool('list_projects', 'List all projects (returns summary: uuid, name, description). Use get_project for full details.', {
+            page: z.number().optional().describe('Page number for pagination'),
+            per_page: z.number().optional().describe('Items per page (default: all)'),
+        }, async ({ page, per_page }) => wrapHandler(() => this.client.listProjects({ page, per_page, summary: true })));
         this.tool('get_project', 'Get project details', { uuid: z.string().describe('Project UUID') }, async ({ uuid }) => wrapHandler(() => this.client.getProject(uuid)));
         this.tool('create_project', 'Create a new project', {
             name: z.string().describe('Project name'),
@@ -95,7 +141,10 @@ export class CoolifyMcpServer extends McpServer {
         // =========================================================================
         // Applications (15 tools)
         // =========================================================================
-        this.tool('list_applications', 'List all applications', {}, async () => wrapHandler(() => this.client.listApplications()));
+        this.tool('list_applications', 'List all applications (returns summary: uuid, name, status, fqdn, git_repository). Use get_application for full details.', {
+            page: z.number().optional().describe('Page number for pagination'),
+            per_page: z.number().optional().describe('Items per page (default: all)'),
+        }, async ({ page, per_page }) => wrapHandler(() => this.client.listApplications({ page, per_page, summary: true })));
         this.tool('get_application', 'Get application details', { uuid: z.string().describe('Application UUID') }, async ({ uuid }) => wrapHandler(() => this.client.getApplication(uuid)));
         this.tool('create_application_private_gh', 'Create app from private GitHub repo (GitHub App)', {
             project_uuid: z.string().describe('Project UUID'),
@@ -163,16 +212,64 @@ export class CoolifyMcpServer extends McpServer {
         // =========================================================================
         // Databases (5 tools)
         // =========================================================================
-        this.tool('list_databases', 'List all databases', {}, async () => wrapHandler(() => this.client.listDatabases()));
+        this.tool('list_databases', 'List all databases (returns summary: uuid, name, type, status). Use get_database for full details.', {
+            page: z.number().optional().describe('Page number for pagination'),
+            per_page: z.number().optional().describe('Items per page (default: all)'),
+        }, async ({ page, per_page }) => wrapHandler(() => this.client.listDatabases({ page, per_page, summary: true })));
         this.tool('get_database', 'Get database details', { uuid: z.string().describe('Database UUID') }, async ({ uuid }) => wrapHandler(() => this.client.getDatabase(uuid)));
         this.tool('start_database', 'Start a database', { uuid: z.string().describe('Database UUID') }, async ({ uuid }) => wrapHandler(() => this.client.startDatabase(uuid)));
         this.tool('stop_database', 'Stop a database', { uuid: z.string().describe('Database UUID') }, async ({ uuid }) => wrapHandler(() => this.client.stopDatabase(uuid)));
         this.tool('restart_database', 'Restart a database', { uuid: z.string().describe('Database UUID') }, async ({ uuid }) => wrapHandler(() => this.client.restartDatabase(uuid)));
         // =========================================================================
-        // Services (9 tools)
+        // Services (11 tools)
         // =========================================================================
-        this.tool('list_services', 'List all services', {}, async () => wrapHandler(() => this.client.listServices()));
+        this.tool('list_services', 'List all services (returns summary: uuid, name, type, status, domains). Use get_service for full details.', {
+            page: z.number().optional().describe('Page number for pagination'),
+            per_page: z.number().optional().describe('Items per page (default: all)'),
+        }, async ({ page, per_page }) => wrapHandler(() => this.client.listServices({ page, per_page, summary: true })));
         this.tool('get_service', 'Get service details', { uuid: z.string().describe('Service UUID') }, async ({ uuid }) => wrapHandler(() => this.client.getService(uuid)));
+        this.tool('create_service', 'Create a one-click service (e.g., pocketbase, mysql, redis, wordpress, etc.). Use type OR docker_compose_raw, not both.', {
+            type: z
+                .string()
+                .optional()
+                .describe('Service type (e.g., pocketbase, mysql, redis, postgresql, mongodb, wordpress, etc.)'),
+            server_uuid: z.string().describe('Server UUID'),
+            project_uuid: z.string().describe('Project UUID'),
+            environment_name: z.string().optional().describe('Environment name (e.g., production)'),
+            environment_uuid: z
+                .string()
+                .optional()
+                .describe('Environment UUID (alternative to environment_name)'),
+            name: z.string().optional().describe('Service name'),
+            description: z.string().optional().describe('Service description'),
+            destination_uuid: z.string().optional().describe('Destination UUID'),
+            instant_deploy: z.boolean().optional().describe('Deploy immediately after creation'),
+            docker_compose_raw: z
+                .string()
+                .optional()
+                .describe('Base64 encoded docker-compose YAML with SERVICE_FQDN_* env var for custom domain (alternative to type)'),
+        }, async (args) => wrapHandler(() => this.client.createService(args)));
+        this.tool('delete_service', 'Delete a service', {
+            uuid: z.string().describe('Service UUID'),
+            delete_configurations: z
+                .boolean()
+                .optional()
+                .describe('Delete configurations (default: true)'),
+            delete_volumes: z.boolean().optional().describe('Delete volumes (default: true)'),
+            docker_cleanup: z
+                .boolean()
+                .optional()
+                .describe('Clean up Docker resources (default: true)'),
+            delete_connected_networks: z
+                .boolean()
+                .optional()
+                .describe('Delete connected networks (default: true)'),
+        }, async ({ uuid, delete_configurations, delete_volumes, docker_cleanup, delete_connected_networks, }) => wrapHandler(() => this.client.deleteService(uuid, {
+            deleteConfigurations: delete_configurations,
+            deleteVolumes: delete_volumes,
+            dockerCleanup: docker_cleanup,
+            deleteConnectedNetworks: delete_connected_networks,
+        })));
         this.tool('update_service', 'Update a service (IMPORTANT: See UpdateServiceRequest type docs for Traefik basic auth requirements)', {
             uuid: z.string().describe('Service UUID'),
             name: z.string().optional().describe('Service name'),
@@ -199,12 +296,50 @@ export class CoolifyMcpServer extends McpServer {
         // =========================================================================
         // Deployments (4 tools)
         // =========================================================================
-        this.tool('list_deployments', 'List running deployments', {}, async () => wrapHandler(() => this.client.listDeployments()));
+        this.tool('list_deployments', 'List running deployments (returns summary: uuid, deployment_uuid, application_name, status). Use get_deployment for full details.', {
+            page: z.number().optional().describe('Page number for pagination'),
+            per_page: z.number().optional().describe('Items per page (default: all)'),
+        }, async ({ page, per_page }) => wrapHandler(() => this.client.listDeployments({ page, per_page, summary: true })));
         this.tool('get_deployment', 'Get deployment details', { uuid: z.string().describe('Deployment UUID') }, async ({ uuid }) => wrapHandler(() => this.client.getDeployment(uuid)));
         this.tool('deploy', 'Deploy by tag or UUID', {
             tag_or_uuid: z.string().describe('Tag or UUID'),
             force: z.boolean().optional().describe('Force rebuild'),
         }, async ({ tag_or_uuid, force }) => wrapHandler(() => this.client.deployByTagOrUuid(tag_or_uuid, force)));
         this.tool('list_application_deployments', 'List deployments for an application', { uuid: z.string().describe('Application UUID') }, async ({ uuid }) => wrapHandler(() => this.client.listApplicationDeployments(uuid)));
+        this.tool('cancel_deployment', 'Cancel a running deployment', { uuid: z.string().describe('Deployment UUID') }, async ({ uuid }) => wrapHandler(() => this.client.cancelDeployment(uuid)));
+        // =========================================================================
+        // Private Keys (5 tools)
+        // =========================================================================
+        this.tool('list_private_keys', 'List all private keys (SSH keys for deployments)', {}, async () => wrapHandler(() => this.client.listPrivateKeys()));
+        this.tool('get_private_key', 'Get private key details', { uuid: z.string().describe('Private key UUID') }, async ({ uuid }) => wrapHandler(() => this.client.getPrivateKey(uuid)));
+        this.tool('create_private_key', 'Create a new private key for deployments', {
+            private_key: z.string().describe('The private key content (PEM format)'),
+            name: z.string().optional().describe('Name for the key'),
+            description: z.string().optional().describe('Description'),
+        }, async (args) => wrapHandler(() => this.client.createPrivateKey(args)));
+        this.tool('update_private_key', 'Update a private key', {
+            uuid: z.string().describe('Private key UUID'),
+            name: z.string().optional().describe('Name for the key'),
+            description: z.string().optional().describe('Description'),
+            private_key: z.string().optional().describe('The private key content (PEM format)'),
+        }, async ({ uuid, ...data }) => wrapHandler(() => this.client.updatePrivateKey(uuid, data)));
+        this.tool('delete_private_key', 'Delete a private key', { uuid: z.string().describe('Private key UUID') }, async ({ uuid }) => wrapHandler(() => this.client.deletePrivateKey(uuid)));
+        // =========================================================================
+        // Database Backups (4 tools)
+        // =========================================================================
+        this.tool('list_database_backups', 'List scheduled backups for a database', { uuid: z.string().describe('Database UUID') }, async ({ uuid }) => wrapHandler(() => this.client.listDatabaseBackups(uuid)));
+        this.tool('get_database_backup', 'Get details of a scheduled backup', {
+            database_uuid: z.string().describe('Database UUID'),
+            backup_uuid: z.string().describe('Scheduled backup UUID'),
+        }, async ({ database_uuid, backup_uuid }) => wrapHandler(() => this.client.getDatabaseBackup(database_uuid, backup_uuid)));
+        this.tool('list_backup_executions', 'List execution history for a scheduled backup', {
+            database_uuid: z.string().describe('Database UUID'),
+            backup_uuid: z.string().describe('Scheduled backup UUID'),
+        }, async ({ database_uuid, backup_uuid }) => wrapHandler(() => this.client.listBackupExecutions(database_uuid, backup_uuid)));
+        this.tool('get_backup_execution', 'Get details of a specific backup execution', {
+            database_uuid: z.string().describe('Database UUID'),
+            backup_uuid: z.string().describe('Scheduled backup UUID'),
+            execution_uuid: z.string().describe('Backup execution UUID'),
+        }, async ({ database_uuid, backup_uuid, execution_uuid }) => wrapHandler(() => this.client.getBackupExecution(database_uuid, backup_uuid, execution_uuid)));
     }
 }

package/dist/types/coolify.d.ts

@@ -300,6 +300,9 @@ export interface UpdateApplicationRequest {
     limits_memory?: string;
     limits_memory_swap?: string;
     limits_cpus?: string;
+    is_http_basic_auth_enabled?: boolean;
+    http_basic_auth_username?: string;
+    http_basic_auth_password?: string;
 }
 export interface ApplicationActionResponse {
     message: string;
@@ -470,6 +473,17 @@ export interface CreateDatabaseBackupRequest {
     backup_retention?: number;
     backup_retention_days?: number;
 }
+export interface BackupExecution {
+    id: number;
+    uuid: string;
+    scheduled_database_backup_id: number;
+    status: 'pending' | 'running' | 'success' | 'failed';
+    message?: string;
+    size?: number;
+    filename?: string;
+    created_at: string;
+    updated_at: string;
+}
 /**
  * Available one-click service types in Coolify.
  * This is a string type to avoid TypeScript memory issues with large const arrays.
@@ -497,7 +511,7 @@ export interface Service {
     updated_at: string;
 }
 export interface CreateServiceRequest {
-    type: ServiceType;
+    type?: ServiceType;
     name?: string;
     description?: string;
     project_uuid: string;
@@ -506,6 +520,7 @@ export interface CreateServiceRequest {
     server_uuid: string;
     destination_uuid?: string;
     instant_deploy?: boolean;
+    docker_compose_raw?: string;
 }
 /**
  * CRITICAL: When updating services with Traefik basic auth labels

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@masonator/coolify-mcp",
   "scope": "@masonator",
-  "version": "0.3.1",
+  "version": "0.7.0",
   "description": "MCP server implementation for Coolify",
   "type": "module",
   "main": "./dist/index.js",
@@ -61,5 +61,9 @@
   },
   "engines": {
     "node": ">=18"
+  },
+  "lint-staged": {
+    "*.{ts,js,json,md,yaml,yml}": "prettier --write",
+    "*.ts": "eslint --fix"
   }
 }