Coolify MCP Server

Instructions

Implementation Reference

• src/tools/handlers.ts:59-61 (handler)

  The handler logic for the 'get_team' tool. Validates 'team_id' parameter and calls the Coolify API to fetch team details.

  case 'get_team':
    requireParam(args, 'team_id');
    return client.get(`/teams/${args.team_id}`);

• src/tools/definitions.ts:129-139 (schema)

  Input schema and description for the 'get_team' tool, defining the required 'team_id' parameter.

  {
    name: 'get_team',
    description: 'Get details of a specific team',
    inputSchema: {
      type: 'object',
      properties: {
        team_id: { type: 'string', description: 'Team ID' }
      },
      required: ['team_id']
    }
  },

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

  Registration of tools via MCP Server's listTools handler, which returns all tool definitions including 'get_team' from getToolDefinitions().

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

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

  Tool execution handler in MCP Server that dispatches to handleTool, which contains the 'get_team' case.

  const result = await handleTool(this.client, name, args || {});

• src/tools/handlers.ts:504-508 (helper)

  Helper function used by 'get_team' handler to validate required parameters.

  function requireParam(args: ToolArgs, param: string): void {
    if (!args[param]) {
      throw new McpError(ErrorCode.InvalidParams, `${param} is required`);
    }
  }