cancel_deployment

Stop an active deployment in Coolify by providing its UUID. Use this tool to halt deployments when needed, with optional confirmation for safety.

Instructions

Cancel a deployment. When COOLIFY_REQUIRE_CONFIRM=true, requires confirm: true parameter.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`uuid`	Yes	Deployment UUID
`confirm`	No	Confirm the dangerous operation (required when COOLIFY_REQUIRE_CONFIRM=true)

Implementation Reference

src/tools/handlers.ts:431-433 (handler)
The switch case in handleTool function that implements cancel_deployment by requiring 'uuid' param and POSTing to Coolify API /deployments/{uuid}/cancel.
```
case 'cancel_deployment':
  requireParam(args, 'uuid');
  return client.post(`/deployments/${args.uuid}/cancel`);
```

src/tools/definitions.ts:1154-1164 (schema)

Input schema and metadata definition for the cancel_deployment tool, part of the allToolDefinitions array used for MCP tool registration.

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

src/index.ts:36-38 (registration)
MCP server request handler for listing tools, which includes cancel_deployment via getToolDefinitions() from tools/definitions.ts
```
this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: getToolDefinitions()
}));
```

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

Helper array classifying 'cancel_deployment' as dangerous operation, triggering confirmation check in handlers.ts

// 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:85-86 (helper)
Danger warning message for cancel_deployment used when confirmation is required.
```
  cancel_deployment: 'This will cancel the deployment in progress.'
};
```

Coolify MCP Server