coolify_application_deployments
Manage application deployments by listing, retrieving details, or triggering new deployments through the Coolify MCP Server.
Instructions
Application deployment management - list, get, and trigger deployments
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Action to perform: list (list all deployments), get (get deployment by UUID), trigger (trigger deployment) | |
| uuid | No | Application UUID (required for trigger action) | |
| deployment_uuid | No | Deployment UUID (required for get action) | |
| force_rebuild | No | Force rebuild (optional for trigger action, default: false) | |
| page | No | Page number (optional for list action) | |
| per_page | No | Items per page (optional for list action) |
Implementation Reference
- src/handlers.ts:221-241 (handler)The handler function that implements the logic for 'coolify_application_deployments' tool, dispatching to API endpoints for list, get, and trigger deployments.
async applicationDeployments(action: string, args: any) { switch (action) { case 'list': const queryString = this.apiClient.buildQueryString(args); const response = await this.apiClient.get(`/deployments?${queryString}`); return { content: [{ type: 'text', text: JSON.stringify(response.data, null, 2) }] }; case 'get': if (!args.deployment_uuid) throw new Error('Deployment UUID is required for get action'); const getResponse = await this.apiClient.get(`/deployments/${args.deployment_uuid}`); return { content: [{ type: 'text', text: JSON.stringify(getResponse.data, null, 2) }] }; case 'trigger': if (!args.uuid) throw new Error('Application UUID is required for trigger action'); const triggerResponse = await this.apiClient.post('/deploy', { uuid: args.uuid, force_rebuild: args.force_rebuild || false, }); return { content: [{ type: 'text', text: JSON.stringify(triggerResponse.data, null, 2) }] }; default: throw new Error(`Unknown application deployments action: ${action}`); } } - src/tools.ts:317-351 (schema)The input schema and metadata definition for the 'coolify_application_deployments' tool.
{ name: 'coolify_application_deployments', description: 'Application deployment management - list, get, and trigger deployments', inputSchema: { type: 'object', properties: { action: { type: 'string', enum: ['list', 'get', 'trigger'], description: 'Action to perform: list (list all deployments), get (get deployment by UUID), trigger (trigger deployment)' }, uuid: { type: 'string', description: 'Application UUID (required for trigger action)' }, deployment_uuid: { type: 'string', description: 'Deployment UUID (required for get action)' }, force_rebuild: { type: 'boolean', description: 'Force rebuild (optional for trigger action, default: false)' }, page: { type: 'number', description: 'Page number (optional for list action)' }, per_page: { type: 'number', description: 'Items per page (optional for list action)' }, }, required: ['action'], }, }, - src/index.ts:110-111 (registration)Registration/dispatch point in the main tool handler switch statement that routes calls to the applicationDeployments handler.
case 'coolify_application_deployments': return await this.handlers.applicationDeployments(args.action, args);