stop_service
Gracefully shut down a running service container in Coolify by providing its UUID. Use this tool to stop services managed through the Coolify platform.
Instructions
Stop a running service. This will gracefully shut down the service container.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uuid | Yes | UUID of the service to stop. Get this from list_services. |
Implementation Reference
- src/index.ts:1391-1395 (handler)Handler implementation for the 'stop_service' tool. Makes a GET request to the Coolify API `/services/{uuid}/stop` endpoint to stop the specified service and returns the response.case 'stop_service': const stopServiceResponse = await this.axiosInstance.get(`/services/${request.params.arguments?.uuid}/stop`); return { content: [{ type: 'text', text: JSON.stringify(stopServiceResponse.data, null, 2) }] };
- src/index.ts:688-722 (registration)Registration of the 'stop_service' tool in the MCP server's ListToolsRequestSchema handler, including name, description, input schema, examples, and additional information.{ name: 'stop_service', description: 'Stop a running service. This will gracefully shut down the service container.', inputSchema: { type: 'object', properties: { uuid: { type: 'string', description: 'UUID of the service to stop. Get this from list_services.', pattern: '^[a-zA-Z0-9]+$' } }, required: ['uuid'], examples: [ { uuid: 'sg4gsws44wksg040o4ok80ww' } ], additionalInfo: { workflow: [ '1. Get the service UUID from list_services', '2. Stop the service', '3. Verify the service has stopped' ], relatedTools: [ 'list_services - Get UUIDs of available services', 'start_service - Restart the service when needed' ], notes: [ 'Stopping a service will interrupt its operations', 'Service data persists unless explicitly removed', 'Use restart_service if you plan to start again immediately' ] } }
- src/index.ts:691-722 (schema)Input schema definition for the 'stop_service' tool, specifying the required 'uuid' parameter, examples, and additional usage information.inputSchema: { type: 'object', properties: { uuid: { type: 'string', description: 'UUID of the service to stop. Get this from list_services.', pattern: '^[a-zA-Z0-9]+$' } }, required: ['uuid'], examples: [ { uuid: 'sg4gsws44wksg040o4ok80ww' } ], additionalInfo: { workflow: [ '1. Get the service UUID from list_services', '2. Stop the service', '3. Verify the service has stopped' ], relatedTools: [ 'list_services - Get UUIDs of available services', 'start_service - Restart the service when needed' ], notes: [ 'Stopping a service will interrupt its operations', 'Service data persists unless explicitly removed', 'Use restart_service if you plan to start again immediately' ] } }