Optimly MCP
MCP tool reference
Use the MCP tool reference to choose among 18 current Optimly tools and verify parameters, access, examples, and side effects.
brand_lookup— Look up a brand in the Optimly Brand Trust Registry by name or slug. Returns its public registry identity, BAI tier, archetype, category, and profile URL.brand_narrative_check— Return the current AI-perception narrative for a brand, including positioning, sentiment, accuracy gaps, competitive associations, claims, and sources when available.brand_compare— Compare a primary brand with up to five competitors on AI representation, archetype, BAI tier, sentiment, positioning, and key discrepancies.brand_action_plan— Generate prioritized recommendations for improving how AI represents a brand, grounded in its registry profile and source-graph findings.get_whitespace_candidates— Return ranked information gaps for the selected brand, with observed demand, supply weakness, corroboration, score, status, and raw supporting evidence.update_candidate_status— Pin, target, hold, dismiss, or reopen a whitespace candidate. Targeted candidates require a durable action reference for attribution.brand_status— Return Business Profile baseline version, last-edit timestamps, and section summaries for the authorized brand.brand_vault_profile— Read all 15 verified ground-truth sections for the authorized brand.delta_report— Return the latest or a selected Brand Authority Index audit summary, including run metadata and component scores.delta_report_details— Return per-question, per-model answers from a completed audit, including answer text, expected ground truth, accuracy, and owned versus third-party citations.delta_report_history— List completed audit runs newest-first with component scores and run-over-run deltas.brand_sources— Aggregate citations from an audit and classify sources as owned or third-party, with grounded-answer rates and accuracy comparisons.competitive_analysis— Return the authorized brand's latest private competitive analysis across AI models.brand_monitor— Report score changes, narrative drift, competitor movement, and alerts since a selected date.brand_site_audit— Audit key website pages from an AI crawler's perspective: rendering, AI-bot robots rules, structured data, metadata, llms.txt, status, and visible content.brand_publication_match— Rank third-party publications and the category angles they own in the brand's citation graph, including authority, model breadth, accuracy, and pitch signals.brand_publication_expand— Find lookalike publications the brand does not yet win, labeling candidates by discovery source and verification level.brand_update— Execute one exactly approved Business Profile mutation. The call atomically starts the action and consumes its approval.