Coolify MCP Server

Instructions

Implementation Reference

• src/tools/handlers.ts:296-302 (handler)

  Handler logic for 'create_service' tool: validates required parameters and sends POST request to /services endpoint.

  case 'create_service':
    requireParam(args, 'type');
    requireParam(args, 'name');
    requireParam(args, 'project_uuid');
    requireParam(args, 'environment_name');
    requireParam(args, 'server_uuid');
    return client.post('/services', args);

• src/tools/definitions.ts:520-533 (registration)

  Tool registration in the allToolDefinitions array, including name, description, and input schema. Used by getToolDefinitions() for MCP tool list.

    name: 'create_service',
    description: 'Create a new service',
    inputSchema: {
      type: 'object',
      properties: {
        type: { type: 'string', description: 'Service type' },
        name: { type: 'string', description: 'Service name' },
        project_uuid: { type: 'string', description: 'Project UUID' },
        environment_name: { type: 'string', description: 'Environment name' },
        server_uuid: { type: 'string', description: 'Server UUID' }
      },
      required: ['type', 'name', 'project_uuid', 'environment_name', 'server_uuid']
    }
  },

• src/types.ts:141-148 (schema)

  TypeScript interface defining the input shape for create_service, matching the tool schema.

  export interface CreateServiceInput {
    type: string;
    name: string;
    project_uuid: string;
    environment_name: string;
    server_uuid: string;
    destination_uuid?: string;
  }