Coolify MCP Server

Instructions

Implementation Reference

• src/tools/handlers.ts:70-71 (handler)

  Handler case for 'list_servers' tool: retrieves the list of servers by calling client.get('/servers'). This is part of the main handleTool switch statement.

  case 'list_servers':
    return client.get('/servers');

• src/tools/definitions.ts:152-156 (schema)

  Schema definition for the 'list_servers' tool, specifying name, description, and empty input schema (no parameters required).

  {
    name: 'list_servers',
    description: 'List all servers in Coolify',
    inputSchema: { type: 'object', properties: {}, required: [] }
  },

• src/tools/index.ts:1-2 (registration)

  Registration exports: Exports tool definitions (including list_servers schema) and handleTool function for use in MCP server setup.

  export { toolDefinitions, getToolDefinitions, isReadOnlyMode, READ_ONLY_TOOLS } from './definitions.js';
  export { handleTool } from './handlers.js';

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

  MCP tool list registration: Registers handler for ListToolsRequestSchema which returns all tool definitions including list_servers.

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

• src/index.ts:56-67 (registration)

  MCP tool call registration: In CallToolRequestSchema handler, invokes handleTool which dispatches to list_servers case.

    try {
      const result = await handleTool(this.client, name, args || {});
      return {
        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }]
      };
    } catch (error) {
      if (error instanceof McpError) throw error;
      
      const message = error instanceof Error ? error.message : 'Unknown error';
      throw new McpError(ErrorCode.InternalError, `Tool execution failed: ${message}`);
    }
  });