delete_server
Remove a server from your Coolify PaaS instance by providing its UUID. Use confirm parameter when required for safety.
Instructions
Delete a server. When COOLIFY_REQUIRE_CONFIRM=true, requires confirm: true parameter.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uuid | Yes | Server UUID | |
| confirm | No | Confirm the dangerous operation (required when COOLIFY_REQUIRE_CONFIRM=true) |
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.'