Coolify MCP Server

Instructions

Implementation Reference

• src/handlers.ts:7-29 (handler)

  The handler function that implements the logic for the 'coolify_system' tool. It handles 'health', 'version', and 'info' actions by making API calls to the Coolify server and returning formatted responses.

  async system(action: string) {
    switch (action) {
      case 'health':
        const healthResponse = await this.apiClient.get('/health');
        return { content: [{ type: 'text', text: JSON.stringify(healthResponse.data, null, 2) }] };
      case 'version':
        const versionResponse = await this.apiClient.get('/version');
        return { content: [{ type: 'text', text: JSON.stringify(versionResponse.data, null, 2) }] };
      case 'info':
        const [health, version] = await Promise.all([
          this.apiClient.get('/health'),
          this.apiClient.get('/version')
        ]);
        const systemInfo = {
          health: health.data,
          version: version.data,
          timestamp: new Date().toISOString()
        };
        return { content: [{ type: 'text', text: JSON.stringify(systemInfo, null, 2) }] };
      default:
        throw new Error(`Unknown system action: ${action}`);
    }
  }

• src/tools.ts:5-19 (schema)

  The tool definition including name, description, and input schema for validating parameters (action: health|version|info).

  {
    name: 'coolify_system',
    description: 'System management operations - health check, version, and system information',
    inputSchema: {
      type: 'object',
      properties: {
        action: { 
          type: 'string', 
          enum: ['health', 'version', 'info'],
          description: 'Action to perform: health (check system health), version (get API version), info (get system information)'
        },
      },
      required: ['action'],
    },
  },

• src/index.ts:88-90 (registration)

  The switch case in handleToolCall that registers and dispatches the 'coolify_system' tool call to its handler.

  case 'coolify_system':
    return await this.handlers.system(args.action);

• src/index.ts:60-64 (registration)

  The ListTools handler that registers the tool by including it in the exported tools list from getTools().

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