Coolify MCP Server

Instructions

Implementation Reference

• src/tools/handlers.ts:147-149 (handler)

  Handler implementation for the 'get_application' tool. Requires 'uuid' parameter and fetches application details via Coolify API client.get('/applications/{uuid}').

  case 'get_application':
    requireParam(args, 'uuid');
    return client.get(`/applications/${args.uuid}`);

• src/tools/definitions.ts:260-268 (schema)

  Schema definition for the 'get_application' tool, specifying input parameters and structure.

  {
    name: 'get_application',
    description: 'Get application details',
    inputSchema: {
      type: 'object',
      properties: { uuid: { type: 'string', description: 'Application UUID' } },
      required: ['uuid']
    }
  },

• src/index.ts:36-38 (registration)

  Registration of tool list handler which exposes the 'get_application' tool via getToolDefinitions().

  this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: getToolDefinitions()
  }));

• src/index.ts:57-67 (registration)

  MCP CallToolRequestHandler that dispatches to handleTool, which implements 'get_application'.

      const result = await handleTool(this.client, name, args || {});
      return {
        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }]
      };
    } catch (error) {
      if (error instanceof McpError) throw error;
      
      const message = error instanceof Error ? error.message : 'Unknown error';
      throw new McpError(ErrorCode.InternalError, `Tool execution failed: ${message}`);
    }
  });

• src/tools/definitions.ts:21-21 (helper)

  'get_application' listed in READ_ONLY_TOOLS array for read-only mode filtering.

  'get_application',