Coolify MCP Server

Instructions

Implementation Reference

• src/tools/handlers.ts:221-223 (handler)

  The core handler logic for the 'restart_application' tool. It validates the required 'uuid' parameter and makes a GET request to the Coolify API endpoint `/applications/{uuid}/restart` to restart the specified application.

  case 'restart_application':
    requireParam(args, 'uuid');
    return client.get(`/applications/${args.uuid}/restart`);

• src/tools/definitions.ts:434-445 (schema)

  The tool schema definition including name, description, and input schema for 'restart_application'. Defines required 'uuid' and optional 'confirm' parameters.

  {
    name: 'restart_application',
    description: 'Restart an application. When COOLIFY_REQUIRE_CONFIRM=true, requires confirm: true parameter.',
    inputSchema: {
      type: 'object',
      properties: {
        uuid: { type: 'string', description: 'Application UUID' },
        confirm: { type: 'boolean', description: 'Confirm the dangerous operation (required when COOLIFY_REQUIRE_CONFIRM=true)' }
      },
      required: ['uuid']
    }
  },

• src/tools/definitions.ts:47-47 (helper)

  Includes 'restart_application' in the DANGEROUS_OPERATIONS array, enabling confirmation checks for this tool.

  'restart_application',

• src/tools/definitions.ts:69-69 (helper)

  Provides the danger warning message used when confirmation is required for 'restart_application'.

  restart_application: 'This will restart the application, causing brief downtime.',

• src/tools/index.ts:1-2 (registration)

  Re-exports the tool definitions (including 'restart_application') and the handleTool function for MCP tool registration.

  export { toolDefinitions, getToolDefinitions, isReadOnlyMode, READ_ONLY_TOOLS } from './definitions.js';
  export { handleTool } from './handlers.js';