Coolify MCP Server

Instructions

Implementation Reference

• src/handlers.ts:305-342 (handler)

  Handler function implementing the logic for the 'coolify_servers' tool. It handles CRUD operations (list, create, get, update, delete) for servers by making API calls to Coolify endpoints.
  async servers(action: string, args: any) { switch (action) { case 'list': const queryString = this.apiClient.buildQueryString(args); const response = await this.apiClient.get(`/servers?${queryString}`); return { content: [{ type: 'text', text: JSON.stringify(response.data, null, 2) }] }; case 'create': const createResponse = await this.apiClient.post('/servers', { name: args.name, description: args.description, ip: args.ip, port: args.port || 22, user: args.user || 'root', private_key_id: args.private_key_id, }); return { content: [{ type: 'text', text: JSON.stringify(createResponse.data, null, 2) }] }; case 'get': if (!args.uuid) throw new Error('Server UUID is required for get action'); const getResponse = await this.apiClient.get(`/servers/${args.uuid}`); return { content: [{ type: 'text', text: JSON.stringify(getResponse.data, null, 2) }] }; case 'update': if (!args.uuid) throw new Error('Server UUID is required for update action'); const updateResponse = await this.apiClient.patch(`/servers/${args.uuid}`, { name: args.name, description: args.description, ip: args.ip, port: args.port, user: args.user, }); return { content: [{ type: 'text', text: JSON.stringify(updateResponse.data, null, 2) }] }; case 'delete': if (!args.uuid) throw new Error('Server UUID is required for delete action'); await this.apiClient.delete(`/servers/${args.uuid}`); return { content: [{ type: 'text', text: 'Server deleted successfully' }] }; default: throw new Error(`Unknown servers action: ${action}`); } }
• src/tools.ts:484-534 (schema)

  Input schema definition for the 'coolify_servers' tool, specifying parameters for server CRUD operations.
  { name: 'coolify_servers', description: 'Server CRUD operations - list, create, get, update, and delete servers', inputSchema: { type: 'object', properties: { action: { type: 'string', enum: ['list', 'create', 'get', 'update', 'delete'], description: 'Action to perform: list (list all servers), create (create new server), get (get server by UUID), update (update server), delete (delete server)' }, uuid: { type: 'string', description: 'Server UUID (required for get, update, delete actions)' }, name: { type: 'string', description: 'Server name (required for create, optional for update)' }, description: { type: 'string', description: 'Server description (optional for create and update)' }, ip: { type: 'string', description: 'Server IP address (required for create, optional for update)' }, port: { type: 'number', description: 'SSH port (optional for create and update, default: 22)' }, user: { type: 'string', description: 'SSH user (optional for create and update, default: root)' }, private_key_id: { type: 'string', description: 'Private key ID (optional for create action)' }, page: { type: 'number', description: 'Page number (optional for list action)' }, per_page: { type: 'number', description: 'Items per page (optional for list action)' }, }, required: ['action'], }, },
• src/index.ts:122-123 (registration)

  Registration of the 'coolify_servers' tool handler in the MCP server's tool call dispatcher switch statement.
  case 'coolify_servers': return await this.handlers.servers(args.action, args);