@masonator/coolify-mcp 2.3.0 → 2.5.0

package/README.md

@@ -9,13 +9,13 @@
 [![codecov](https://codecov.io/gh/StuMason/coolify-mcp/branch/main/graph/badge.svg)](https://codecov.io/gh/StuMason/coolify-mcp)
 [![MseeP.ai Security Assessment Badge](https://mseep.net/pr/stumason-coolify-mcp-badge.png)](https://mseep.ai/app/stumason-coolify-mcp)
 
-> **The most comprehensive MCP server for Coolify** - 34 optimized tools, smart diagnostics, and batch operations for managing your self-hosted PaaS through AI assistants.
+> **The most comprehensive MCP server for Coolify** - 35 optimized tools, smart diagnostics, and batch operations for managing your self-hosted PaaS through AI assistants.
 
 A Model Context Protocol (MCP) server for [Coolify](https://coolify.io/), enabling AI assistants to manage and debug your Coolify instances through natural language.
 
 ## Features
 
-This MCP server provides **34 token-optimized tools** for **debugging, management, and deployment**:
+This MCP server provides **35 token-optimized tools** for **debugging, management, and deployment**:
 
 | Category             | Tools                                                                                                                       |
 | -------------------- | --------------------------------------------------------------------------------------------------------------------------- |
@@ -32,6 +32,7 @@ This MCP server provides **34 token-optimized tools** for **debugging, managemen
 | **Env Vars**         | `env_vars` (CRUD for application and service env vars)                                                                      |
 | **Deployments**      | `list_deployments`, `deploy`, `deployment` (get, cancel, list_for_app)                                                      |
 | **Private Keys**     | `private_keys` (list, get, create, update, delete via action param)                                                         |
+| **GitHub Apps**      | `github_apps` (list, get, create, update, delete via action param)                                                          |
 
 ### Token-Optimized Design
 
@@ -42,7 +43,7 @@ The server uses **85% fewer tokens** than a naive implementation (6,600 vs 43,00
 ### Prerequisites
 
 - Node.js >= 18
-- A running Coolify instance
+- A running Coolify instance (tested with v4.0.0-beta.460)
 - Coolify API access token (generate in Coolify Settings > API)
 
 ### Claude Desktop
@@ -111,7 +112,7 @@ The Coolify API returns extremely verbose responses - a single application can c
 1. **Start with overview**: `get_infrastructure_overview` - see everything at once
 2. **Find your target**: `list_applications` - get UUIDs of what you need
 3. **Dive deep**: `get_application(uuid)` - full details for one resource
-4. **Take action**: `restart_application(uuid)`, `get_application_logs(uuid)`, etc.
+4. **Take action**: `control(resource: 'application', action: 'restart')`, `application_logs(uuid)`, etc.
 
 ### Pagination
 
@@ -161,6 +162,8 @@ Update the DATABASE_URL env var for application {uuid}
 Create a new project called "my-app"
 Create a staging environment in project {uuid}
 Deploy my app from private GitHub repo org/repo on branch main
+Deploy nginx:latest from Docker Hub
+Deploy from public repo https://github.com/org/repo
 ```
 
 ## Environment Variables
@@ -228,6 +231,8 @@ These tools accept human-friendly identifiers instead of just UUIDs:
 - `get_application` - Get application details
 - `application_logs` - Get application logs
 - `application` - Create, update, or delete apps with `action: create_public|create_github|create_key|create_dockerimage|update|delete`
+  - Deploy from public repos, private GitHub, SSH keys, or Docker images
+  - Configure health checks (path, interval, retries, etc.)
 - `env_vars` - Manage env vars with `resource: application, action: list|create|update|delete`
 - `control` - Start/stop/restart with `resource: application, action: start|stop|restart`
 
@@ -254,7 +259,7 @@ These tools accept human-friendly identifiers instead of just UUIDs:
 
 - `list_deployments` - List running deployments (returns summary)
 - `deploy` - Deploy by tag or UUID
-- `deployment` - Manage deployments with `action: get|cancel|list_for_app`
+- `deployment` - Manage deployments with `action: get|cancel|list_for_app` (supports `lines` param to limit log output)
 
 ### Private Keys
 

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

@@ -359,6 +359,83 @@ describe('CoolifyClient', () => {
             expect(result).toEqual({ uuid: 'new-key-uuid' });
         });
     });
+    describe('github apps', () => {
+        const mockGitHubApp = {
+            id: 1,
+            uuid: 'gh-app-uuid',
+            name: 'my-github-app',
+            organization: null,
+            api_url: 'https://api.github.com',
+            html_url: 'https://github.com',
+            custom_user: 'git',
+            custom_port: 22,
+            app_id: 12345,
+            installation_id: 67890,
+            client_id: 'client-123',
+            is_system_wide: false,
+            is_public: false,
+            private_key_id: 1,
+            team_id: 0,
+            type: 'github',
+            administration: null,
+            contents: null,
+            metadata: null,
+            pull_requests: null,
+            created_at: '2024-01-01',
+            updated_at: '2024-01-01',
+        };
+        it('should list github apps', async () => {
+            mockFetch.mockResolvedValueOnce(mockResponse([mockGitHubApp]));
+            const result = await client.listGitHubApps();
+            expect(result).toEqual([mockGitHubApp]);
+            expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/github-apps', expect.any(Object));
+        });
+        it('should list github apps with summary', async () => {
+            mockFetch.mockResolvedValueOnce(mockResponse([mockGitHubApp]));
+            const result = await client.listGitHubApps({ summary: true });
+            expect(result).toEqual([
+                {
+                    id: 1,
+                    uuid: 'gh-app-uuid',
+                    name: 'my-github-app',
+                    organization: null,
+                    is_public: false,
+                    app_id: 12345,
+                },
+            ]);
+        });
+        it('should create a github app', async () => {
+            mockFetch.mockResolvedValueOnce(mockResponse(mockGitHubApp));
+            const result = await client.createGitHubApp({
+                name: 'my-github-app',
+                api_url: 'https://api.github.com',
+                html_url: 'https://github.com',
+                app_id: 12345,
+                installation_id: 67890,
+                client_id: 'client-123',
+                client_secret: 'secret-456',
+                private_key_uuid: 'key-uuid',
+            });
+            expect(result).toEqual(mockGitHubApp);
+            expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/github-apps', expect.objectContaining({ method: 'POST' }));
+        });
+        it('should update a github app', async () => {
+            const updateResponse = { message: 'GitHub app updated successfully', data: mockGitHubApp };
+            mockFetch.mockResolvedValueOnce(mockResponse(updateResponse));
+            const result = await client.updateGitHubApp(1, { name: 'updated-app' });
+            expect(result).toEqual(updateResponse);
+            expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/github-apps/1', expect.objectContaining({
+                method: 'PATCH',
+                body: JSON.stringify({ name: 'updated-app' }),
+            }));
+        });
+        it('should delete a github app', async () => {
+            mockFetch.mockResolvedValueOnce(mockResponse({ message: 'GitHub app deleted successfully' }));
+            const result = await client.deleteGitHubApp(1);
+            expect(result).toEqual({ message: 'GitHub app deleted successfully' });
+            expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/github-apps/1', expect.objectContaining({ method: 'DELETE' }));
+        });
+    });
     describe('error handling', () => {
         it('should handle network errors', async () => {
             mockFetch.mockRejectedValueOnce(new TypeError('fetch failed'));
@@ -610,11 +687,76 @@ describe('CoolifyClient', () => {
             expect(result).toEqual({ uuid: 'new-app-uuid' });
             expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/applications/dockercompose', expect.objectContaining({ method: 'POST' }));
         });
+        /**
+         * Issue #76 - Client Layer Behavior Test
+         *
+         * This test documents that the client passes through whatever data it receives.
+         * The client itself is NOT buggy - it correctly sends all fields to the API.
+         *
+         * The FIX for #76 is in mcp-server.ts which now strips 'action' before
+         * calling client methods. This test ensures the client behavior remains
+         * predictable (pass-through) so the MCP server layer must handle filtering.
+         */
+        it('client passes through action field when included in create data (documents #76 fix location)', async () => {
+            mockFetch.mockResolvedValueOnce(mockResponse({ uuid: 'new-app-uuid' }));
+            // This simulates what mcp-server.ts does: passing full args with action
+            const argsFromMcpTool = {
+                action: 'create_public', // This should NOT be sent to the API
+                project_uuid: 'proj-uuid',
+                server_uuid: 'server-uuid',
+                git_repository: 'https://github.com/user/repo',
+                git_branch: 'main',
+                build_pack: 'nixpacks',
+                ports_exposes: '3000',
+            };
+            await client.createApplicationPublic(argsFromMcpTool);
+            // This assertion proves the bug: 'action' IS included in the request body
+            expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/applications/public', expect.objectContaining({
+                method: 'POST',
+                body: expect.stringContaining('"action":"create_public"'),
+            }));
+        });
         it('should update an application', async () => {
             mockFetch.mockResolvedValueOnce(mockResponse({ ...mockApplication, name: 'updated-app' }));
             const result = await client.updateApplication('app-uuid', { name: 'updated-app' });
             expect(result.name).toBe('updated-app');
         });
+        it('should update an application and verify request body', async () => {
+            mockFetch.mockResolvedValueOnce(mockResponse({ ...mockApplication, name: 'updated-app' }));
+            await client.updateApplication('app-uuid', { name: 'updated-app', description: 'new desc' });
+            expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/applications/app-uuid', expect.objectContaining({
+                method: 'PATCH',
+                body: JSON.stringify({ name: 'updated-app', description: 'new desc' }),
+            }));
+        });
+        /**
+         * Issue #76 - Client Layer Behavior Test
+         *
+         * This test documents that the client passes through whatever data it receives.
+         * The client itself is NOT buggy - it correctly sends all fields to the API.
+         *
+         * The FIX for #76 is in mcp-server.ts which now strips 'action' before
+         * calling client methods. This test ensures the client behavior remains
+         * predictable (pass-through) so the MCP server layer must handle filtering.
+         */
+        it('client passes through action field when included in update data (documents #76 fix location)', async () => {
+            mockFetch.mockResolvedValueOnce(mockResponse({ ...mockApplication, name: 'updated-app' }));
+            // This simulates what mcp-server.ts does: passing the full args object including 'action'
+            const argsFromMcpTool = {
+                action: 'update', // This should NOT be sent to the API
+                uuid: 'app-uuid', // This is extracted separately
+                name: 'updated-app',
+                description: 'new desc',
+            };
+            // The client passes whatever it receives to the API
+            await client.updateApplication('app-uuid', argsFromMcpTool);
+            // This assertion proves the bug: 'action' IS included in the request body
+            // The Coolify API will reject this with "action: This field is not allowed"
+            expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/applications/app-uuid', expect.objectContaining({
+                method: 'PATCH',
+                body: expect.stringContaining('"action":"update"'),
+            }));
+        });
         it('should delete an application', async () => {
             mockFetch.mockResolvedValueOnce(mockResponse({ message: 'Deleted' }));
             const result = await client.deleteApplication('app-uuid');

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

@@ -6,7 +6,7 @@
  * These tests verify MCP server instantiation and structure.
  */
 import { describe, it, expect, beforeEach } from '@jest/globals';
-import { CoolifyMcpServer } from '../lib/mcp-server.js';
+import { CoolifyMcpServer, truncateLogs } from '../lib/mcp-server.js';
 describe('CoolifyMcpServer v2', () => {
     let server;
     beforeEach(() => {
@@ -107,6 +107,11 @@ describe('CoolifyMcpServer v2', () => {
             expect(typeof client.createPrivateKey).toBe('function');
             expect(typeof client.updatePrivateKey).toBe('function');
             expect(typeof client.deletePrivateKey).toBe('function');
+            // GitHub App operations
+            expect(typeof client.listGitHubApps).toBe('function');
+            expect(typeof client.createGitHubApp).toBe('function');
+            expect(typeof client.updateGitHubApp).toBe('function');
+            expect(typeof client.deleteGitHubApp).toBe('function');
             // Backup operations
             expect(typeof client.listDatabaseBackups).toBe('function');
             expect(typeof client.getDatabaseBackup).toBe('function');
@@ -135,3 +140,49 @@ describe('CoolifyMcpServer v2', () => {
         });
     });
 });
+describe('truncateLogs', () => {
+    it('should return logs unchanged when within limits', () => {
+        const logs = 'line1\nline2\nline3';
+        const result = truncateLogs(logs, 200, 50000);
+        expect(result).toBe(logs);
+    });
+    it('should truncate to last N lines', () => {
+        const logs = 'line1\nline2\nline3\nline4\nline5';
+        const result = truncateLogs(logs, 3, 50000);
+        expect(result).toBe('line3\nline4\nline5');
+    });
+    it('should truncate by character limit when lines are huge', () => {
+        const hugeLine = 'x'.repeat(100);
+        const logs = `${hugeLine}\n${hugeLine}\n${hugeLine}`;
+        const result = truncateLogs(logs, 200, 50);
+        expect(result.length).toBeLessThanOrEqual(50);
+        expect(result.startsWith('...[truncated]...')).toBe(true);
+    });
+    it('should not add truncation prefix when under char limit', () => {
+        const logs = 'line1\nline2\nline3';
+        const result = truncateLogs(logs, 200, 50000);
+        expect(result.startsWith('...[truncated]...')).toBe(false);
+    });
+    it('should handle empty logs', () => {
+        const result = truncateLogs('', 200, 50000);
+        expect(result).toBe('');
+    });
+    it('should use default limits when not specified', () => {
+        const logs = 'line1\nline2';
+        const result = truncateLogs(logs);
+        expect(result).toBe(logs);
+    });
+    it('should respect custom line limit', () => {
+        const lines = Array.from({ length: 300 }, (_, i) => `line${i + 1}`).join('\n');
+        const result = truncateLogs(lines, 50, 50000);
+        const resultLines = result.split('\n');
+        expect(resultLines.length).toBe(50);
+        expect(resultLines[0]).toBe('line251');
+        expect(resultLines[49]).toBe('line300');
+    });
+    it('should respect custom char limit', () => {
+        const logs = 'x'.repeat(1000);
+        const result = truncateLogs(logs, 200, 100);
+        expect(result.length).toBe(100);
+    });
+});

package/dist/lib/coolify-client.d.ts

@@ -2,7 +2,7 @@
  * Coolify API Client
  * Complete HTTP client for the Coolify API v1
  */
-import type { CoolifyConfig, DeleteOptions, MessageResponse, UuidResponse, Server, ServerResource, ServerDomain, ServerValidation, CreateServerRequest, UpdateServerRequest, Project, CreateProjectRequest, UpdateProjectRequest, Environment, CreateEnvironmentRequest, Application, CreateApplicationPublicRequest, CreateApplicationPrivateGHRequest, CreateApplicationPrivateKeyRequest, CreateApplicationDockerfileRequest, CreateApplicationDockerImageRequest, CreateApplicationDockerComposeRequest, UpdateApplicationRequest, ApplicationActionResponse, EnvironmentVariable, EnvVarSummary, CreateEnvVarRequest, UpdateEnvVarRequest, BulkUpdateEnvVarsRequest, Database, UpdateDatabaseRequest, CreatePostgresqlRequest, CreateMysqlRequest, CreateMariadbRequest, CreateMongodbRequest, CreateRedisRequest, CreateKeydbRequest, CreateClickhouseRequest, CreateDragonflyRequest, CreateDatabaseResponse, DatabaseBackup, BackupExecution, CreateDatabaseBackupRequest, UpdateDatabaseBackupRequest, Service, CreateServiceRequest, UpdateServiceRequest, ServiceCreateResponse, Deployment, Team, TeamMember, PrivateKey, CreatePrivateKeyRequest, UpdatePrivateKeyRequest, CloudToken, CreateCloudTokenRequest, UpdateCloudTokenRequest, CloudTokenValidation, Version, ApplicationDiagnostic, ServerDiagnostic, InfrastructureIssuesReport, BatchOperationResult } from '../types/coolify.js';
+import type { CoolifyConfig, DeleteOptions, MessageResponse, UuidResponse, Server, ServerResource, ServerDomain, ServerValidation, CreateServerRequest, UpdateServerRequest, Project, CreateProjectRequest, UpdateProjectRequest, Environment, CreateEnvironmentRequest, Application, CreateApplicationPublicRequest, CreateApplicationPrivateGHRequest, CreateApplicationPrivateKeyRequest, CreateApplicationDockerfileRequest, CreateApplicationDockerImageRequest, CreateApplicationDockerComposeRequest, UpdateApplicationRequest, ApplicationActionResponse, EnvironmentVariable, EnvVarSummary, CreateEnvVarRequest, UpdateEnvVarRequest, BulkUpdateEnvVarsRequest, Database, UpdateDatabaseRequest, CreatePostgresqlRequest, CreateMysqlRequest, CreateMariadbRequest, CreateMongodbRequest, CreateRedisRequest, CreateKeydbRequest, CreateClickhouseRequest, CreateDragonflyRequest, CreateDatabaseResponse, DatabaseBackup, BackupExecution, CreateDatabaseBackupRequest, UpdateDatabaseBackupRequest, Service, CreateServiceRequest, UpdateServiceRequest, ServiceCreateResponse, Deployment, Team, TeamMember, PrivateKey, CreatePrivateKeyRequest, UpdatePrivateKeyRequest, GitHubApp, CreateGitHubAppRequest, UpdateGitHubAppRequest, GitHubAppUpdateResponse, CloudToken, CreateCloudTokenRequest, UpdateCloudTokenRequest, CloudTokenValidation, Version, ApplicationDiagnostic, ServerDiagnostic, InfrastructureIssuesReport, BatchOperationResult } from '../types/coolify.js';
 export interface ListOptions {
     page?: number;
     per_page?: number;
@@ -55,6 +55,14 @@ export interface ProjectSummary {
     name: string;
     description?: string;
 }
+export interface GitHubAppSummary {
+    id: number;
+    uuid: string;
+    name: string;
+    organization: string | null;
+    is_public: boolean;
+    app_id: number | null;
+}
 /**
  * HTTP client for the Coolify API
  */
@@ -148,6 +156,10 @@ export declare class CoolifyClient {
     createPrivateKey(data: CreatePrivateKeyRequest): Promise<UuidResponse>;
     updatePrivateKey(uuid: string, data: UpdatePrivateKeyRequest): Promise<PrivateKey>;
     deletePrivateKey(uuid: string): Promise<MessageResponse>;
+    listGitHubApps(options?: ListOptions): Promise<GitHubApp[] | GitHubAppSummary[]>;
+    createGitHubApp(data: CreateGitHubAppRequest): Promise<GitHubApp>;
+    updateGitHubApp(id: number, data: UpdateGitHubAppRequest): Promise<GitHubAppUpdateResponse>;
+    deleteGitHubApp(id: number): Promise<MessageResponse>;
     listCloudTokens(): Promise<CloudToken[]>;
     getCloudToken(uuid: string): Promise<CloudToken>;
     createCloudToken(data: CreateCloudTokenRequest): Promise<UuidResponse>;

package/dist/lib/coolify-client.js

@@ -71,6 +71,16 @@ function toProjectSummary(proj) {
         description: proj.description,
     };
 }
+function toGitHubAppSummary(app) {
+    return {
+        id: app.id,
+        uuid: app.uuid,
+        name: app.name,
+        organization: app.organization,
+        is_public: app.is_public,
+        app_id: app.app_id,
+    };
+}
 function toEnvVarSummary(envVar) {
     return {
         uuid: envVar.uuid,
@@ -613,6 +623,30 @@ export class CoolifyClient {
         });
     }
     // ===========================================================================
+    // GitHub App endpoints
+    // ===========================================================================
+    async listGitHubApps(options) {
+        const apps = await this.request('/github-apps');
+        return options?.summary && Array.isArray(apps) ? apps.map(toGitHubAppSummary) : apps;
+    }
+    async createGitHubApp(data) {
+        return this.request('/github-apps', {
+            method: 'POST',
+            body: JSON.stringify(data),
+        });
+    }
+    async updateGitHubApp(id, data) {
+        return this.request(`/github-apps/${id}`, {
+            method: 'PATCH',
+            body: JSON.stringify(cleanRequestData(data)),
+        });
+    }
+    async deleteGitHubApp(id) {
+        return this.request(`/github-apps/${id}`, {
+            method: 'DELETE',
+        });
+    }
+    // ===========================================================================
     // Cloud Token endpoints (Hetzner, DigitalOcean)
     // ===========================================================================
     async listCloudTokens() {

package/dist/lib/mcp-server.d.ts

@@ -1,10 +1,15 @@
 /**
- * Coolify MCP Server v2.3.0
+ * Coolify MCP Server v2.4.0
  * Consolidated tools for efficient token usage
  */
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
 import type { CoolifyConfig } from '../types/coolify.js';
+/**
+ * Truncate logs by line count and character count.
+ * Exported for testing.
+ */
+export declare function truncateLogs(logs: string, lineLimit?: number, charLimit?: number): string;
 export declare class CoolifyMcpServer extends McpServer {
     private readonly client;
     constructor(config: CoolifyConfig);

package/dist/lib/mcp-server.js

@@ -1,12 +1,11 @@
 /**
- * Coolify MCP Server v2.3.0
+ * Coolify MCP Server v2.4.0
  * Consolidated tools for efficient token usage
  */
-/* eslint-disable @typescript-eslint/no-explicit-any */
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
 import { CoolifyClient, } from './coolify-client.js';
-const VERSION = '2.3.0';
+const VERSION = '2.5.0';
 /** Wrap handler with error handling */
 function wrap(fn) {
     return fn()
@@ -22,6 +21,24 @@ function wrap(fn) {
         ],
     }));
 }
+const TRUNCATION_PREFIX = '...[truncated]...\n';
+/**
+ * Truncate logs by line count and character count.
+ * Exported for testing.
+ */
+export function truncateLogs(logs, lineLimit = 200, charLimit = 50000) {
+    // First: limit by lines
+    const logLines = logs.split('\n');
+    const limitedLines = logLines.slice(-lineLimit);
+    let truncatedLogs = limitedLines.join('\n');
+    // Second: limit by characters (safety net for huge lines)
+    if (truncatedLogs.length > charLimit) {
+        // Account for prefix length to stay within limit
+        const prefixLen = TRUNCATION_PREFIX.length;
+        truncatedLogs = TRUNCATION_PREFIX + truncatedLogs.slice(-(charLimit - prefixLen));
+    }
+    return truncatedLogs;
+}
 export class CoolifyMcpServer extends McpServer {
     constructor(config) {
         super({ name: 'coolify', version: VERSION });
@@ -205,7 +222,7 @@ export class CoolifyMcpServer extends McpServer {
             // Delete fields
             delete_volumes: z.boolean().optional(),
         }, async (args) => {
-            const { action, uuid } = args;
+            const { action, uuid, delete_volumes } = args;
             switch (action) {
                 case 'create_public':
                     if (!args.project_uuid ||
@@ -223,7 +240,19 @@ export class CoolifyMcpServer extends McpServer {
                             ],
                         };
                     }
-                    return wrap(() => this.client.createApplicationPublic(args));
+                    return wrap(() => this.client.createApplicationPublic({
+                        project_uuid: args.project_uuid,
+                        server_uuid: args.server_uuid,
+                        git_repository: args.git_repository,
+                        git_branch: args.git_branch,
+                        build_pack: args.build_pack,
+                        ports_exposes: args.ports_exposes,
+                        environment_name: args.environment_name,
+                        environment_uuid: args.environment_uuid,
+                        name: args.name,
+                        description: args.description,
+                        fqdn: args.fqdn,
+                    }));
                 case 'create_github':
                     if (!args.project_uuid ||
                         !args.server_uuid ||
@@ -239,7 +268,20 @@ export class CoolifyMcpServer extends McpServer {
                             ],
                         };
                     }
-                    return wrap(() => this.client.createApplicationPrivateGH(args));
+                    return wrap(() => this.client.createApplicationPrivateGH({
+                        project_uuid: args.project_uuid,
+                        server_uuid: args.server_uuid,
+                        github_app_uuid: args.github_app_uuid,
+                        git_repository: args.git_repository,
+                        git_branch: args.git_branch,
+                        build_pack: args.build_pack,
+                        ports_exposes: args.ports_exposes,
+                        environment_name: args.environment_name,
+                        environment_uuid: args.environment_uuid,
+                        name: args.name,
+                        description: args.description,
+                        fqdn: args.fqdn,
+                    }));
                 case 'create_key':
                     if (!args.project_uuid ||
                         !args.server_uuid ||
@@ -255,7 +297,20 @@ export class CoolifyMcpServer extends McpServer {
                             ],
                         };
                     }
-                    return wrap(() => this.client.createApplicationPrivateKey(args));
+                    return wrap(() => this.client.createApplicationPrivateKey({
+                        project_uuid: args.project_uuid,
+                        server_uuid: args.server_uuid,
+                        private_key_uuid: args.private_key_uuid,
+                        git_repository: args.git_repository,
+                        git_branch: args.git_branch,
+                        build_pack: args.build_pack,
+                        ports_exposes: args.ports_exposes,
+                        environment_name: args.environment_name,
+                        environment_uuid: args.environment_uuid,
+                        name: args.name,
+                        description: args.description,
+                        fqdn: args.fqdn,
+                    }));
                 case 'create_dockerimage':
                     if (!args.project_uuid ||
                         !args.server_uuid ||
@@ -270,15 +325,29 @@ export class CoolifyMcpServer extends McpServer {
                             ],
                         };
                     }
-                    return wrap(() => this.client.createApplicationDockerImage(args));
-                case 'update':
+                    return wrap(() => this.client.createApplicationDockerImage({
+                        project_uuid: args.project_uuid,
+                        server_uuid: args.server_uuid,
+                        docker_registry_image_name: args.docker_registry_image_name,
+                        ports_exposes: args.ports_exposes,
+                        docker_registry_image_tag: args.docker_registry_image_tag,
+                        environment_name: args.environment_name,
+                        environment_uuid: args.environment_uuid,
+                        name: args.name,
+                        description: args.description,
+                        fqdn: args.fqdn,
+                    }));
+                case 'update': {
                     if (!uuid)
                         return { content: [{ type: 'text', text: 'Error: uuid required' }] };
-                    return wrap(() => this.client.updateApplication(uuid, args));
+                    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+                    const { action: _, uuid: __, delete_volumes: ___, ...updateData } = args;
+                    return wrap(() => this.client.updateApplication(uuid, updateData));
+                }
                 case 'delete':
                     if (!uuid)
                         return { content: [{ type: 'text', text: 'Error: uuid required' }] };
-                    return wrap(() => this.client.deleteApplication(uuid, { deleteVolumes: args.delete_volumes }));
+                    return wrap(() => this.client.deleteApplication(uuid, { deleteVolumes: delete_volumes }));
             }
         });
         this.tool('application_logs', 'Get app logs', { uuid: z.string(), lines: z.number().optional() }, async ({ uuid, lines }) => wrap(() => this.client.getApplicationLogs(uuid, lines)));
@@ -377,7 +446,7 @@ export class CoolifyMcpServer extends McpServer {
             docker_compose_raw: z.string().optional(),
             delete_volumes: z.boolean().optional(),
         }, async (args) => {
-            const { action, uuid } = args;
+            const { action, uuid, delete_volumes } = args;
             switch (action) {
                 case 'create':
                     if (!args.server_uuid || !args.project_uuid) {
@@ -387,15 +456,27 @@ export class CoolifyMcpServer extends McpServer {
                             ],
                         };
                     }
-                    return wrap(() => this.client.createService(args));
-                case 'update':
+                    return wrap(() => this.client.createService({
+                        project_uuid: args.project_uuid,
+                        server_uuid: args.server_uuid,
+                        type: args.type,
+                        name: args.name,
+                        description: args.description,
+                        environment_name: args.environment_name,
+                        instant_deploy: args.instant_deploy,
+                        docker_compose_raw: args.docker_compose_raw,
+                    }));
+                case 'update': {
                     if (!uuid)
                         return { content: [{ type: 'text', text: 'Error: uuid required' }] };
-                    return wrap(() => this.client.updateService(uuid, args));
+                    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+                    const { action: _, uuid: __, delete_volumes: ___, ...updateData } = args;
+                    return wrap(() => this.client.updateService(uuid, updateData));
+                }
                 case 'delete':
                     if (!uuid)
                         return { content: [{ type: 'text', text: 'Error: uuid required' }] };
-                    return wrap(() => this.client.deleteService(uuid, { deleteVolumes: args.delete_volumes }));
+                    return wrap(() => this.client.deleteService(uuid, { deleteVolumes: delete_volumes }));
             }
         });
         // =========================================================================
@@ -481,21 +562,18 @@ export class CoolifyMcpServer extends McpServer {
         // =========================================================================
         this.tool('list_deployments', 'List deployments (summary)', { page: z.number().optional(), per_page: z.number().optional() }, async ({ page, per_page }) => wrap(() => this.client.listDeployments({ page, per_page, summary: true })));
         this.tool('deploy', 'Deploy by tag/UUID', { tag_or_uuid: z.string(), force: z.boolean().optional() }, async ({ tag_or_uuid, force }) => wrap(() => this.client.deployByTagOrUuid(tag_or_uuid, force)));
-        this.tool('deployment', 'Manage deployment: get/cancel/list_for_app', {
+        this.tool('deployment', 'Manage deployment: get/cancel/list_for_app (logs truncated to last 200 lines/50K chars by default)', {
             action: z.enum(['get', 'cancel', 'list_for_app']),
             uuid: z.string(),
-            lines: z.number().optional(), // Limit log output to last N lines (for 'get' action)
-        }, async ({ action, uuid, lines }) => {
+            lines: z.number().optional(), // Limit log output to last N lines (default: 200)
+            max_chars: z.number().optional(), // Limit log output to last N chars (default: 50000)
+        }, async ({ action, uuid, lines, max_chars }) => {
             switch (action) {
                 case 'get':
                     return wrap(async () => {
                         const deployment = await this.client.getDeployment(uuid);
-                        // Truncate logs to last N lines if specified
-                        if (lines && deployment.logs) {
-                            const logLines = deployment.logs.split('\n');
-                            if (logLines.length > lines) {
-                                deployment.logs = logLines.slice(-lines).join('\n');
-                            }
+                        if (deployment.logs) {
+                            deployment.logs = truncateLogs(deployment.logs, lines ?? 200, max_chars ?? 50000);
                         }
                         return deployment;
                     });
@@ -541,6 +619,90 @@ export class CoolifyMcpServer extends McpServer {
             }
         });
         // =========================================================================
+        // GitHub Apps (1 tool - consolidated)
+        // =========================================================================
+        this.tool('github_apps', 'Manage GitHub Apps: list/get/create/update/delete', {
+            action: z.enum(['list', 'get', 'create', 'update', 'delete']),
+            // GitHub apps use integer id, not uuid
+            id: z.number().optional(),
+            // Create/Update fields
+            name: z.string().optional(),
+            organization: z.string().optional(),
+            api_url: z.string().optional(),
+            html_url: z.string().optional(),
+            custom_user: z.string().optional(),
+            custom_port: z.number().optional(),
+            app_id: z.number().optional(),
+            installation_id: z.number().optional(),
+            client_id: z.string().optional(),
+            client_secret: z.string().optional(),
+            webhook_secret: z.string().optional(),
+            private_key_uuid: z.string().optional(),
+            is_system_wide: z.boolean().optional(),
+        }, async (args) => {
+            const { action, id, ...apiData } = args;
+            switch (action) {
+                case 'list':
+                    return wrap(async () => {
+                        const apps = (await this.client.listGitHubApps({
+                            summary: true,
+                        }));
+                        return apps;
+                    });
+                case 'get':
+                    if (!id)
+                        return { content: [{ type: 'text', text: 'Error: id required' }] };
+                    return wrap(async () => {
+                        const apps = (await this.client.listGitHubApps());
+                        const app = apps.find((a) => a.id === id);
+                        if (!app)
+                            throw new Error(`GitHub App with id ${id} not found`);
+                        return app;
+                    });
+                case 'create':
+                    if (!apiData.name ||
+                        !apiData.api_url ||
+                        !apiData.html_url ||
+                        !apiData.app_id ||
+                        !apiData.installation_id ||
+                        !apiData.client_id ||
+                        !apiData.client_secret ||
+                        !apiData.private_key_uuid) {
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: 'Error: name, api_url, html_url, app_id, installation_id, client_id, client_secret, private_key_uuid required',
+                                },
+                            ],
+                        };
+                    }
+                    return wrap(() => this.client.createGitHubApp({
+                        name: apiData.name,
+                        api_url: apiData.api_url,
+                        html_url: apiData.html_url,
+                        app_id: apiData.app_id,
+                        installation_id: apiData.installation_id,
+                        client_id: apiData.client_id,
+                        client_secret: apiData.client_secret,
+                        private_key_uuid: apiData.private_key_uuid,
+                        organization: apiData.organization,
+                        custom_user: apiData.custom_user,
+                        custom_port: apiData.custom_port,
+                        webhook_secret: apiData.webhook_secret,
+                        is_system_wide: apiData.is_system_wide,
+                    }));
+                case 'update':
+                    if (!id)
+                        return { content: [{ type: 'text', text: 'Error: id required' }] };
+                    return wrap(() => this.client.updateGitHubApp(id, apiData));
+                case 'delete':
+                    if (!id)
+                        return { content: [{ type: 'text', text: 'Error: id required' }] };
+                    return wrap(() => this.client.deleteGitHubApp(id));
+            }
+        });
+        // =========================================================================
         // Database Backups (1 tool - consolidated)
         // =========================================================================
         this.tool('database_backups', 'Manage backups: list_schedules/get_schedule/list_executions/get_execution/create/update/delete', {

package/dist/types/coolify.d.ts

@@ -224,11 +224,15 @@ export interface CreateApplicationPublicRequest {
     start_command?: string;
     instant_deploy?: boolean;
 }
-export interface CreateApplicationPrivateGHRequest extends CreateApplicationPublicRequest {
+export interface CreateApplicationPrivateGHRequest extends Omit<CreateApplicationPublicRequest, 'build_pack' | 'ports_exposes'> {
     github_app_uuid: string;
+    build_pack?: BuildPack;
+    ports_exposes?: string;
 }
-export interface CreateApplicationPrivateKeyRequest extends CreateApplicationPublicRequest {
+export interface CreateApplicationPrivateKeyRequest extends Omit<CreateApplicationPublicRequest, 'build_pack' | 'ports_exposes'> {
     private_key_uuid: string;
+    build_pack?: BuildPack;
+    ports_exposes?: string;
 }
 export interface CreateApplicationDockerfileRequest {
     project_uuid: string;
@@ -718,6 +722,64 @@ export interface UpdatePrivateKeyRequest {
     description?: string;
     private_key?: string;
 }
+export interface GitHubApp {
+    id: number;
+    uuid: string;
+    name: string;
+    organization: string | null;
+    api_url: string;
+    html_url: string;
+    custom_user: string;
+    custom_port: number;
+    app_id: number | null;
+    installation_id: number | null;
+    client_id: string | null;
+    is_system_wide: boolean;
+    is_public: boolean;
+    private_key_id: number | null;
+    team_id: number;
+    type: string;
+    administration: string | null;
+    contents: string | null;
+    metadata: string | null;
+    pull_requests: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface CreateGitHubAppRequest {
+    name: string;
+    api_url: string;
+    html_url: string;
+    app_id: number;
+    installation_id: number;
+    client_id: string;
+    client_secret: string;
+    private_key_uuid: string;
+    organization?: string;
+    custom_user?: string;
+    custom_port?: number;
+    webhook_secret?: string;
+    is_system_wide?: boolean;
+}
+export interface UpdateGitHubAppRequest {
+    name?: string;
+    organization?: string;
+    api_url?: string;
+    html_url?: string;
+    custom_user?: string;
+    custom_port?: number;
+    app_id?: number;
+    installation_id?: number;
+    client_id?: string;
+    client_secret?: string;
+    webhook_secret?: string;
+    private_key_uuid?: string;
+    is_system_wide?: boolean;
+}
+export interface GitHubAppUpdateResponse {
+    message: string;
+    data: GitHubApp;
+}
 export type CloudProvider = 'hetzner' | 'digitalocean';
 export interface CloudToken {
     id: number;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@masonator/coolify-mcp",
   "scope": "@masonator",
-  "version": "2.3.0",
+  "version": "2.5.0",
   "description": "MCP server implementation for Coolify",
   "type": "module",
   "main": "./dist/index.js",
@@ -59,6 +59,7 @@
     "globals": "^17.0.0",
     "husky": "^9.0.11",
     "jest": "^29.7.0",
+    "jest-junit": "^16.0.0",
     "lint-staged": "^16.2.7",
     "markdownlint-cli2": "^0.20.0",
     "prettier": "^3.5.3",