list_geo_audits returns the GEO Audits (one-shot white-label audits) for the workspace, newest first. Each row carries the status, the audited prospect URL, the brand name, the target country and language, the selected LLMs and a progress counter. Unlike Page Audits, GEO Audits are workspace-scoped, not tied to a single project, so this tool takes no projectId.

When to use

For agencies producing many audits via the MCP: list the whole workspace and read the state of every audit without opening the UI.
To find audits stuck at competitor selection (filter with status=REVIEWING) before they can move to insight generation.
To track which audits have reached COMPLETED and are ready to read with get_geo_audit.

This tool lists the one-shot GEO Audits only. It does not return Page Audits (OptimizationReport); use list_page_audits for those.

Input

Field	Type	Default	Description
`cursor`	string	—	Cursor returned in `pageInfo.nextCursor`.
`limit`	int	20	Max items, 1–100.
`status`	enum	—	One of `PENDING`, `SCANNING`, `REVIEWING`, `GENERATING`, `COMPLETED`. Omit to return all.

Response

{
  "data": [
    {
      "id": "clx_audit_42",
      "prospectUrl": "https://prospect.com",
      "brandName": "Prospect",
      "status": "REVIEWING",
      "country": "US",
      "language": "en",
      "llms": ["CHATGPT", "PERPLEXITY"],
      "creditsCost": 24,
      "shareSlug": "prospect-9f3a",
      "progress": { "received": 6, "expected": 24 },
      "createdAt": "2026-06-20T09:00:00.000Z",
      "completedAt": null
    }
  ],
  "pageInfo": { "hasMore": false, "nextCursor": null, "totalCount": 1 }
}

Field notes:

status follows the GEO Audit lifecycle: PENDING (created, scan not started), SCANNING (LLM scans running), REVIEWING (scans done, paused for competitor selection), GENERATING (competitors picked, insights being written), COMPLETED (frozen, report ready).
progress.received / progress.expected count scan results. They let you estimate how far a SCANNING audit is from REVIEWING.
completedAt is null until the audit reaches COMPLETED.

Tips and patterns

Pagination: the cursor is the audit's id. Stable across page boundaries.
Pair with get_geo_audit: this tool returns metadata only. To read the recommendations, content ideas and selected competitors, call get_geo_audit with the id.
Watch for REVIEWING: an audit parked at REVIEWING waits for a human (or an agent) to confirm competitors. Surface these so they don't stall silently.

Related tools

get_geo_audit — fetch a single GEO Audit (full content when COMPLETED).
list_page_audits — list Page Audits (page-level optimizations), a different object.