@masonator/coolify-mcp 2.3.0 → 2.4.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
 
@@ -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

@@ -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');

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,5 +1,5 @@
 /**
- * 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';

package/dist/lib/mcp-server.js

@@ -1,12 +1,12 @@
 /**
- * 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.4.0';
 /** Wrap handler with error handling */
 function wrap(fn) {
     return fn()
@@ -205,7 +205,8 @@ export class CoolifyMcpServer extends McpServer {
             // Delete fields
             delete_volumes: z.boolean().optional(),
         }, async (args) => {
-            const { action, uuid } = args;
+            // Strip MCP-internal fields before passing to API (fixes #76)
+            const { action, uuid, delete_volumes, ...apiData } = args;
             switch (action) {
                 case 'create_public':
                     if (!args.project_uuid ||
@@ -223,7 +224,7 @@ export class CoolifyMcpServer extends McpServer {
                             ],
                         };
                     }
-                    return wrap(() => this.client.createApplicationPublic(args));
+                    return wrap(() => this.client.createApplicationPublic(apiData));
                 case 'create_github':
                     if (!args.project_uuid ||
                         !args.server_uuid ||
@@ -239,7 +240,7 @@ export class CoolifyMcpServer extends McpServer {
                             ],
                         };
                     }
-                    return wrap(() => this.client.createApplicationPrivateGH(args));
+                    return wrap(() => this.client.createApplicationPrivateGH(apiData));
                 case 'create_key':
                     if (!args.project_uuid ||
                         !args.server_uuid ||
@@ -255,7 +256,7 @@ export class CoolifyMcpServer extends McpServer {
                             ],
                         };
                     }
-                    return wrap(() => this.client.createApplicationPrivateKey(args));
+                    return wrap(() => this.client.createApplicationPrivateKey(apiData));
                 case 'create_dockerimage':
                     if (!args.project_uuid ||
                         !args.server_uuid ||
@@ -270,15 +271,15 @@ export class CoolifyMcpServer extends McpServer {
                             ],
                         };
                     }
-                    return wrap(() => this.client.createApplicationDockerImage(args));
+                    return wrap(() => this.client.createApplicationDockerImage(apiData));
                 case 'update':
                     if (!uuid)
                         return { content: [{ type: 'text', text: 'Error: uuid required' }] };
-                    return wrap(() => this.client.updateApplication(uuid, args));
+                    return wrap(() => this.client.updateApplication(uuid, apiData));
                 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 +378,8 @@ export class CoolifyMcpServer extends McpServer {
             docker_compose_raw: z.string().optional(),
             delete_volumes: z.boolean().optional(),
         }, async (args) => {
-            const { action, uuid } = args;
+            // Strip MCP-internal fields before passing to API (fixes #76)
+            const { action, uuid, delete_volumes, ...apiData } = args;
             switch (action) {
                 case 'create':
                     if (!args.server_uuid || !args.project_uuid) {
@@ -387,15 +389,15 @@ export class CoolifyMcpServer extends McpServer {
                             ],
                         };
                     }
-                    return wrap(() => this.client.createService(args));
+                    return wrap(() => this.client.createService(apiData));
                 case 'update':
                     if (!uuid)
                         return { content: [{ type: 'text', text: 'Error: uuid required' }] };
-                    return wrap(() => this.client.updateService(uuid, args));
+                    return wrap(() => this.client.updateService(uuid, apiData));
                 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 }));
             }
         });
         // =========================================================================
@@ -541,6 +543,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

@@ -718,6 +718,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.4.0",
   "description": "MCP server implementation for Coolify",
   "type": "module",
   "main": "./dist/index.js",