stop_service
Stop a running service in Coolify. Use this tool to halt services by specifying their UUID, with optional confirmation for safety when required.
Instructions
Stop a service. When COOLIFY_REQUIRE_CONFIRM=true, requires confirm: true parameter.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uuid | Yes | Service UUID | |
| confirm | No | Confirm the dangerous operation (required when COOLIFY_REQUIRE_CONFIRM=true) |
Implementation Reference
- src/tools/handlers.ts:308-310 (handler)The core handler logic for the 'stop_service' tool. It validates the required 'uuid' parameter and makes a GET request to the Coolify API endpoint to stop the specified service.case 'stop_service': requireParam(args, 'uuid'); return client.get(`/services/${args.uuid}/stop`);
- src/tools/definitions.ts:543-554 (schema)The JSON schema definition for the 'stop_service' tool, including input parameters (uuid required, confirm optional for dangerous ops). This is part of the allToolDefinitions array used for MCP tool registration.{ name: 'stop_service', description: 'Stop 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:44-64 (helper)Helper array marking 'stop_service' as a dangerous operation, which triggers confirmation requirement via isDangerousOperation().// 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:67-86 (helper)Helper object providing the specific warning message for 'stop_service', 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)MCP server registration for listing tools. getToolDefinitions() includes the 'stop_service' schema, making it discoverable to MCP clients.this.server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: getToolDefinitions() }));