Mentionable
Mentionable

set_geo_audit_recommendation_visibility

set_geo_audit_recommendation_visibility MCP tool: show or hide a generated recommendation in a GEO Audit report by its hash.

Updated 2026-07-23

set_geo_audit_recommendation_visibility shows or hides a single generated recommendation in a white-label GEO Audit report, identified by its hash. Use it for finer-grained curation than hiding a whole section: keep the recommendations section visible but drop the one or two items you don't want the prospect to see.

When to use

After listing recommendations with list_geo_audit_recommendations, hide a specific generated recommendation by its hash, or restore a hidden one. Custom recommendations are not toggled here; add or remove them with add_geo_audit_recommendation / remove_geo_audit_recommendation.

Input

Field Type Description
auditId string (CUID) The GEO Audit id.
recoId string The recommendation hash from list_geo_audit_recommendations (generated[].hash).
hidden boolean true to hide, false to show.

GEO Audits are workspace-scoped, so this tool takes no projectId. Requires a non read-only API key; single audits only.

Response

Success

{ "success": true, "auditId": "clx_audit_42", "recoId": "1a2b3c4d", "hidden": true }

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 visibility is managed at the campaign level, not via this tool." }

Tips and patterns

  • Use the hash, not a title. Get it from list_geo_audit_recommendations (generated[].hash).
  • Hiding is reversible and idempotent: setting hidden: false restores the recommendation.
  • For whole sections, use set_geo_audit_section_visibility instead.

Related tools