list_audit_ctas
list_audit_ctas MCP tool: list the workspace's audit CTAs (call-to-action overlays) to pick one when teasing a GEO Audit section.
Updated 2026-07-23
list_audit_ctas returns the workspace's audit CTAs (the call-to-action overlays shown on teased sections of a white-label GEO Audit). Use it to pick a CTA id before teasing a section with set_geo_audit_section_visibility.
When to use
Before teasing a GEO Audit section (which requires a CTA), list the available CTAs and pass the chosen id. CTAs are workspace-level, reused across audits.
Input
This tool takes no parameters. It is scoped to the API key's workspace.
Response
{
"data": [
{
"id": "clx_cta_1",
"name": "Discovery call",
"title": "Want the full report?",
"description": "Book a 20-minute call and we'll walk you through it.",
"buttonLabel": "Book a call",
"buttonUrl": "https://cal.com/agency/discovery",
"createdAt": "2026-05-01T09:00:00.000Z"
}
]
}
Field notes:
nameis the internal label (shown in pickers);title/description/buttonLabel/buttonUrlare what the prospect sees in the overlay.- CTAs belong to the workspace, not a project or a single audit.
Tips and patterns
- Pair with
set_geo_audit_section_visibility: teasing a section requires a CTA id from this list, otherwise the call returnscta_required. - One CTA per audit: the chosen CTA applies to every teased section of that audit.
Related tools
- set_geo_audit_section_visibility — tease a section with one of these CTAs.
- get_geo_audit — read the audit itself.