Mentionable
Mentionable

list_geo_audit_recommendations

list_geo_audit_recommendations MCP tool: a GEO Audit's generated recommendations (with hash and hidden flag) and the custom ones added on top.

Updated 2026-07-23

list_geo_audit_recommendations returns the recommendations of a GEO Audit: the AI-generated ones produced when the audit completed, and the custom ones an owner (or an agent) added on top. Use it to read the current state before adding or removing custom recommendations with add_geo_audit_recommendation / remove_geo_audit_recommendation.

When to use

Before editing a GEO Audit's recommendations via the MCP, list them so you don't duplicate an existing one and so you have the id of a custom recommendation you want to remove. Read-only, tenant-scoped, single audits only.

Input

Field Type Description
auditId string (CUID) The GEO Audit id returned by list_geo_audits.

GEO Audits are workspace-scoped, so this tool takes no projectId.

Response

{
  "success": true,
  "auditId": "clx_audit_42",
  "generated": [
    {
      "category": "technical",
      "severity": "critical",
      "title": "Add FAQ schema to the pricing page",
      "description": "...",
      "metric": { "value": 0.42, "label": "of pages missing schema" },
      "hash": "1a2b3c4d",
      "hidden": false
    }
  ],
  "custom": [
    { "id": "cus_ab12cd34", "category": "content", "severity": "important", "title": "Publish a comparison page", "description": "..." }
  ]
}

Field notes:

  • generated recommendations are frozen at audit completion and have no stored id. Each carries a deterministic hash (derived from category + title) and a hidden flag reflecting the report's visibility settings.
  • custom recommendations each have a stable id (the handle to remove them).
  • category is technical | content | distribution; severity is critical | important | nice-to-have.

Errors

{ "success": false, "error": "audit_not_found", "message": "No GEO audit with this id exists in your workspace. ..." }
{ "success": false, "error": "bulk_unsupported", "message": "This audit is part of a bulk campaign; its recommendations are managed at the campaign level, not via this tool." }

Tips and patterns

  • List before you add to avoid near-duplicate recommendations.
  • The id on custom items is what remove_geo_audit_recommendation consumes; generated items have a hash, not an id, and cannot be removed (only hidden).

Related tools