Coolify MCP Server

Instructions

Implementation Reference

• src/tools/handlers.ts:99-101 (handler)

  The handler logic for the 'delete_server' tool. It requires a 'uuid' parameter and sends a DELETE request to the Coolify API endpoint `/servers/${uuid}` to delete the server.

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

• src/tools/definitions.ts:783-794 (schema)

  The input schema and metadata definition for the 'delete_server' tool, used for validation and MCP tool registration.

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

• src/index.ts:36-38 (registration)

  Registers the 'delete_server' tool (among others) with the MCP server by returning the list from getToolDefinitions() in response to listTools requests.

  this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: getToolDefinitions()
  }));

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

  'delete_server' is classified as a dangerous operation, triggering confirmation checks via isDangerousOperation().

  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-85 (helper)

  Provides the warning message displayed when confirmation is required for the 'delete_server' tool.

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