Optimly Developer Documentation

Optimly MCP

MCP tool reference

In short

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.