Coolify MCP Server

Instructions

Implementation Reference

• src/index.ts:1494-1498 (handler)

  The handler function for the 'get_deployment' tool. It retrieves detailed information about a specific deployment by making an API GET request to `/deployments/{uuid}` using the axios instance configured for Coolify API, and returns the response data as formatted JSON text content.

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

• src/index.ts:1092-1126 (schema)

  The tool definition including name, description, input schema (requiring 'uuid' parameter), examples, and additional workflow/related tools information. This is part of the tools list returned by list_tools.

  {
    name: 'get_deployment',
    description: 'Get detailed information about a specific deployment. Use this to monitor deployment status and troubleshoot issues.',
    inputSchema: {
      type: 'object',
      properties: {
        uuid: {
          type: 'string',
          description: 'UUID of the deployment to retrieve. Obtain this from list_deployments or from deployment event responses.',
          pattern: '^[a-zA-Z0-9]+$'
        }
      },
      required: ['uuid'],
      examples: [
        {
          uuid: 'sg4gsws44wksg040o4ok80ww'
        }
      ],
      additionalInfo: {
        workflow: [
          '1. Get deployment UUID from list_deployments or deployment events',
          '2. Retrieve deployment details',
          '3. Check status and logs if needed'
        ],
        relatedTools: [
          'list_deployments - Get list of all deployments',
          'execute_command_application - Run commands to investigate deployment issues'
        ],
        notes: [
          'Deployment details include status, timestamps, and resource information',
          'Use this to track deployment progress and troubleshoot issues',
          'Failed deployments will include error information'
        ]
      }
    }

• src/index.ts:1092-1127 (registration)

  The get_deployment tool is registered by including its definition in the tools array returned by the ListToolsRequestSchema handler.

  {
    name: 'get_deployment',
    description: 'Get detailed information about a specific deployment. Use this to monitor deployment status and troubleshoot issues.',
    inputSchema: {
      type: 'object',
      properties: {
        uuid: {
          type: 'string',
          description: 'UUID of the deployment to retrieve. Obtain this from list_deployments or from deployment event responses.',
          pattern: '^[a-zA-Z0-9]+$'
        }
      },
      required: ['uuid'],
      examples: [
        {
          uuid: 'sg4gsws44wksg040o4ok80ww'
        }
      ],
      additionalInfo: {
        workflow: [
          '1. Get deployment UUID from list_deployments or deployment events',
          '2. Retrieve deployment details',
          '3. Check status and logs if needed'
        ],
        relatedTools: [
          'list_deployments - Get list of all deployments',
          'execute_command_application - Run commands to investigate deployment issues'
        ],
        notes: [
          'Deployment details include status, timestamps, and resource information',
          'Use this to track deployment progress and troubleshoot issues',
          'Failed deployments will include error information'
        ]
      }
    }
  },