Coolify MCP Server

Instructions

Implementation Reference

• src/index.ts:1385-1389 (handler)

  Handler function for the 'start_service' tool. It extracts the service UUID from the request parameters, makes a GET request to the Coolify API endpoint `/services/{uuid}/start` to start the service, and returns the API response as formatted JSON text content.

  case 'start_service':
    const startServiceResponse = await this.axiosInstance.get(`/services/${request.params.arguments?.uuid}/start`);
    return {
      content: [{ type: 'text', text: JSON.stringify(startServiceResponse.data, null, 2) }]
    };

• src/index.ts:654-685 (schema)

  Input schema definition for the 'start_service' tool, specifying that a 'uuid' string parameter is required, with pattern validation, examples, workflow instructions, and related tools.

  inputSchema: {
    type: 'object',
    properties: {
      uuid: {
        type: 'string',
        description: 'UUID of the service to start. Obtain this from list_services or from the create_service response.',
        pattern: '^[a-zA-Z0-9]+$'
      }
    },
    required: ['uuid'],
    examples: [
      {
        uuid: 'sg4gsws44wksg040o4ok80ww'
      }
    ],
    additionalInfo: {
      workflow: [
        '1. Get the service UUID from list_services',
        '2. Start the service',
        '3. Monitor the service status'
      ],
      relatedTools: [
        'list_services - Get UUIDs of available services',
        'stop_service - Stop the service if needed',
        'restart_service - Restart if issues occur'
      ],
      notes: [
        'Service must be properly configured before starting',
        'Starting may take a few moments depending on the service',
        'Check service logs if startup issues occur'
      ]
    }

• src/index.ts:651-687 (registration)

  Registration of the 'start_service' tool in the list of tools returned by the ListToolsRequestHandler. Includes name, description, and input schema.

  {
    name: 'start_service',
    description: 'Start a previously created service. This will initialize the service container and make it accessible.',
    inputSchema: {
      type: 'object',
      properties: {
        uuid: {
          type: 'string',
          description: 'UUID of the service to start. Obtain this from list_services or from the create_service response.',
          pattern: '^[a-zA-Z0-9]+$'
        }
      },
      required: ['uuid'],
      examples: [
        {
          uuid: 'sg4gsws44wksg040o4ok80ww'
        }
      ],
      additionalInfo: {
        workflow: [
          '1. Get the service UUID from list_services',
          '2. Start the service',
          '3. Monitor the service status'
        ],
        relatedTools: [
          'list_services - Get UUIDs of available services',
          'stop_service - Stop the service if needed',
          'restart_service - Restart if issues occur'
        ],
        notes: [
          'Service must be properly configured before starting',
          'Starting may take a few moments depending on the service',
          'Check service logs if startup issues occur'
        ]
      }
    }
  },