@masonator/coolify-mcp 0.8.0 → 0.9.0

package/README.md

@@ -1,24 +1,26 @@
-[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/stumason-coolify-mcp-badge.png)](https://mseep.ai/app/stumason-coolify-mcp)
-
 # Coolify MCP Server
 
+[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/stumason-coolify-mcp-badge.png)](https://mseep.ai/app/stumason-coolify-mcp)
+
 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 **58 tools** focused on **debugging, management, and deployment**:
-
-| Category           | Tools                                                                                                    |
-| ------------------ | -------------------------------------------------------------------------------------------------------- |
-| **Infrastructure** | overview (all resources at once)                                                                         |
-| **Servers**        | list, get, validate, resources, domains                                                                  |
-| **Projects**       | list, get, create, update, delete                                                                        |
-| **Environments**   | list, get, create, delete                                                                                |
-| **Applications**   | list, get, update, delete, start, stop, restart, logs, env vars (CRUD), create (private-gh, private-key) |
-| **Databases**      | list, get, start, stop, restart, backups (list, get), backup executions (list, get)                      |
-| **Services**       | list, get, create, update, delete, start, stop, restart, env vars (list, create, delete)                 |
-| **Deployments**    | list, get, deploy, cancel, list by application                                                           |
-| **Private Keys**   | list, get, create, update, delete                                                                        |
+This MCP server provides **65 tools** focused on **debugging, management, and deployment**:
+
+| Category             | Tools                                                                                                    |
+| -------------------- | -------------------------------------------------------------------------------------------------------- |
+| **Infrastructure**   | overview (all resources at once)                                                                         |
+| **Diagnostics**      | diagnose_app, diagnose_server, find_issues (smart lookup by name/domain/IP)                              |
+| **Batch Operations** | restart_project_apps, bulk_env_update, stop_all_apps, redeploy_project                                   |
+| **Servers**          | list, get, validate, resources, domains                                                                  |
+| **Projects**         | list, get, create, update, delete                                                                        |
+| **Environments**     | list, get, create, delete                                                                                |
+| **Applications**     | list, get, update, delete, start, stop, restart, logs, env vars (CRUD), create (private-gh, private-key) |
+| **Databases**        | list, get, start, stop, restart, backups (list, get), backup executions (list, get)                      |
+| **Services**         | list, get, create, update, delete, start, stop, restart, env vars (list, create, delete)                 |
+| **Deployments**      | list, get, deploy, cancel, list by application                                                           |
+| **Private Keys**     | list, get, create, update, delete                                                                        |
 
 ## Installation
 
@@ -82,11 +84,12 @@ The Coolify API returns extremely verbose responses - a single application can c
 
 ### Response Size Comparison
 
-| Endpoint          | Full Response | Summary Response | Reduction |
-| ----------------- | ------------- | ---------------- | --------- |
-| list_applications | ~170KB        | ~4.4KB           | **97%**   |
-| list_services     | ~367KB        | ~1.2KB           | **99%**   |
-| list_servers      | ~4KB          | ~0.4KB           | **90%**   |
+| Endpoint              | Full Response | Summary Response | Reduction |
+| --------------------- | ------------- | ---------------- | --------- |
+| list_applications     | ~170KB        | ~4.4KB           | **97%**   |
+| list_services         | ~367KB        | ~1.2KB           | **99%**   |
+| list_servers          | ~4KB          | ~0.4KB           | **90%**   |
+| list_application_envs | ~3KB/var      | ~0.1KB/var       | **97%**   |
 
 ### Recommended Workflow
 
@@ -108,7 +111,7 @@ list_applications(page=2, per_page=10)
 
 ### Getting Started
 
-```
+```text
 Give me an overview of my infrastructure
 Show me all my applications
 What's running on my servers?
@@ -116,9 +119,12 @@ What's running on my servers?
 
 ### Debugging & Monitoring
 
-```
+```text
+Diagnose my stuartmason.co.uk app
+What's wrong with my-api application?
+Check the status of server 192.168.1.100
+Find any issues in my infrastructure
 Get the logs for application {uuid}
-What's the status of application {uuid}?
 What environment variables are set for application {uuid}?
 Show me recent deployments for application {uuid}
 What resources are running on server {uuid}?
@@ -126,7 +132,7 @@ What resources are running on server {uuid}?
 
 ### Application Management
 
-```
+```text
 Restart application {uuid}
 Stop the database {uuid}
 Start service {uuid}
@@ -136,7 +142,7 @@ Update the DATABASE_URL env var for application {uuid}
 
 ### Project Setup
 
-```
+```text
 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
@@ -176,6 +182,14 @@ node dist/index.js
 - `get_version` - Get Coolify API version
 - `get_infrastructure_overview` - Get a high-level overview of all infrastructure (servers, projects, applications, databases, services)
 
+### Diagnostics (Smart Lookup)
+
+These tools accept human-friendly identifiers instead of just UUIDs:
+
+- `diagnose_app` - Get comprehensive app diagnostics (status, logs, env vars, deployments). Accepts UUID, name, or domain (e.g., "stuartmason.co.uk" or "my-app")
+- `diagnose_server` - Get server diagnostics (status, resources, domains, validation). Accepts UUID, name, or IP address (e.g., "coolify-apps" or "192.168.1.100")
+- `find_issues` - Scan entire infrastructure for unhealthy apps, databases, services, and unreachable servers
+
 ### Servers
 
 - `list_servers` - List all servers (returns summary)
@@ -258,6 +272,15 @@ node dist/index.js
 - `update_private_key` - Update a private key
 - `delete_private_key` - Delete a private key
 
+### Batch Operations
+
+Power user tools for operating on multiple resources at once:
+
+- `restart_project_apps` - Restart all applications in a project
+- `bulk_env_update` - Update or create an environment variable across multiple applications (upsert behavior)
+- `stop_all_apps` - Emergency stop all running applications (requires confirmation)
+- `redeploy_project` - Redeploy all applications in a project with force rebuild
+
 ## Contributing
 
 Contributions welcome! Please open an issue first to discuss major changes.

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

@@ -649,6 +649,34 @@ describe('CoolifyClient', () => {
             expect(result).toEqual([mockEnvVar]);
             expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/applications/app-uuid/envs', expect.any(Object));
         });
+        it('should list application env vars with summary', async () => {
+            const fullEnvVar = {
+                id: 1,
+                uuid: 'env-var-uuid',
+                key: 'API_KEY',
+                value: 'secret123',
+                is_build_time: false,
+                is_literal: true,
+                is_multiline: false,
+                is_preview: false,
+                is_shared: false,
+                is_shown_once: false,
+                application_id: 1,
+                created_at: '2024-01-01',
+                updated_at: '2024-01-01',
+            };
+            mockFetch.mockResolvedValueOnce(mockResponse([fullEnvVar]));
+            const result = await client.listApplicationEnvVars('app-uuid', { summary: true });
+            // Summary should only include uuid, key, value, is_build_time
+            expect(result).toEqual([
+                {
+                    uuid: 'env-var-uuid',
+                    key: 'API_KEY',
+                    value: 'secret123',
+                    is_build_time: false,
+                },
+            ]);
+        });
         it('should create application env var', async () => {
             mockFetch.mockResolvedValueOnce(mockResponse({ uuid: 'new-env-uuid' }));
             const result = await client.createApplicationEnvVar('app-uuid', {
@@ -1641,4 +1669,292 @@ describe('CoolifyClient', () => {
             });
         });
     });
+    // ===========================================================================
+    // Batch Operations Tests
+    // ===========================================================================
+    describe('Batch Operations', () => {
+        describe('restartProjectApps', () => {
+            const mockApps = [
+                {
+                    id: 1,
+                    uuid: 'app-1',
+                    name: 'app-one',
+                    project_uuid: 'proj-1',
+                    status: 'running',
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+                {
+                    id: 2,
+                    uuid: 'app-2',
+                    name: 'app-two',
+                    project_uuid: 'proj-1',
+                    status: 'running',
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+                {
+                    id: 3,
+                    uuid: 'app-3',
+                    name: 'app-three',
+                    project_uuid: 'proj-2', // Different project
+                    status: 'running',
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+            ];
+            it('should restart all apps in a project', async () => {
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(mockApps))
+                    .mockResolvedValueOnce(mockResponse({ message: 'Restarted' })) // app-1
+                    .mockResolvedValueOnce(mockResponse({ message: 'Restarted' })); // app-2
+                const result = await client.restartProjectApps('proj-1');
+                expect(result.summary.total).toBe(2);
+                expect(result.summary.succeeded).toBe(2);
+                expect(result.summary.failed).toBe(0);
+                expect(result.succeeded).toEqual([
+                    { uuid: 'app-1', name: 'app-one' },
+                    { uuid: 'app-2', name: 'app-two' },
+                ]);
+                expect(result.failed).toEqual([]);
+            });
+            it('should handle partial failures gracefully', async () => {
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(mockApps))
+                    .mockResolvedValueOnce(mockResponse({ message: 'Restarted' }))
+                    .mockRejectedValueOnce(new Error('App not running'));
+                const result = await client.restartProjectApps('proj-1');
+                expect(result.summary.succeeded).toBe(1);
+                expect(result.summary.failed).toBe(1);
+                expect(result.succeeded).toHaveLength(1);
+                expect(result.failed).toHaveLength(1);
+                expect(result.failed[0].error).toBe('App not running');
+            });
+            it('should return empty result for empty project', async () => {
+                mockFetch.mockResolvedValueOnce(mockResponse([]));
+                const result = await client.restartProjectApps('empty-project');
+                expect(result.summary.total).toBe(0);
+                expect(result.summary.succeeded).toBe(0);
+                expect(result.summary.failed).toBe(0);
+            });
+            it('should return empty result for project with no apps', async () => {
+                mockFetch.mockResolvedValueOnce(mockResponse(mockApps));
+                const result = await client.restartProjectApps('nonexistent-project');
+                expect(result.summary.total).toBe(0);
+            });
+        });
+        describe('bulkEnvUpdate', () => {
+            const mockApps = [
+                {
+                    id: 1,
+                    uuid: 'app-1',
+                    name: 'app-one',
+                    status: 'running',
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+                {
+                    id: 2,
+                    uuid: 'app-2',
+                    name: 'app-two',
+                    status: 'running',
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+                {
+                    id: 3,
+                    uuid: 'app-3',
+                    name: 'app-three',
+                    status: 'running',
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+            ];
+            it('should update env var across multiple apps', async () => {
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(mockApps)) // listApplications
+                    .mockResolvedValueOnce(mockResponse({ message: 'Updated' })) // app-1
+                    .mockResolvedValueOnce(mockResponse({ message: 'Updated' })); // app-2
+                const result = await client.bulkEnvUpdate(['app-1', 'app-2'], 'API_KEY', 'new-value');
+                expect(result.summary.total).toBe(2);
+                expect(result.summary.succeeded).toBe(2);
+                expect(result.summary.failed).toBe(0);
+                expect(result.succeeded).toEqual([
+                    { uuid: 'app-1', name: 'app-one' },
+                    { uuid: 'app-2', name: 'app-two' },
+                ]);
+            });
+            it('should handle partial failures', async () => {
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(mockApps))
+                    .mockResolvedValueOnce(mockResponse({ message: 'Updated' }))
+                    .mockRejectedValueOnce(new Error('App not found'));
+                const result = await client.bulkEnvUpdate(['app-1', 'app-2'], 'API_KEY', 'new-value');
+                expect(result.summary.succeeded).toBe(1);
+                expect(result.summary.failed).toBe(1);
+                expect(result.failed[0].error).toBe('App not found');
+            });
+            it('should handle unknown app UUIDs gracefully', async () => {
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(mockApps))
+                    .mockResolvedValueOnce(mockResponse({ message: 'Updated' }))
+                    .mockRejectedValueOnce(new Error('Application not found'));
+                const result = await client.bulkEnvUpdate(['app-1', 'unknown-app'], 'API_KEY', 'new-value');
+                expect(result.summary.total).toBe(2);
+                expect(result.summary.succeeded).toBe(1);
+                expect(result.summary.failed).toBe(1);
+                expect(result.succeeded[0].uuid).toBe('app-1');
+                expect(result.failed[0].uuid).toBe('unknown-app');
+                expect(result.failed[0].error).toBe('Application not found');
+            });
+            it('should return empty result for empty app UUIDs array', async () => {
+                const result = await client.bulkEnvUpdate([], 'API_KEY', 'new-value');
+                expect(result.summary.total).toBe(0);
+                expect(result.summary.succeeded).toBe(0);
+                expect(result.summary.failed).toBe(0);
+                // No API calls should be made
+                expect(mockFetch).not.toHaveBeenCalled();
+            });
+            it('should send build time flag when specified', async () => {
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(mockApps))
+                    .mockResolvedValueOnce(mockResponse({ message: 'Updated' }));
+                await client.bulkEnvUpdate(['app-1'], 'BUILD_VAR', 'value', true);
+                // Verify the PATCH call was made with is_build_time
+                expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/applications/app-1/envs', expect.objectContaining({
+                    method: 'PATCH',
+                    body: JSON.stringify({ key: 'BUILD_VAR', value: 'value', is_build_time: true }),
+                }));
+            });
+        });
+        describe('stopAllApps', () => {
+            const mockApps = [
+                {
+                    id: 1,
+                    uuid: 'app-1',
+                    name: 'running-app',
+                    status: 'running:healthy',
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+                {
+                    id: 2,
+                    uuid: 'app-2',
+                    name: 'healthy-app',
+                    status: 'healthy',
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+                {
+                    id: 3,
+                    uuid: 'app-3',
+                    name: 'stopped-app',
+                    status: 'exited',
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+            ];
+            it('should stop all running apps', async () => {
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(mockApps))
+                    .mockResolvedValueOnce(mockResponse({ message: 'Stopped' })) // app-1
+                    .mockResolvedValueOnce(mockResponse({ message: 'Stopped' })); // app-2
+                const result = await client.stopAllApps();
+                // Only 2 apps are running (app-1 and app-2), app-3 is already stopped
+                expect(result.summary.total).toBe(2);
+                expect(result.summary.succeeded).toBe(2);
+                expect(result.summary.failed).toBe(0);
+            });
+            it('should handle partial failures', async () => {
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(mockApps))
+                    .mockResolvedValueOnce(mockResponse({ message: 'Stopped' }))
+                    .mockRejectedValueOnce(new Error('Failed to stop'));
+                const result = await client.stopAllApps();
+                expect(result.summary.succeeded).toBe(1);
+                expect(result.summary.failed).toBe(1);
+            });
+            it('should return empty result when no running apps', async () => {
+                const stoppedApps = [
+                    { ...mockApps[2] }, // Only the stopped app
+                ];
+                mockFetch.mockResolvedValueOnce(mockResponse(stoppedApps));
+                const result = await client.stopAllApps();
+                expect(result.summary.total).toBe(0);
+            });
+        });
+        describe('redeployProjectApps', () => {
+            const mockApps = [
+                {
+                    id: 1,
+                    uuid: 'app-1',
+                    name: 'app-one',
+                    project_uuid: 'proj-1',
+                    status: 'running',
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+                {
+                    id: 2,
+                    uuid: 'app-2',
+                    name: 'app-two',
+                    project_uuid: 'proj-1',
+                    status: 'running',
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+                {
+                    id: 3,
+                    uuid: 'app-3',
+                    name: 'app-three',
+                    project_uuid: 'proj-2', // Different project
+                    status: 'running',
+                    created_at: '2024-01-01',
+                    updated_at: '2024-01-01',
+                },
+            ];
+            it('should redeploy all apps in a project', async () => {
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(mockApps))
+                    .mockResolvedValueOnce(mockResponse({ message: 'Deployed' })) // app-1
+                    .mockResolvedValueOnce(mockResponse({ message: 'Deployed' })); // app-2
+                const result = await client.redeployProjectApps('proj-1');
+                expect(result.summary.total).toBe(2);
+                expect(result.summary.succeeded).toBe(2);
+                expect(result.summary.failed).toBe(0);
+            });
+            it('should use force=true by default', async () => {
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(mockApps))
+                    .mockResolvedValueOnce(mockResponse({ message: 'Deployed' }))
+                    .mockResolvedValueOnce(mockResponse({ message: 'Deployed' }));
+                await client.redeployProjectApps('proj-1');
+                // Verify deploy calls use force=true
+                expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/deploy?tag=app-1&force=true', expect.any(Object));
+            });
+            it('should support force=false', async () => {
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(mockApps))
+                    .mockResolvedValueOnce(mockResponse({ message: 'Deployed' }))
+                    .mockResolvedValueOnce(mockResponse({ message: 'Deployed' }));
+                await client.redeployProjectApps('proj-1', false);
+                expect(mockFetch).toHaveBeenCalledWith('http://localhost:3000/api/v1/deploy?tag=app-1&force=false', expect.any(Object));
+            });
+            it('should handle partial failures', async () => {
+                mockFetch
+                    .mockResolvedValueOnce(mockResponse(mockApps))
+                    .mockResolvedValueOnce(mockResponse({ message: 'Deployed' }))
+                    .mockRejectedValueOnce(new Error('Build failed'));
+                const result = await client.redeployProjectApps('proj-1');
+                expect(result.summary.succeeded).toBe(1);
+                expect(result.summary.failed).toBe(1);
+                expect(result.failed[0].error).toBe('Build failed');
+            });
+            it('should return empty result for empty project', async () => {
+                mockFetch.mockResolvedValueOnce(mockResponse([]));
+                const result = await client.redeployProjectApps('empty-project');
+                expect(result.summary.total).toBe(0);
+            });
+        });
+    });
 });

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, CreateEnvVarRequest, UpdateEnvVarRequest, BulkUpdateEnvVarsRequest, Database, UpdateDatabaseRequest, DatabaseBackup, BackupExecution, Service, CreateServiceRequest, UpdateServiceRequest, ServiceCreateResponse, Deployment, Team, TeamMember, PrivateKey, CreatePrivateKeyRequest, UpdatePrivateKeyRequest, CloudToken, CreateCloudTokenRequest, UpdateCloudTokenRequest, CloudTokenValidation, Version, ApplicationDiagnostic, ServerDiagnostic, InfrastructureIssuesReport } 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, DatabaseBackup, BackupExecution, Service, CreateServiceRequest, UpdateServiceRequest, ServiceCreateResponse, Deployment, Team, TeamMember, PrivateKey, CreatePrivateKeyRequest, UpdatePrivateKeyRequest, CloudToken, CreateCloudTokenRequest, UpdateCloudTokenRequest, CloudTokenValidation, Version, ApplicationDiagnostic, ServerDiagnostic, InfrastructureIssuesReport, BatchOperationResult } from '../types/coolify.js';
 export interface ListOptions {
     page?: number;
     per_page?: number;
@@ -100,7 +100,9 @@ export declare class CoolifyClient {
     }): Promise<ApplicationActionResponse>;
     stopApplication(uuid: string): Promise<ApplicationActionResponse>;
     restartApplication(uuid: string): Promise<ApplicationActionResponse>;
