Mentionable
Mentionable

set_geo_audit_section_visibility

set_geo_audit_section_visibility MCP tool: set a GEO Audit section to visible, teased (behind a CTA), or hidden in the white-label report.

Updated 2026-07-23

set_geo_audit_section_visibility sets how one section of a white-label GEO Audit report appears: visible (shown in full), teased (blurred behind a CTA), or hidden (removed). It mirrors the curation an owner does by hand before sharing an audit with a prospect.

When to use

When preparing a GEO Audit for sharing: hide sections you don't want the prospect to see, tease the ones you want to gate behind a call-to-action, and leave the rest visible. Tease a section to drive conversions while showing there is more behind it.

Input

Field Type Description
auditId string (CUID) The GEO Audit id.
section enum One of competitorRanking, personas, competitorMatrix, promptCoverage, recommendations, contentIdeas, topSources.
visibility enum visible, teased, or hidden.
ctaId string (CUID), optional The CTA shown on teased sections. Required (here or already set on the audit) when visibility is teased. Pass null to clear it; omit to keep the current one.

GEO Audits are workspace-scoped, so this tool takes no projectId. Requires a non read-only API key. The CTA is audit-level: one CTA applies to every teased section.

Response

Success

{
  "success": true,
  "auditId": "clx_audit_42",
  "section": "recommendations",
  "visibility": "teased",
  "teaserSections": ["recommendations"],
  "hiddenSections": ["topSources"],
  "ctaId": "clx_cta_1"
}

teaserSections and hiddenSections are the full resulting sets after the change.

Errors

{ "success": false, "error": "cta_required", "message": "Teasing a section requires a CTA. Pass ctaId (see list_audit_ctas) or set one first." }
{ "success": false, "error": "cta_not_found", "message": "No CTA with this id exists in your workspace. Use list_audit_ctas to get a valid id." }
{ "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

  • Get a CTA id first with list_audit_ctas before teasing.
  • One CTA per audit. Setting ctaId while teasing changes the CTA for all teased sections of that audit.
  • A section is in exactly one state. Switching to visible removes it from both the teased and hidden sets.

Related tools