Coolify MCP Server

Instructions

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'
      ]
    }
  }