-    listApplicationEnvVars(uuid: string): Promise<EnvironmentVariable[]>;
+    listApplicationEnvVars(uuid: string, options?: {
+        summary?: boolean;
+    }): Promise<EnvironmentVariable[] | EnvVarSummary[]>;
     createApplicationEnvVar(uuid: string, data: CreateEnvVarRequest): Promise<UuidResponse>;
     updateApplicationEnvVar(uuid: string, data: UpdateEnvVarRequest): Promise<MessageResponse>;
     bulkUpdateApplicationEnvVars(uuid: string, data: BulkUpdateEnvVarsRequest): Promise<MessageResponse>;
@@ -182,4 +184,32 @@ export declare class CoolifyClient {
      * Finds: unreachable servers, unhealthy apps, exited databases, stopped services.
      */
     findInfrastructureIssues(): Promise<InfrastructureIssuesReport>;
+    /**
+     * Aggregate results from Promise.allSettled into a BatchOperationResult.
+     */
+    private aggregateBatchResults;
+    /**
+     * Restart all applications in a project.
+     * @param projectUuid - Project UUID
+     */
+    restartProjectApps(projectUuid: string): Promise<BatchOperationResult>;
+    /**
+     * Update or create an environment variable across multiple applications.
+     * Uses upsert behavior: creates if not exists, updates if exists.
+     * @param appUuids - Array of application UUIDs
+     * @param key - Environment variable key
+     * @param value - Environment variable value
+     * @param isBuildTime - Whether this is a build-time variable (default: false)
+     */
+    bulkEnvUpdate(appUuids: string[], key: string, value: string, isBuildTime?: boolean): Promise<BatchOperationResult>;
+    /**
+     * Emergency stop all running applications across entire infrastructure.
+     */
+    stopAllApps(): Promise<BatchOperationResult>;
+    /**
+     * Redeploy all applications in a project.
+     * @param projectUuid - Project UUID
+     * @param force - Force rebuild (default: true)
+     */
+    redeployProjectApps(projectUuid: string, force?: boolean): Promise<BatchOperationResult>;
 }

