coolify_application_lifecycle

Manage application states by starting, stopping, or restarting applications using their unique identifiers within the Coolify infrastructure platform.

Instructions

Application lifecycle management - start, stop, and restart applications

Input Schema

TableJSON Schema

Name	Required	Description	Default
`action`	Yes	Action to perform: start (start application), stop (stop application), restart (restart application)
`uuid`	Yes	Application UUID (required for all actions)

Implementation Reference

src/handlers.ts:158-174 (handler)

Executes the application lifecycle actions (start, stop, restart) by calling the Coolify API endpoints.

async applicationLifecycle(action: string, uuid: string) {
  if (!uuid) throw new Error('Application UUID is required for all lifecycle actions');
  
  switch (action) {
    case 'start':
      const startResponse = await this.apiClient.post(`/applications/${uuid}/start`);
      return { content: [{ type: 'text', text: JSON.stringify(startResponse.data, null, 2) }] };
    case 'stop':
      const stopResponse = await this.apiClient.post(`/applications/${uuid}/stop`);
      return { content: [{ type: 'text', text: JSON.stringify(stopResponse.data, null, 2) }] };
    case 'restart':
      const restartResponse = await this.apiClient.post(`/applications/${uuid}/restart`);
      return { content: [{ type: 'text', text: JSON.stringify(restartResponse.data, null, 2) }] };
    default:
      throw new Error(`Unknown application lifecycle action: ${action}`);
  }
}

src/tools.ts:227-245 (schema)

Defines the tool schema including input parameters: action (enum: start, stop, restart) and uuid.

{
  name: 'coolify_application_lifecycle',
  description: 'Application lifecycle management - start, stop, and restart applications',
  inputSchema: {
    type: 'object',
    properties: {
      action: { 
        type: 'string', 
        enum: ['start', 'stop', 'restart'],
        description: 'Action to perform: start (start application), stop (stop application), restart (restart application)'
      },
      uuid: { 
        type: 'string', 
        description: 'Application UUID (required for all actions)' 
      },
    },
    required: ['action', 'uuid'],
  },
},

src/index.ts:104-105 (registration)

Registers the tool handler dispatch in the main tool call switch statement.

case 'coolify_application_lifecycle':
  return await this.handlers.applicationLifecycle(args.action, args.uuid);

Coolify MCP Server