Coolify MCP Server

Instructions

Implementation Reference

• src/tools/handlers.ts:206-211 (handler)

  Handler implementation for the create_dockercompose_application tool. Validates required parameters (project_uuid, environment_name, server_uuid, docker_compose_raw) and sends a POST request to the Coolify API endpoint '/applications/dockercompose' with the arguments.

  case 'create_dockercompose_application':
    requireParam(args, 'project_uuid');
    requireParam(args, 'environment_name');
    requireParam(args, 'server_uuid');
    requireParam(args, 'docker_compose_raw');
    return client.post('/applications/dockercompose', args);

• src/tools/definitions.ts:394-412 (schema)

  Tool schema definition including name, description, and inputSchema with properties and required fields for validating inputs to create_dockercompose_application.

  {
    name: 'create_dockercompose_application',
    description: 'Create a new application from Docker Compose configuration',
    inputSchema: {
      type: 'object',
      properties: {
        project_uuid: { type: 'string', description: 'Project UUID' },
        environment_name: { type: 'string', description: 'Environment name' },
        environment_uuid: { type: 'string', description: 'Environment UUID (optional)' },
        server_uuid: { type: 'string', description: 'Server UUID' },
        destination_uuid: { type: 'string', description: 'Destination UUID (optional if server has single destination)' },
        docker_compose_raw: { type: 'string', description: 'Docker Compose YAML content (base64 encoded)' },
        name: { type: 'string', description: 'Application name (optional, auto-generated if not provided)' },
        description: { type: 'string', description: 'Application description' },
        instant_deploy: { type: 'boolean', description: 'Deploy immediately after creation', default: false }
      },
      required: ['project_uuid', 'environment_name', 'server_uuid', 'docker_compose_raw']
    }
  },

• src/index.ts:36-38 (registration)

  Registration of all tools via getToolDefinitions() which includes create_dockercompose_application in the MCP server's listTools handler.

  this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: getToolDefinitions()
  }));