package/dist/lib/coolify-client.js

@@ -71,6 +71,14 @@ function toProjectSummary(proj) {
         description: proj.description,
     };
 }
+function toEnvVarSummary(envVar) {
+    return {
+        uuid: envVar.uuid,
+        key: envVar.key,
+        value: envVar.value,
+        is_build_time: envVar.is_build_time,
+    };
+}
 /**
  * HTTP client for the Coolify API
  */
@@ -333,8 +341,9 @@ export class CoolifyClient {
     // ===========================================================================
     // Application Environment Variables
     // ===========================================================================
-    async listApplicationEnvVars(uuid) {
-        return this.request(`/applications/${uuid}/envs`);
+    async listApplicationEnvVars(uuid, options) {
+        const envVars = await this.request(`/applications/${uuid}/envs`);
+        return options?.summary ? envVars.map(toEnvVarSummary) : envVars;
     }
     async createApplicationEnvVar(uuid, data) {
         return this.request(`/applications/${uuid}/envs`, {
@@ -975,4 +984,117 @@ export class CoolifyClient {
             ...(errors.length > 0 && { errors }),
         };
     }
+    // ===========================================================================
+    // Batch Operations
+    // ===========================================================================
+    /**
+     * Aggregate results from Promise.allSettled into a BatchOperationResult.
+     */
+    aggregateBatchResults(resources, results) {
+        const succeeded = [];
+        const failed = [];
+        results.forEach((result, index) => {
+            const resource = resources[index];
+            const name = resource.name || resource.uuid;
+            if (result.status === 'fulfilled') {
+                succeeded.push({ uuid: resource.uuid, name });
+            }
+            else {
+                const error = result.reason instanceof Error ? result.reason.message : String(result.reason);
+                failed.push({ uuid: resource.uuid, name, error });
+            }
+        });
+        return {
+            summary: {
+                total: resources.length,
+                succeeded: succeeded.length,
+                failed: failed.length,
+            },
+            succeeded,
+            failed,
+        };
+    }
+    /**
+     * Restart all applications in a project.
+     * @param projectUuid - Project UUID
+     */
+    async restartProjectApps(projectUuid) {
+        const allApps = (await this.listApplications());
+        const projectApps = allApps.filter((app) => app.project_uuid === projectUuid);
+        if (projectApps.length === 0) {
+            return {
+                summary: { total: 0, succeeded: 0, failed: 0 },
+                succeeded: [],
+                failed: [],
+            };
+        }
+        const results = await Promise.allSettled(projectApps.map((app) => this.restartApplication(app.uuid)));
+        return this.aggregateBatchResults(projectApps, results);
+    }
+    /**
+     * Update or create an environment variable across multiple applications.
+     * Uses upsert behavior: creates if not exists, updates if exists.
+     * @param appUuids - Array of application UUIDs
+     * @param key - Environment variable key
+     * @param value - Environment variable value
+     * @param isBuildTime - Whether this is a build-time variable (default: false)
+     */
+    async bulkEnvUpdate(appUuids, key, value, isBuildTime = false) {
+        // Early return for empty array - avoid unnecessary API call
+        if (appUuids.length === 0) {
+            return {
+                summary: { total: 0, succeeded: 0, failed: 0 },
+                succeeded: [],
+                failed: [],
+            };
+        }
+        // Get app names first for better response
+        const allApps = (await this.listApplications());
+        const appMap = new Map(allApps.map((a) => [a.uuid, a.name || a.uuid]));
+        // Build the resource list with names
+        const resources = appUuids.map((uuid) => ({
+            uuid,
+            name: appMap.get(uuid) || uuid,
+        }));
+        const results = await Promise.allSettled(appUuids.map((uuid) => this.updateApplicationEnvVar(uuid, { key, value, is_build_time: isBuildTime })));
+        return this.aggregateBatchResults(resources, results);
+    }
+    /**
+     * Emergency stop all running applications across entire infrastructure.
+     */
+    async stopAllApps() {
+        const allApps = (await this.listApplications());
+        // Only stop running apps
+        const runningApps = allApps.filter((app) => {
+            const status = app.status || '';
+            return status.includes('running') || status.includes('healthy');
+        });
+        if (runningApps.length === 0) {
+            return {
+                summary: { total: 0, succeeded: 0, failed: 0 },
+                succeeded: [],
+                failed: [],
+            };
+        }
+        const results = await Promise.allSettled(runningApps.map((app) => this.stopApplication(app.uuid)));
+        return this.aggregateBatchResults(runningApps, results);
+    }
+    /**
+     * Redeploy all applications in a project.
+     * @param projectUuid - Project UUID
+     * @param force - Force rebuild (default: true)
+     */
+    async redeployProjectApps(projectUuid, force = true) {
+        const allApps = (await this.listApplications());
+        const projectApps = allApps.filter((app) => app.project_uuid === projectUuid);
+        if (projectApps.length === 0) {
+            return {
+                summary: { total: 0, succeeded: 0, failed: 0 },
+                succeeded: [],
+                failed: [],
+            };
+        }
+        const results = await Promise.allSettled(projectApps.map((app) => this.deployByTagOrUuid(app.uuid, force)));
+        return this.aggregateBatchResults(projectApps, results);
+    }
 }

package/dist/lib/mcp-server.js

@@ -20,7 +20,7 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
 import { CoolifyClient, } from './coolify-client.js';
-const VERSION = '0.8.0';
+const VERSION = '0.9.0';
 /** Wrap tool handler with consistent error handling */
 function wrapHandler(fn) {
     return fn()
@@ -193,7 +193,7 @@ export class CoolifyMcpServer extends McpServer {
             lines: z.number().optional().describe('Number of lines'),
         }, async ({ uuid, lines }) => wrapHandler(() => this.client.getApplicationLogs(uuid, lines)));
         // Application env vars
-        this.tool('list_application_envs', 'List application environment variables', { uuid: z.string().describe('Application UUID') }, async ({ uuid }) => wrapHandler(() => this.client.listApplicationEnvVars(uuid)));
+        this.tool('list_application_envs', 'List application environment variables (returns summary: uuid, key, value, is_build_time)', { uuid: z.string().describe('Application UUID') }, async ({ uuid }) => wrapHandler(() => this.client.listApplicationEnvVars(uuid, { summary: true })));
         this.tool('create_application_env', 'Create application environment variable', {
             uuid: z.string().describe('Application UUID'),
             key: z.string().describe('Variable key'),
@@ -344,8 +344,34 @@ export class CoolifyMcpServer extends McpServer {
         // =========================================================================
         // Diagnostics (3 tools) - Composite tools for debugging
         // =========================================================================
-        this.tool('diagnose_app', 'Get comprehensive diagnostic info for an application. Accepts UUID, name, or domain (e.g., "tidylinker.com" or "my-app"). Aggregates: status, health assessment, logs (last 50 lines), environment variables (keys only, values hidden), and recent deployments. Use this for debugging application issues.', { query: z.string().describe('Application UUID, name, or domain (FQDN)') }, async ({ query }) => wrapHandler(() => this.client.diagnoseApplication(query)));
+        this.tool('diagnose_app', 'Get comprehensive diagnostic info for an application. Accepts UUID, name, or domain (e.g., "stuartmason.co.uk" or "my-app"). Aggregates: status, health assessment, logs (last 50 lines), environment variables (keys only, values hidden), and recent deployments. Use this for debugging application issues.', { query: z.string().describe('Application UUID, name, or domain (FQDN)') }, async ({ query }) => wrapHandler(() => this.client.diagnoseApplication(query)));
         this.tool('diagnose_server', 'Get comprehensive diagnostic info for a server. Accepts UUID, name, or IP address (e.g., "coolify-apps" or "192.168.1.100"). Aggregates: server status, health assessment, running resources, configured domains, and connection validation. Use this for debugging server issues.', { query: z.string().describe('Server UUID, name, or IP address') }, async ({ query }) => wrapHandler(() => this.client.diagnoseServer(query)));
         this.tool('find_issues', 'Scan entire infrastructure for common issues. Finds: unreachable servers, unhealthy/stopped applications, exited databases, and stopped services. Returns a summary with issue counts and detailed list of problems.', {}, async () => wrapHandler(() => this.client.findInfrastructureIssues()));
+        // =========================================================================
+        // Batch Operations (4 tools) - Operate on multiple resources at once
+        // =========================================================================
+        this.tool('restart_project_apps', 'Restart all applications in a project. Returns a summary of succeeded/failed restarts with details.', { project_uuid: z.string().describe('Project UUID') }, async ({ project_uuid }) => wrapHandler(() => this.client.restartProjectApps(project_uuid)));
+        this.tool('bulk_env_update', 'Update or create an environment variable across multiple applications (upsert behavior). Returns summary of succeeded/failed updates.', {
+            app_uuids: z.array(z.string()).describe('Array of application UUIDs'),
+            key: z.string().describe('Environment variable key'),
+            value: z.string().describe('Environment variable value'),
+            is_build_time: z.boolean().optional().describe('Build-time variable (default: false)'),
+        }, async ({ app_uuids, key, value, is_build_time }) => wrapHandler(() => this.client.bulkEnvUpdate(app_uuids, key, value, is_build_time)));
+        this.tool('stop_all_apps', 'EMERGENCY: Stop ALL running applications across entire infrastructure. Only stops apps that are currently running or healthy. Use with caution!', {
+            confirm: z.literal(true).describe('Must be true to confirm this dangerous operation'),
+        }, async ({ confirm }) => {
+            if (!confirm) {
+                return {
+                    content: [
+                        { type: 'text', text: 'Error: Must set confirm=true to stop all apps' },
+                    ],
+                };
+            }
+            return wrapHandler(() => this.client.stopAllApps());
+        });
+        this.tool('redeploy_project', 'Redeploy all applications in a project with force rebuild. Returns summary of succeeded/failed deployments.', {
+            project_uuid: z.string().describe('Project UUID'),
+            force: z.boolean().optional().describe('Force rebuild (default: true)'),
+        }, async ({ project_uuid, force }) => wrapHandler(() => this.client.redeployProjectApps(project_uuid, force ?? true)));
     }
 }

package/dist/types/coolify.d.ts

@@ -348,6 +348,12 @@ export interface UpdateEnvVarRequest {
 export interface BulkUpdateEnvVarsRequest {
     data: CreateEnvVarRequest[];
 }
+export interface EnvVarSummary {
+    uuid: string;
+    key: string;
+    value: string;
+    is_build_time: boolean;
+}
 export type DatabaseType = 'postgresql' | 'mysql' | 'mariadb' | 'mongodb' | 'redis' | 'keydb' | 'clickhouse' | 'dragonfly';
 export interface DatabaseLimits {
     memory?: string;
@@ -728,3 +734,19 @@ export interface InfrastructureIssuesReport {
     issues: InfrastructureIssue[];
     errors?: string[];
 }
+export interface BatchOperationResult {
+    summary: {
+        total: number;
+        succeeded: number;
+        failed: number;
+    };
+    succeeded: Array<{
+        uuid: string;
+        name: string;
+    }>;
+    failed: Array<{
+        uuid: string;
+        name: string;
+        error: string;
+    }>;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@masonator/coolify-mcp",
   "scope": "@masonator",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "MCP server implementation for Coolify",
   "type": "module",
   "main": "./dist/index.js",