Coolify MCP Server

Instructions

Implementation Reference

• src/tools/handlers.ts:247-252 (handler)

  The handler implementation for the 'execute_command' tool. It validates the required 'uuid' and 'command' parameters and returns an error indicating that the feature is not supported by the Coolify API.
  case 'execute_command': requireParam(args, 'uuid'); requireParam(args, 'command'); // This endpoint doesn't exist in Coolify API return { error: 'Execute command endpoint is not available in Coolify API. This feature is not supported via the API.' };
• src/tools/definitions.ts:476-487 (schema)

  JSON Schema definition for the 'execute_command' tool input, including parameters, descriptions, and requirements. Also includes the tool description used for MCP tool listing.
  name: 'execute_command', description: 'Execute a command in an application container. NOTE: This endpoint is not available in Coolify API and will return an error.', inputSchema: { type: 'object', properties: { uuid: { type: 'string', description: 'Application UUID' }, command: { type: 'string', description: 'Command to execute' }, confirm: { type: 'boolean', description: 'Confirm the dangerous operation (required when COOLIFY_REQUIRE_CONFIRM=true)' } }, required: ['uuid', 'command'] } },
• src/types.ts:164-167 (schema)

  TypeScript interface defining the input structure for the execute_command tool.
  export interface ExecuteCommandInput { uuid: string; command: string; }
• src/tools/definitions.ts:44-64 (helper)

  'execute_command' is listed as a dangerous operation requiring user confirmation via the 'confirm' parameter when enabled.
  // Dangerous operations that require confirmation when COOLIFY_REQUIRE_CONFIRM=true export const DANGEROUS_OPERATIONS = [ 'stop_application', 'restart_application', 'stop_service', 'restart_service', 'stop_database', 'restart_database', 'deploy_application', 'deploy', 'execute_command', 'delete_server', 'delete_project', 'delete_environment', 'delete_application', 'delete_service', 'delete_database', 'delete_private_key', 'delete_github_app', 'cancel_deployment' ];
• src/tools/definitions.ts:66-86 (helper)

  Warning message for the 'execute_command' tool used when confirmation is required.
  // Warning messages for dangerous operations export const DANGER_WARNINGS: Record<string, string> = { stop_application: 'This will stop the application and make it unavailable until restarted.', restart_application: 'This will restart the application, causing brief downtime.', stop_service: 'This will stop the service and make it unavailable until restarted.', restart_service: 'This will restart the service, causing brief downtime.', stop_database: 'This will stop the database and make it unavailable until restarted.', restart_database: 'This will restart the database, causing brief downtime.', deploy_application: 'This will deploy a new version of the application, which may cause downtime.', deploy: 'This will deploy resources by UUID or tag, which may cause downtime.', execute_command: 'This will execute a command inside the application container.', delete_server: 'This will permanently delete the server and all its resources.', delete_project: 'This will permanently delete the project and all its resources.', delete_environment: 'This will permanently delete the environment and all its resources.', delete_application: 'This will permanently delete the application and all its data.', delete_service: 'This will permanently delete the service and all its data.', delete_database: 'This will permanently delete the database and all its data.', delete_private_key: 'This will permanently delete the private key. Make sure no servers are using it.', delete_github_app: 'This will permanently delete the GitHub App configuration. Applications using it will lose access.', cancel_deployment: 'This will cancel the deployment in progress.' };