Coolify MCP Server

Instructions

Implementation Reference

• src/index.ts:149-157 (handler)

  Handler for the 'list-resources' tool. It calls the Coolify API at '/resources' using the helper function and returns the JSON-formatted list of resources as text content.

  case "list-resources": {
    const resources = await coolifyApiCall('/resources');
    return {
      content: [{
        type: "text",
        text: JSON.stringify(resources, null, 2)
      }]
    };
  }

• src/index.ts:83-87 (registration)

  Registration of the 'list-resources' tool in the list of available tools, including its name, description, and empty input schema (no parameters required).

  {
    name: "list-resources",
    description: "Retrieve a comprehensive list of all resources managed by Coolify. This includes applications, services, databases, and deployments.",
    inputSchema: zodToJsonSchema(z.object({})),
  },

• src/index.ts:86-86 (schema)

  Input schema for 'list-resources' tool: an empty object, indicating no input parameters are required.

  inputSchema: zodToJsonSchema(z.object({})),

• src/index.ts:24-47 (helper)

  Helper function 'coolifyApiCall' used by the 'list-resources' handler (and others) to make authenticated API calls to the Coolify server.

  async function coolifyApiCall(endpoint: string, method: string = 'GET', body?: any): Promise<any> {
    const baseUrl = process.env.COOLIFY_BASE_URL?.replace(/\/$/, '') || 'https://coolify.stuartmason.co.uk';
    const url = `${baseUrl}/api/v1${endpoint}`;
  
    const response = await fetch(url, {
      method,
      headers: {
        'Authorization': `Bearer ${process.env.COOLIFY_ACCESS_TOKEN}`,
        'Content-Type': 'application/json',
      },
      body: body ? JSON.stringify(body) : undefined,
    });
  
    if (!response.ok) {
      const errorBody = await response.json().catch(() => ({}));
      throw new Error(JSON.stringify({
        error: `Coolify API error: ${response.status} ${response.statusText}`,
        status: response.status,
        details: errorBody
      }));
    }
  
    return await response.json();
  }