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:

  • name is the internal label (shown in pickers); title / description / buttonLabel / buttonUrl are 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 returns cta_required.
  • One CTA per audit: the chosen CTA applies to every teased section of that audit.

Related tools