Coolify MCP Server

Instructions

Implementation Reference

• src/index.ts:191-200 (handler)

  Handler for the 'stop-application' tool. Parses the UUID from input arguments, calls the Coolify API endpoint `/applications/{uuid}/stop` to stop the application, and returns the JSON result as text content.

  case "stop-application": {
    const { uuid } = UuidSchema.parse(request.params.arguments);
    const result = await coolifyApiCall(`/applications/${uuid}/stop`);
    return {
      content: [{
        type: "text",
        text: JSON.stringify(result, null, 2)
      }]
    };
  }

• src/index.ts:50-52 (schema)

  Zod schema used for input validation of the 'stop-application' tool, requiring a 'uuid' string parameter.

  const UuidSchema = z.object({
    uuid: z.string().describe("Resource UUID"),
  });

• src/index.ts:104-107 (registration)

  Registration of the 'stop-application' tool in the ListTools response, including name, description, and input schema.

    name: "stop-application",
    description: "Stop a specific application using its UUID. This halts the application and makes it unavailable.",
    inputSchema: zodToJsonSchema(UuidSchema),
  },

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

  Helper function used by the 'stop-application' handler 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();
  }