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.'
  };