# Optimly Developer Documentation Developer documentation for Optimly Connect, Site Analytics, Goals, Agent Analytics, and Optimly MCP. Contact: hello@optimly.ai. ## Documentation - [Optimly developer documentation](https://docs.optimly.ai/): Connect websites, measure outcomes, inspect agent activity, and use Optimly MCP. Updated 2026-08-09. - [Optimly Connect](https://docs.optimly.ai/connect/): Understand the Chrome extension's responsibilities, permissions, and installation state. Updated 2026-08-09. - [Install Optimly Connect](https://docs.optimly.ai/connect/install/): Bind a website, install the canonical Site Insights snippet, and configure CSP. Updated 2026-08-09. - [Verify an installation](https://docs.optimly.ai/connect/verify/): Prove that the collector accepted an event for the configured key and exact origin. Updated 2026-08-09. - [Install Optimly on Webflow](https://docs.optimly.ai/connect/webflow/): Add the generated snippet to Webflow and verify the published custom domain. Updated 2026-08-09. - [Install Optimly on a custom site](https://docs.optimly.ai/connect/custom-sites/): Install through a shared layout and the site's normal pull-request workflow. Updated 2026-08-09. - [Site Analytics](https://docs.optimly.ai/site-analytics/): Understand human browser reporting, AI-referred traffic, and agent activity boundaries. Updated 2026-08-09. - [Browser event model](https://docs.optimly.ai/site-analytics/events/): Review supported events, URL normalization, safe identifiers, and server matching. Updated 2026-08-09. - [Privacy and data boundaries](https://docs.optimly.ai/site-analytics/privacy/): See what the beacon excludes and how origin authorization and sessions work. Updated 2026-08-09. - [Site Analytics troubleshooting](https://docs.optimly.ai/site-analytics/troubleshooting/): Diagnose collection, origin, CSP, duplication, and goal-matching problems. Updated 2026-08-09. - [Goals](https://docs.optimly.ai/goals/): Turn observed website signals into tested, named business outcomes. Updated 2026-08-09. - [Goal signal quality](https://docs.optimly.ai/goals/signal-quality/): Distinguish confirmed outcomes, destinations reached, and engagement. Updated 2026-08-09. - [Track an explicit success event](https://docs.optimly.ai/goals/custom-events/): Emit and test a customer-defined event only after a real action succeeds. Updated 2026-08-09. - [Agent Analytics](https://docs.optimly.ai/agent-analytics/): Understand crawler evidence scopes, provider adapters, and reporting limits. Updated 2026-08-09. - [Optimly MCP](https://docs.optimly.ai/mcp/): Connect over Streamable HTTP and use OAuth or an Optimly brand API key. Updated 2026-08-09. - [Changelog](https://docs.optimly.ai/changelog/): Review release-sensitive changes to Optimly Connect, analytics, goals, and MCP. Updated 2026-08-09. - [MCP tool reference](https://docs.optimly.ai/mcp/tools/): Use the MCP tool reference to choose among 18 current Optimly tools and verify parameters, access, examples, and side effects. Updated 2026-08-09. - [Brand Lookup](https://docs.optimly.ai/mcp/tools/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. Updated 2026-08-09. - [Brand Narrative Check](https://docs.optimly.ai/mcp/tools/brand_narrative_check/): Return the current AI-perception narrative for a brand, including positioning, sentiment, accuracy gaps, competitive associations, claims, and sources when available. Updated 2026-08-09. - [Brand Compare](https://docs.optimly.ai/mcp/tools/brand_compare/): Compare a primary brand with up to five competitors on AI representation, archetype, BAI tier, sentiment, positioning, and key discrepancies. Updated 2026-08-09. - [Brand Action Plan](https://docs.optimly.ai/mcp/tools/brand_action_plan/): Generate prioritized recommendations for improving how AI represents a brand, grounded in its registry profile and source-graph findings. Updated 2026-08-09. - [Get Whitespace Candidates](https://docs.optimly.ai/mcp/tools/get_whitespace_candidates/): Return ranked information gaps for the selected brand, with observed demand, supply weakness, corroboration, score, status, and raw supporting evidence. Updated 2026-08-09. - [Update Candidate Status](https://docs.optimly.ai/mcp/tools/update_candidate_status/): Pin, target, hold, dismiss, or reopen a whitespace candidate. Targeted candidates require a durable action reference for attribution. Updated 2026-08-09. - [Brand Status](https://docs.optimly.ai/mcp/tools/brand_status/): Return Business Profile baseline version, last-edit timestamps, and section summaries for the authorized brand. Updated 2026-08-09. - [Business Profile](https://docs.optimly.ai/mcp/tools/brand_vault_profile/): Read all 15 verified ground-truth sections for the authorized brand. Updated 2026-08-09. - [Delta Report](https://docs.optimly.ai/mcp/tools/delta_report/): Return the latest or a selected Brand Authority Index audit summary, including run metadata and component scores. Updated 2026-08-09. - [Delta Report Details](https://docs.optimly.ai/mcp/tools/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. Updated 2026-08-09. - [Delta Report History](https://docs.optimly.ai/mcp/tools/delta_report_history/): List completed audit runs newest-first with component scores and run-over-run deltas. Updated 2026-08-09. - [Brand Sources](https://docs.optimly.ai/mcp/tools/brand_sources/): Aggregate citations from an audit and classify sources as owned or third-party, with grounded-answer rates and accuracy comparisons. Updated 2026-08-09. - [Competitive Analysis](https://docs.optimly.ai/mcp/tools/competitive_analysis/): Return the authorized brand's latest private competitive analysis across AI models. Updated 2026-08-09. - [Brand Monitor](https://docs.optimly.ai/mcp/tools/brand_monitor/): Report score changes, narrative drift, competitor movement, and alerts since a selected date. Updated 2026-08-09. - [Brand Site Audit](https://docs.optimly.ai/mcp/tools/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. Updated 2026-08-09. - [Publication Match](https://docs.optimly.ai/mcp/tools/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. Updated 2026-08-09. - [Publication Expand](https://docs.optimly.ai/mcp/tools/brand_publication_expand/): Find lookalike publications the brand does not yet win, labeling candidates by discovery source and verification level. Updated 2026-08-09. - [Execute Business Profile Update](https://docs.optimly.ai/mcp/tools/brand_update/): Execute one exactly approved Business Profile mutation. The call atomically starts the action and consumes its approval. Updated 2026-08-09. ## Retrieval resources - [Complete section-chunked documentation](https://docs.optimly.ai/docs-llms-full.txt) - [Structured section search index](https://docs.optimly.ai/search-index.json)