delete_environment

Remove an environment from a Coolify project. Specify project and environment identifiers to delete the deployment environment.

Instructions

Delete an environment. When COOLIFY_REQUIRE_CONFIRM=true, requires confirm: true parameter.

Input Schema

TableJSON Schema

Name	Required	Description
`project_uuid`	Yes	Project UUID
`environment_name_or_uuid`	Yes	Environment name or UUID
`confirm`	No	Confirm the dangerous operation (required when COOLIFY_REQUIRE_CONFIRM=true)

Implementation Reference

src/tools/handlers.ts:130-133 (handler)
The core handler logic for the 'delete_environment' tool. It validates required parameters (project_uuid and environment_name_or_uuid) and calls the CoolifyClient.delete method on the appropriate API endpoint to permanently delete the environment.
```
case 'delete_environment':
  requireParam(args, 'project_uuid');
  requireParam(args, 'environment_name_or_uuid');
  return client.delete(`/projects/${args.project_uuid}/environments/${args.environment_name_or_uuid}`);
```

src/tools/definitions.ts:832-844 (schema)

The schema definition for the 'delete_environment' tool, including input parameters, descriptions, and confirmation requirement for dangerous operations.

{
  name: 'delete_environment',
  description: 'Delete an environment. When COOLIFY_REQUIRE_CONFIRM=true, requires confirm: true parameter.',
  inputSchema: {
    type: 'object',
    properties: {
      project_uuid: { type: 'string', description: 'Project UUID' },
      environment_name_or_uuid: { type: 'string', description: 'Environment name or UUID' },
      confirm: { type: 'boolean', description: 'Confirm the dangerous operation (required when COOLIFY_REQUIRE_CONFIRM=true)' }
    },
    required: ['project_uuid', 'environment_name_or_uuid']
  }
},

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

Lists 'delete_environment' as a dangerous operation requiring confirmation check 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-86 (helper)

Provides the specific warning message for the 'delete_environment' tool used in confirmation prompts.

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

src/index.ts:36-38 (registration)
Registers all tools including 'delete_environment' by returning getToolDefinitions() in the MCP ListTools handler.
```
this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: getToolDefinitions()
}));
```

Coolify MCP Server