Coolify MCP Server

Instructions

Implementation Reference

• src/tools/handlers.ts:330-332 (handler)

  The switch case in handleTool that implements the 'delete_service' tool by requiring a 'uuid' parameter and calling the Coolify client's delete method on the services endpoint.

  case 'delete_service':
    requireParam(args, 'uuid');
    return client.delete(`/services/${args.uuid}`);

• src/tools/definitions.ts:972-982 (schema)

  The tool definition including name, description, and input schema for 'delete_service', which specifies the required 'uuid' and optional 'confirm' parameters.

  {
    name: 'delete_service',
    description: 'Delete a service. When COOLIFY_REQUIRE_CONFIRM=true, requires confirm: true parameter.',
    inputSchema: {
      type: 'object',
      properties: {
        uuid: { type: 'string', description: 'Service UUID' },
        confirm: { type: 'boolean', description: 'Confirm the dangerous operation (required when COOLIFY_REQUIRE_CONFIRM=true)' }
      },
      required: ['uuid']
    }

• src/tools/definitions.ts:45-64 (registration)

  The 'delete_service' tool is registered as a dangerous operation requiring confirmation if COOLIFY_REQUIRE_CONFIRM is 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:67-86 (helper)

  Warning message defined for the 'delete_service' dangerous operation.

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