create_audit_cta

create_audit_cta MCP tool: add a call-to-action to the workspace, to use on teased sections of GEO Audit reports.

Updated 2026-11-05

create_audit_cta adds a CTA to the workspace: the overlay shown on the teased sections of a shared GEO Audit report.

When to use

Before launching an audit with a teaser, when list_audit_ctas has no CTA that fits. CTAs are reused across audits.

Input

Field Type Default Description
name string required Internal label, unique in the workspace, 60 characters at most
title string required Headline of the overlay, 120 characters at most
description string none Sub-headline, 280 characters at most
buttonLabel string required Button text, 40 characters at most
buttonUrl string required Button destination, http or https

Response

{
  "success": true,
  "cta": {
    "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-11-05T09:00:00.000Z"
  }
}

Errors: name_already_used, audits_unavailable (needs an active Agency plan, audits enabled and an admin API key).

Tips and patterns

  • Use it at launch: pass the id as config.ctaId with config.teaserSections in run_geo_audit.
  • Use it afterwards: pass the id to set_geo_audit_section_visibility.

Related tools

You can see where you stand today.

Free trial. Start tracking your AI visibility, no credit card.