coolify_server_management

Validate server connections, list domains, and manage resources for infrastructure oversight using server UUID and action parameters.

Instructions

Server operations and resources - validate server connection, list domains, and list resources

Input Schema

TableJSON Schema

Name	Required	Description	Default
`action`	Yes	Action to perform: validate (validate server connection), domains (list server domains), resources (list server resources)
`uuid`	Yes	Server UUID (required for all actions)

Implementation Reference

src/handlers.ts:345-361 (handler)

The serverManagement method in the CoolifyHandlers class executes the coolify_server_management tool. It handles the three supported actions (validate, domains, resources) by making API calls to the Coolify server endpoints using the provided server UUID and returns the JSON-stringified response.

async serverManagement(action: string, uuid: string) {
  if (!uuid) throw new Error('Server UUID is required for all server management actions');
  
  switch (action) {
    case 'validate':
      const validateResponse = await this.apiClient.get(`/servers/${uuid}/validate`);
      return { content: [{ type: 'text', text: JSON.stringify(validateResponse.data, null, 2) }] };
    case 'domains':
      const domainsResponse = await this.apiClient.get(`/servers/${uuid}/domains`);
      return { content: [{ type: 'text', text: JSON.stringify(domainsResponse.data, null, 2) }] };
    case 'resources':
      const resourcesResponse = await this.apiClient.get(`/servers/${uuid}/resources`);
      return { content: [{ type: 'text', text: JSON.stringify(resourcesResponse.data, null, 2) }] };
    default:
      throw new Error(`Unknown server management action: ${action}`);
  }
}

src/tools.ts:537-555 (schema)

Defines the Tool object for coolify_server_management in the getTools() array, including name, description, and inputSchema specifying the action enum and required server uuid.

{
  name: 'coolify_server_management',
  description: 'Server operations and resources - validate server connection, list domains, and list resources',
  inputSchema: {
    type: 'object',
    properties: {
      action: { 
        type: 'string', 
        enum: ['validate', 'domains', 'resources'],
        description: 'Action to perform: validate (validate server connection), domains (list server domains), resources (list server resources)'
      },
      uuid: { 
        type: 'string', 
        description: 'Server UUID (required for all actions)' 
      },
    },
    required: ['action', 'uuid'],
  },
},

src/index.ts:124-125 (registration)
Registers the coolify_server_management tool in the MCP server's handleToolCall switch statement by dispatching to the handlers.serverManagement method.
```
case 'coolify_server_management':
  return await this.handlers.serverManagement(args.action, args.uuid);
```

Coolify MCP Server