@masonator/coolify-mcp 2.9.0 → 2.10.0

package/dist/__tests__/coolify-client.test.js

@@ -969,6 +969,131 @@ describe('CoolifyClient', () => {
             expect(callBody.custom_docker_run_options).toBe('--network=my-net');
             expect(callBody.custom_labels).toBe('dHJhZWZpaw==');
         });
+        // Regression for #178 — verify build-config and health_check_* fields reach
+        // the wire, not just zod-accepted then silently stripped by the hand-pick.
+        it('should pass build-config and health_check fields through createApplicationPublic', async () => {
+            mockFetch.mockResolvedValueOnce(mockResponse({ uuid: 'new-app-uuid' }));
+            await client.createApplicationPublic({
+                project_uuid: 'proj-uuid',
+                server_uuid: 'server-uuid',
+                git_repository: 'https://github.com/user/monorepo',
+                git_branch: 'main',
+                build_pack: 'dockerfile',
+                ports_exposes: '3000',
+                base_directory: '/apps/api',
+                publish_directory: '/dist',
+                install_command: 'pnpm install',
+                build_command: 'pnpm build',
+                start_command: 'node dist/main.js',
+                dockerfile_location: '/apps/api/Dockerfile',
+                watch_paths: 'apps/api/**',
+                health_check_enabled: true,
+                health_check_path: '/health',
+                health_check_port: 3000,
+                health_check_start_period: 60,
+            });
+            const callBody = JSON.parse(mockFetch.mock.calls[0][1]?.body);
+            expect(callBody.base_directory).toBe('/apps/api');
+            expect(callBody.publish_directory).toBe('/dist');
+            expect(callBody.install_command).toBe('pnpm install');
+            expect(callBody.build_command).toBe('pnpm build');
+            expect(callBody.start_command).toBe('node dist/main.js');
+            expect(callBody.dockerfile_location).toBe('/apps/api/Dockerfile');
+            expect(callBody.watch_paths).toBe('apps/api/**');
+            expect(callBody.health_check_enabled).toBe(true);
+            expect(callBody.health_check_path).toBe('/health');
+            expect(callBody.health_check_port).toBe(3000);
+            expect(callBody.health_check_start_period).toBe(60);
+        });
+        it('should pass build-config and health_check fields through createApplicationPrivateGH', async () => {
+            mockFetch.mockResolvedValueOnce(mockResponse({ uuid: 'new-app-uuid' }));
+            await client.createApplicationPrivateGH({
+                project_uuid: 'proj-uuid',
+                server_uuid: 'server-uuid',
+                github_app_uuid: 'gh-app-uuid',
+                git_repository: 'org/monorepo',
+                git_branch: 'main',
+                base_directory: '/apps/api',
+                dockerfile_location: '/apps/api/Dockerfile',
+                watch_paths: 'apps/api/**',
+                health_check_enabled: true,
+                health_check_path: '/health',
+            });
+            const callBody = JSON.parse(mockFetch.mock.calls[0][1]?.body);
+            expect(callBody.base_directory).toBe('/apps/api');
+            expect(callBody.dockerfile_location).toBe('/apps/api/Dockerfile');
+            expect(callBody.watch_paths).toBe('apps/api/**');
+            expect(callBody.health_check_enabled).toBe(true);
+            expect(callBody.health_check_path).toBe('/health');
+        });
+        it('should pass build-config and health_check fields through createApplicationPrivateKey', async () => {
+            mockFetch.mockResolvedValueOnce(mockResponse({ uuid: 'new-app-uuid' }));
+            await client.createApplicationPrivateKey({
+                project_uuid: 'proj-uuid',
+                server_uuid: 'server-uuid',
+                private_key_uuid: 'key-uuid',
+                git_repository: 'git@github.com:org/monorepo.git',
+                git_branch: 'main',
+                base_directory: '/apps/api',
+                publish_directory: '/dist',
+                install_command: 'pnpm install',
+                build_command: 'pnpm build',
+                start_command: 'node dist/main.js',
+                dockerfile_location: '/apps/api/Dockerfile',
+                watch_paths: 'apps/api/**',
+                health_check_enabled: true,
+                health_check_path: '/health',
+                health_check_port: 3000,
+            });
+            const callBody = JSON.parse(mockFetch.mock.calls[0][1]?.body);
+            expect(callBody.base_directory).toBe('/apps/api');
+            expect(callBody.dockerfile_location).toBe('/apps/api/Dockerfile');
+            expect(callBody.watch_paths).toBe('apps/api/**');
+            expect(callBody.health_check_path).toBe('/health');
+            expect(callBody.health_check_port).toBe(3000);
+        });
+        it('should pass health_check fields through createApplicationDockerImage (build-config N/A)', async () => {
+            mockFetch.mockResolvedValueOnce(mockResponse({ uuid: 'new-app-uuid' }));
+            await client.createApplicationDockerImage({
+                project_uuid: 'proj-uuid',
+                server_uuid: 'server-uuid',
+                docker_registry_image_name: 'traefik/whoami',
+                ports_exposes: '80',
+                health_check_enabled: true,
+                health_check_path: '/health',
+                health_check_port: 80,
+                health_check_method: 'GET',
+                health_check_scheme: 'http',
+                health_check_return_code: 200,
+                health_check_interval: 30,
+                health_check_timeout: 5,
+                health_check_retries: 3,
+                health_check_start_period: 60,
+            });
+            const callBody = JSON.parse(mockFetch.mock.calls[0][1]?.body);
+            expect(callBody.health_check_enabled).toBe(true);
+            expect(callBody.health_check_path).toBe('/health');
+            expect(callBody.health_check_port).toBe(80);
+            expect(callBody.health_check_method).toBe('GET');
+            expect(callBody.health_check_scheme).toBe('http');
+            expect(callBody.health_check_return_code).toBe(200);
+            expect(callBody.health_check_interval).toBe(30);
+            expect(callBody.health_check_timeout).toBe(5);
+            expect(callBody.health_check_retries).toBe(3);
+            expect(callBody.health_check_start_period).toBe(60);
+        });
+        it('should pass dockerfile_target_build through updateApplication (PATCH-only field)', async () => {
+            mockFetch.mockResolvedValueOnce(mockResponse(mockApplication));
+            await client.updateApplication('app-uuid', {
+                dockerfile_location: '/apps/api/Dockerfile',
+                dockerfile_target_build: 'production',
+                base_directory: '/apps/api',
+            });
+            const callBody = JSON.parse(mockFetch.mock.calls[0][1]?.body);
+            expect(callBody.dockerfile_location).toBe('/apps/api/Dockerfile');
+            expect(callBody.dockerfile_target_build).toBe('production');
+            expect(callBody.base_directory).toBe('/apps/api');
+        });
         it('should pass destination_uuid through in createApplicationPublic', async () => {
             mockFetch.mockResolvedValueOnce(mockResponse({ uuid: 'new-app-uuid' }));
             await client.createApplicationPublic({

package/dist/__tests__/mcp-server.test.js

@@ -263,6 +263,166 @@ describe('CoolifyMcpServer v2', () => {
             expect(spy).toHaveBeenCalledWith(['app-1', 'app-2'], 'PEM_KEY', 'multiline', false, true);
         });
     });
+    describe('application tool handler', () => {
+        // Regression for #178 — verify the application tool's create_* hand-picks
+        // forward build-config and health_check_* fields to the client. Previously
+        // these fields were accepted by zod but silently dropped by the hand-pick.
+        const callApplication = async (srv, args) => {
+            const tool = srv._registeredTools['application'];
+            return tool.handler(args, {});
+        };
+        const baseCreatePublic = {
+            action: 'create_public',
+            project_uuid: 'proj-uuid',
+            server_uuid: 'server-uuid',
+            git_repository: 'https://github.com/org/monorepo',
+            git_branch: 'main',
+            build_pack: 'dockerfile',
+            ports_exposes: '3000',
+        };
+        it('forwards build-config and health_check fields in create_public', async () => {
+            const spy = jest
+                .spyOn(server['client'], 'createApplicationPublic')
+                .mockResolvedValue({ uuid: 'app-1' });
+            await callApplication(server, {
+                ...baseCreatePublic,
+                base_directory: '/apps/api',
+                publish_directory: '/dist',
+                install_command: 'pnpm install',
+                build_command: 'pnpm build',
+                start_command: 'node dist/main.js',
+                dockerfile_location: '/apps/api/Dockerfile',
+                watch_paths: 'apps/api/**',
+                health_check_enabled: true,
+                health_check_path: '/health',
+                health_check_port: 3000,
+                health_check_start_period: 60,
+            });
+            expect(spy).toHaveBeenCalledWith(expect.objectContaining({
+                base_directory: '/apps/api',
+                publish_directory: '/dist',
+                install_command: 'pnpm install',
+                build_command: 'pnpm build',
+                start_command: 'node dist/main.js',
+                dockerfile_location: '/apps/api/Dockerfile',
+                watch_paths: 'apps/api/**',
+                health_check_enabled: true,
+                health_check_path: '/health',
+                health_check_port: 3000,
+                health_check_start_period: 60,
+            }));
+        });
+        it('forwards build-config and health_check fields in create_github', async () => {
+            const spy = jest
+                .spyOn(server['client'], 'createApplicationPrivateGH')
+                .mockResolvedValue({ uuid: 'app-2' });
+            await callApplication(server, {
+                action: 'create_github',
+                project_uuid: 'proj-uuid',
+                server_uuid: 'server-uuid',
+                github_app_uuid: 'gh-app-uuid',
+                git_repository: 'org/monorepo',
+                git_branch: 'main',
+                base_directory: '/apps/api',
+                dockerfile_location: '/apps/api/Dockerfile',
+                watch_paths: 'apps/api/**',
+                health_check_enabled: true,
+                health_check_path: '/health',
+            });
+            expect(spy).toHaveBeenCalledWith(expect.objectContaining({
+                base_directory: '/apps/api',
+                dockerfile_location: '/apps/api/Dockerfile',
+                watch_paths: 'apps/api/**',
+                health_check_enabled: true,
+                health_check_path: '/health',
+            }));
+        });
+        it('forwards build-config and health_check fields in create_key', async () => {
+            const spy = jest
+                .spyOn(server['client'], 'createApplicationPrivateKey')
+                .mockResolvedValue({ uuid: 'app-3' });
+            await callApplication(server, {
+                action: 'create_key',
+                project_uuid: 'proj-uuid',
+                server_uuid: 'server-uuid',
+                private_key_uuid: 'key-uuid',
+                git_repository: 'git@github.com:org/monorepo.git',
+                git_branch: 'main',
+                base_directory: '/apps/api',
+                publish_directory: '/dist',
+                install_command: 'pnpm install',
+                build_command: 'pnpm build',
+                start_command: 'node dist/main.js',
+                dockerfile_location: '/apps/api/Dockerfile',
+                watch_paths: 'apps/api/**',
+                health_check_enabled: true,
+                health_check_path: '/health',
+                health_check_port: 3000,
+            });
+            expect(spy).toHaveBeenCalledWith(expect.objectContaining({
+                base_directory: '/apps/api',
+                publish_directory: '/dist',
+                install_command: 'pnpm install',
+                build_command: 'pnpm build',
+                start_command: 'node dist/main.js',
+                dockerfile_location: '/apps/api/Dockerfile',
+                watch_paths: 'apps/api/**',
+                health_check_enabled: true,
+                health_check_path: '/health',
+                health_check_port: 3000,
+            }));
+        });
+        it('forwards health_check fields in create_dockerimage (build-config intentionally dropped)', async () => {
+            const spy = jest
+                .spyOn(server['client'], 'createApplicationDockerImage')
+                .mockResolvedValue({ uuid: 'app-4' });
+            // Caller passes both healthcheck AND build-config. Coolify's /applications/dockerimage
+            // endpoint doesn't accept build-config (pre-built image), so handler must drop those.
+            await callApplication(server, {
+                action: 'create_dockerimage',
+                project_uuid: 'proj-uuid',
+                server_uuid: 'server-uuid',
+                docker_registry_image_name: 'traefik/whoami',
+                ports_exposes: '80',
+                // Should be forwarded:
+                health_check_enabled: true,
+                health_check_path: '/health',
+                health_check_port: 80,
+                // Should NOT be forwarded (build-config not applicable to prebuilt image):
+                base_directory: '/should-be-dropped',
+                install_command: 'should-be-dropped',
+                dockerfile_location: '/should-be-dropped',
+            });
+            const forwarded = spy.mock.calls[0]?.[0];
+            expect(forwarded).toEqual(expect.objectContaining({
+                health_check_enabled: true,
+                health_check_path: '/health',
+                health_check_port: 80,
+            }));
+            expect(forwarded).not.toHaveProperty('base_directory');
+            expect(forwarded).not.toHaveProperty('install_command');
+            expect(forwarded).not.toHaveProperty('dockerfile_location');
+        });
+        it('forwards dockerfile_target_build through update (PATCH-only)', async () => {
+            const spy = jest.spyOn(server['client'], 'updateApplication').mockResolvedValue({});
+            await callApplication(server, {
+                action: 'update',
+                uuid: 'app-uuid',
+                dockerfile_location: '/apps/api/Dockerfile',
+                dockerfile_target_build: 'production',
+                base_directory: '/apps/api',
+            });
+            expect(spy).toHaveBeenCalledWith('app-uuid', expect.objectContaining({
+                dockerfile_location: '/apps/api/Dockerfile',
+                dockerfile_target_build: 'production',
+                base_directory: '/apps/api',
+            }));
+            // Confirm the update spread strips routing fields.
+            const updateData = spy.mock.calls[0]?.[1];
+            expect(updateData).not.toHaveProperty('action');
+            expect(updateData).not.toHaveProperty('uuid');
+        });
+    });
 });
 describe('truncateLogs', () => {
     // Plain text log tests

package/dist/lib/mcp-server.js

@@ -340,6 +340,18 @@ export class CoolifyMcpServer extends McpServer {
             health_check_timeout: z.number().optional(),
             health_check_retries: z.number().optional(),
             health_check_start_period: z.number().optional(),
+            // Build configuration fields (accepted on create_public/github/key + update;
+            // create_dockerimage ignores these — pre-built image, no build step)
+            base_directory: z.string().optional(),
+            publish_directory: z.string().optional(),
+            install_command: z.string().optional(),
+            build_command: z.string().optional(),
+            start_command: z.string().optional(),
+            dockerfile_location: z.string().optional(),
+            watch_paths: z.string().optional(),
+            // Update-only: Coolify strips dockerfile_target_build on every create endpoint
+            // (controller $allowedFields line 1014) but accepts on PATCH (line 2497).
+            dockerfile_target_build: z.string().optional(),
             // Delete fields
             delete_volumes: z.boolean().optional(),
         }, async (args) => {
@@ -375,6 +387,25 @@ export class CoolifyMcpServer extends McpServer {
                         description: args.description,
                         fqdn: args.fqdn,
                         domains: args.domains,
+                        base_directory: args.base_directory,
+                        publish_directory: args.publish_directory,
+                        install_command: args.install_command,
+                        build_command: args.build_command,
+                        start_command: args.start_command,
+                        dockerfile_location: args.dockerfile_location,
+                        watch_paths: args.watch_paths,
+                        health_check_enabled: args.health_check_enabled,
+                        health_check_path: args.health_check_path,
+                        health_check_port: args.health_check_port,
+                        health_check_host: args.health_check_host,
+                        health_check_method: args.health_check_method,
+                        health_check_return_code: args.health_check_return_code,
+                        health_check_scheme: args.health_check_scheme,
+                        health_check_response_text: args.health_check_response_text,
+                        health_check_interval: args.health_check_interval,
+                        health_check_timeout: args.health_check_timeout,
+                        health_check_retries: args.health_check_retries,
+                        health_check_start_period: args.health_check_start_period,
                         custom_docker_run_options: args.custom_docker_run_options,
                         custom_labels: args.custom_labels,
                         instant_deploy: args.instant_deploy,
@@ -409,6 +440,25 @@ export class CoolifyMcpServer extends McpServer {
                         description: args.description,
                         fqdn: args.fqdn,
                         domains: args.domains,
+                        base_directory: args.base_directory,
+                        publish_directory: args.publish_directory,
+                        install_command: args.install_command,
+                        build_command: args.build_command,
+                        start_command: args.start_command,
+                        dockerfile_location: args.dockerfile_location,
+                        watch_paths: args.watch_paths,
+                        health_check_enabled: args.health_check_enabled,
+                        health_check_path: args.health_check_path,
+                        health_check_port: args.health_check_port,
+                        health_check_host: args.health_check_host,
+                        health_check_method: args.health_check_method,
+                        health_check_return_code: args.health_check_return_code,
+                        health_check_scheme: args.health_check_scheme,
+                        health_check_response_text: args.health_check_response_text,
+                        health_check_interval: args.health_check_interval,
+                        health_check_timeout: args.health_check_timeout,
+                        health_check_retries: args.health_check_retries,
+                        health_check_start_period: args.health_check_start_period,
                         custom_docker_run_options: args.custom_docker_run_options,
                         custom_labels: args.custom_labels,
                         instant_deploy: args.instant_deploy,
@@ -443,6 +493,25 @@ export class CoolifyMcpServer extends McpServer {
                         description: args.description,
                         fqdn: args.fqdn,
                         domains: args.domains,
+                        base_directory: args.base_directory,
+                        publish_directory: args.publish_directory,
+                        install_command: args.install_command,
+                        build_command: args.build_command,
+                        start_command: args.start_command,
+                        dockerfile_location: args.dockerfile_location,
+                        watch_paths: args.watch_paths,
+                        health_check_enabled: args.health_check_enabled,
+                        health_check_path: args.health_check_path,
+                        health_check_port: args.health_check_port,
+                        health_check_host: args.health_check_host,
+                        health_check_method: args.health_check_method,
+                        health_check_return_code: args.health_check_return_code,
+                        health_check_scheme: args.health_check_scheme,
+                        health_check_response_text: args.health_check_response_text,
+                        health_check_interval: args.health_check_interval,
+                        health_check_timeout: args.health_check_timeout,
+                        health_check_retries: args.health_check_retries,
+                        health_check_start_period: args.health_check_start_period,
                         custom_docker_run_options: args.custom_docker_run_options,
                         custom_labels: args.custom_labels,
                         instant_deploy: args.instant_deploy,
@@ -474,6 +543,21 @@ export class CoolifyMcpServer extends McpServer {
                         description: args.description,
                         fqdn: args.fqdn,
                         domains: args.domains,
+                        // Build-config fields (base_directory, install_command, etc.)
+                        // are intentionally NOT forwarded: /applications/dockerimage is
+                        // for pre-built registry images and has no build step.
+                        health_check_enabled: args.health_check_enabled,
+                        health_check_path: args.health_check_path,
+                        health_check_port: args.health_check_port,
+                        health_check_host: args.health_check_host,
+                        health_check_method: args.health_check_method,
+                        health_check_return_code: args.health_check_return_code,
+                        health_check_scheme: args.health_check_scheme,
+                        health_check_response_text: args.health_check_response_text,
+                        health_check_interval: args.health_check_interval,
+                        health_check_timeout: args.health_check_timeout,
+                        health_check_retries: args.health_check_retries,
+                        health_check_start_period: args.health_check_start_period,
                         custom_docker_run_options: args.custom_docker_run_options,
                         custom_labels: args.custom_labels,
                         instant_deploy: args.instant_deploy,

package/dist/types/coolify.d.ts

@@ -224,6 +224,20 @@ export interface CreateApplicationPublicRequest {
     install_command?: string;
     build_command?: string;
     start_command?: string;
+    dockerfile_location?: string;
+    watch_paths?: string;
+    health_check_enabled?: boolean;
+    health_check_path?: string;
+    health_check_port?: number;
+    health_check_host?: string;
+    health_check_method?: string;
+    health_check_return_code?: number;
+    health_check_scheme?: string;
+    health_check_response_text?: string;
+    health_check_interval?: number;
+    health_check_timeout?: number;
+    health_check_retries?: number;
+    health_check_start_period?: number;
     custom_docker_run_options?: string;
     custom_labels?: string;
     instant_deploy?: boolean;
@@ -271,6 +285,18 @@ export interface CreateApplicationDockerImageRequest {
     docker_registry_image_tag?: string;
     ports_exposes: string;
     ports_mappings?: string;
+    health_check_enabled?: boolean;
+    health_check_path?: string;
+    health_check_port?: number;
+    health_check_host?: string;
+    health_check_method?: string;
+    health_check_return_code?: number;
+    health_check_scheme?: string;
+    health_check_response_text?: string;
+    health_check_interval?: number;
+    health_check_timeout?: number;
+    health_check_retries?: number;
+    health_check_start_period?: number;
     custom_docker_run_options?: string;
     custom_labels?: string;
     instant_deploy?: boolean;
@@ -316,6 +342,8 @@ export interface UpdateApplicationRequest {
     install_command?: string;
     build_command?: string;
     start_command?: string;
+    dockerfile_target_build?: string;
+    watch_paths?: string;
     health_check_enabled?: boolean;
     health_check_path?: string;
     health_check_port?: number;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@masonator/coolify-mcp",
   "scope": "@masonator",
-  "version": "2.9.0",
+  "version": "2.10.0",
   "mcpName": "io.github.StuMason/coolify",
   "description": "MCP server for Coolify — 38 optimized tools for infrastructure management, diagnostics, and documentation search",
   "type": "module",