Coolify MCP Server

Instructions

Implementation Reference

• src/handlers.ts:207-218 (handler)

  The primary handler function for executing the 'coolify_logs' tool. It validates the UUID, constructs the API endpoint for fetching application logs (with optional lines parameter), calls the Coolify API client, and returns the logs as formatted JSON text content.

  async logs(action: string, uuid: string, lines?: number) {
    if (!uuid) throw new Error('Application UUID is required for logs action');
    
    switch (action) {
      case 'get':
        const endpoint = lines ? `/applications/${uuid}/logs?lines=${lines}` : `/applications/${uuid}/logs`;
        const response = await this.apiClient.get(endpoint);
        return { content: [{ type: 'text', text: JSON.stringify(response.data, null, 2) }] };
      default:
        throw new Error(`Unknown logs action: ${action}`);
    }
  }

• src/tools.ts:293-314 (schema)

  The input schema definition for the 'coolify_logs' tool, specifying the required 'action' (only 'get'), 'uuid', and optional 'lines' parameters.

    name: 'coolify_logs',
    description: 'Application logs and monitoring - get application logs',
    inputSchema: {
      type: 'object',
      properties: {
        action: { 
          type: 'string', 
          enum: ['get'],
          description: 'Action to perform: get (get application logs)'
        },
        uuid: { 
          type: 'string', 
          description: 'Application UUID (required for get action)' 
        },
        lines: { 
          type: 'number', 
          description: 'Number of log lines to retrieve (optional for get action)' 
        },
      },
      required: ['action', 'uuid'],
    },
  },

• src/index.ts:108-109 (registration)

  The switch case in handleToolCall that registers and dispatches 'coolify_logs' tool calls to the appropriate handler method.

  case 'coolify_logs':
    return await this.handlers.logs(args.action, args.uuid, args.lines);