{
 "categories": [
  "reporting",
  "marketing"
 ],
 "deployment": "saas",
 "evidence": [
  {
   "date": "2026-09-11",
   "fact": "homepage",
   "note": "Microsoft presents Clarity as a free heatmaps and session-recordings product for sites and apps, with MCP server and browser-extension connections listed on the product page.",
   "source": "https://clarity.microsoft.com/",
   "tier": "declared"
  },
  {
   "date": "2026-09-11",
   "fact": "license",
   "note": "The product page states Clarity is free forever and GDPR and CCPA ready. This pass did not open a paid-tier price list.",
   "source": "https://clarity.microsoft.com/",
   "tier": "declared"
  },
  {
   "date": "2026-09-11",
   "fact": "platforms",
   "note": "The product page documents a web console plus mobile-app analytics with a lightweight SDK that supports Android, iOS, Flutter, and React Native.",
   "source": "https://clarity.microsoft.com/",
   "tier": "declared"
  },
  {
   "date": "2026-09-11",
   "fact": "modalities.api.exists",
   "note": "Microsoft documents the Clarity Data Export API as a REST interface that downloads dashboard data as JSON for analysis and system integration.",
   "source": "https://learn.microsoft.com/en-us/clarity/setup-and-installation/clarity-data-export-api",
   "tier": "declared"
  },
  {
   "date": "2026-09-11",
   "fact": "modalities.api.kinds[0]",
   "note": "The documented endpoint is GET https://www.clarity.ms/export-data/api/v1/project-live-insights. Microsoft requires familiarity with RESTful APIs and JSON.",
   "source": "https://learn.microsoft.com/en-us/clarity/setup-and-installation/clarity-data-export-api",
   "tier": "declared"
  },
  {
   "date": "2026-09-11",
   "fact": "modalities.api.auth[0]",
   "note": "Access is secured via JWT tokens. Project admins generate a token under Settings, Data Export. Callers send Authorization: Bearer with the token.",
   "source": "https://learn.microsoft.com/en-us/clarity/setup-and-installation/clarity-data-export-api",
   "tier": "declared"
  },
  {
   "date": "2026-09-11",
   "fact": "modalities.api.coverage",
   "note": "The API fetches dashboard insights only. Limits are 10 requests per project per day, previous 1 to 3 days, three dimensions, and 1,000 unpaginated rows. HTTP 429 is documented for the daily cap.",
   "source": "https://learn.microsoft.com/en-us/clarity/setup-and-installation/clarity-data-export-api",
   "tier": "declared"
  },
  {
   "date": "2026-09-11",
   "fact": "modalities.api.docs",
   "note": "Opened Microsoft's current Data Export API page, including token rules, curl and Python examples, dimensions, metrics, and quota errors.",
   "source": "https://learn.microsoft.com/en-us/clarity/setup-and-installation/clarity-data-export-api",
   "tier": "declared"
  },
  {
   "date": "2026-09-11",
   "fact": "modalities.sdk.exists",
   "note": "Microsoft documents an official Clarity Android SDK on Maven Central (com.microsoft.clarity:clarity) for capturing app sessions.",
   "source": "https://learn.microsoft.com/en-us/clarity/mobile-sdk/android-sdk",
   "tier": "declared"
  },
  {
   "date": "2026-09-11",
   "fact": "modalities.sdk.languages[0]",
   "note": "Microsoft documents a JavaScript client API on window.clarity for consent, identify, custom tags, events, and session upgrade.",
   "source": "https://learn.microsoft.com/en-us/clarity/setup-and-installation/clarity-api",
   "tier": "declared"
  },
  {
   "date": "2026-09-11",
   "fact": "modalities.sdk.languages[1]",
   "note": "The official Android SDK is installed as a Java/Kotlin Maven dependency and initialized with Clarity.initialize.",
   "source": "https://learn.microsoft.com/en-us/clarity/mobile-sdk/android-sdk",
   "tier": "declared"
  },
  {
   "date": "2026-09-11",
   "fact": "modalities.sdk.languages[2]",
   "note": "Microsoft documents an official Clarity iOS SDK as a Swift package (microsoft/clarity-apps, product Clarity) and a CocoaPods pod.",
   "source": "https://learn.microsoft.com/en-us/clarity/mobile-sdk/ios-sdk",
   "tier": "declared"
  },
  {
   "date": "2026-09-11",
   "fact": "modalities.sdk.official",
   "note": "The Android and iOS installation pages are first-party Microsoft Learn SDK guides published under the Clarity documentation set.",
   "source": "https://learn.microsoft.com/en-us/clarity/mobile-sdk/android-sdk",
   "tier": "declared"
  },
  {
   "date": "2026-09-11",
   "fact": "modalities.mcp.first_party",
   "note": "Microsoft Learn documents the Microsoft Clarity MCP Server. Install is npx @microsoft/clarity-mcp-server with a Data Export API token.",
   "source": "https://learn.microsoft.com/en-us/clarity/third-party-integrations/clarity-mcp-server",
   "tier": "declared"
  },
  {
   "date": "2026-09-11",
   "fact": "modalities.mcp.verdict",
   "note": "The Learn page is vendor documentation for the Clarity MCP Server and points to the microsoft/clarity-mcp-server GitHub repository for extra configuration.",
   "source": "https://learn.microsoft.com/en-us/clarity/third-party-integrations/clarity-mcp-server",
   "tier": "declared"
  },
  {
   "date": "2026-09-11",
   "fact": "modalities.extensibility.scripting[0]",
   "note": "The Clarity client API lets sites call window.clarity from page JavaScript for consent, identifiers, tags, events, masking, and upgrade.",
   "source": "https://learn.microsoft.com/en-us/clarity/setup-and-installation/clarity-api",
   "tier": "declared"
  },
  {
   "date": "2026-09-11",
   "fact": "modalities.data_access.export[0]",
   "note": "The Data Export API returns dashboard data structured in JSON. Sample responses are JSON arrays of metricName and information objects.",
   "source": "https://learn.microsoft.com/en-us/clarity/setup-and-installation/clarity-data-export-api",
   "tier": "declared"
  },
  {
   "date": "2026-09-11",
   "fact": "verdict.scores.api",
   "note": "The REST export path is documented, JSON, and JWT-authenticated, but it is one read-only insights endpoint with a 10-request daily cap, a 3-day window, and a 1,000-row ceiling. That is useful work with material operational limits, not broad production coverage.",
   "source": "https://learn.microsoft.com/en-us/clarity/setup-and-installation/clarity-data-export-api",
   "tier": "declared"
  },
  {
   "date": "2026-09-11",
   "fact": "verdict.scores.mcp",
   "note": "The official local server is maintained and useful for natural-language analytics queries, but Learn applies the same 10-request-per-day Data Export quota. The score stays in the limited official-preview band.",
   "source": "https://learn.microsoft.com/en-us/clarity/third-party-integrations/clarity-mcp-server",
   "tier": "declared"
  },
  {
   "date": "2026-09-11",
   "fact": "freshness.watch[0].url",
   "note": "Opened Microsoft's current Clarity MCP Server page, including npx install, Data Export token, 10 requests per day, 3-day window, and planned limit increases.",
   "source": "https://learn.microsoft.com/en-us/clarity/third-party-integrations/clarity-mcp-server",
   "tier": "declared"
  },
  {
   "date": "2026-09-11",
   "fact": "freshness.watch[1].url",
   "note": "Opened Microsoft's current Data Export API reference, including JWT Bearer auth, quotas, and the project-live-insights endpoint.",
   "source": "https://learn.microsoft.com/en-us/clarity/setup-and-installation/clarity-data-export-api",
   "tier": "declared"
  },
  {
   "date": "2026-09-11",
   "fact": "freshness.watch[2].url",
   "note": "Opened the vendor microsoft/clarity-mcp-server repository. The README documents @microsoft/clarity-mcp-server and the query-analytics-dashboard, list-session-recordings, and query-documentation-resources tools.",
   "source": "https://github.com/microsoft/clarity-mcp-server",
   "tier": "declared"
  }
 ],
 "freshness": {
  "last_verified": "2026-09-11",
  "volatility": "medium",
  "watch": [
   {
    "type": "mcp",
    "url": "https://learn.microsoft.com/en-us/clarity/third-party-integrations/clarity-mcp-server"
   },
   {
    "type": "docs",
    "url": "https://learn.microsoft.com/en-us/clarity/setup-and-installation/clarity-data-export-api"
   },
   {
    "type": "mcp",
    "url": "https://github.com/microsoft/clarity-mcp-server"
   }
  ]
 },
 "homepage": "https://clarity.microsoft.com/",
 "id": "microsoft-clarity",
 "license": "free",
 "modalities": {
  "agent_docs": {
   "llms_txt": "unknown"
  },
  "api": {
   "auth": [
    "bearer-token"
   ],
   "coverage": "read-only",
   "docs": "https://learn.microsoft.com/en-us/clarity/setup-and-installation/clarity-data-export-api",
   "exists": true,
   "kinds": [
    "rest"
   ]
  },
  "cli": {
   "exists": "unknown"
  },
  "computer_use": {
   "issues": [],
   "viability": "unknown"
  },
  "data_access": {
   "export": [
    "json"
   ],
   "import": []
  },
  "extensibility": {
   "scripting": [
    "javascript-client-api"
   ],
   "webhooks": "unknown"
  },
  "integrations": {
   "make": "unknown",
   "n8n": "unknown",
   "power_automate": "unknown",
   "zapier": "unknown"
  },
  "mcp": {
   "first_party": true,
   "third_party": [],
   "verdict": "official"
  },
  "rpa": {
   "drivability": "unknown",
   "notes": "No repeatable UI probe was run. The Data Export API, official instrumentation SDKs, JavaScript client API, and first-party Clarity MCP Server cover analytics export and session capture without browser control of the Clarity dashboard.\n",
   "ui_stack": [
    "web-dom"
   ],
   "vendor_support": []
  },
  "sdk": {
   "exists": true,
   "languages": [
    "javascript",
    "java",
    "swift"
   ],
   "official": true
  }
 },
 "name": "Microsoft Clarity",
 "platforms": [
  "web",
  "ios",
  "android"
 ],
 "related": {
  "alternatives": [
   "google-analytics",
   "mixpanel",
   "amplitude"
  ],
  "our_products": []
 },
 "schema_version": 1,
 "score_version": 1,
 "status": "active",
 "vendor": "Microsoft",
 "verdict": {
  "best_path": "api",
  "scores": {
   "api": 5,
   "cli": null,
   "computer_use": null,
   "integrations": null,
   "mcp": 5,
   "overall": 5,
   "rpa": null
  },
  "summary": "Microsoft Clarity session replay and heat-map analytics is automatable today through a documented Data Export REST API and a first-party MCP Server. This record is Clarity, not Google Analytics, Mixpanel, Amplitude, or Microsoft Sentinel. GET https://www.clarity.ms/export-data/api/v1/project-live-insights returns dashboard insights as JSON. Authentication is a project-admin JWT sent as Authorization: Bearer. Coverage is read-only live insights: last 1 to 3 days, at most three dimensions, 1,000 rows, no pagination, and 10 requests per project per day. The JavaScript client API and official Android, iOS, Flutter, and React Native SDKs instrument sites and apps; they do not replace the export API. Microsoft documents @microsoft/clarity-mcp-server, started with npx and the same Data Export token. Learn states the same 10-request daily cap, 3-day window, and three-dimension limit for MCP. The vendor GitHub README also lists query-analytics-dashboard, list-session-recordings, and query-documentation-resources. Connector catalogs were not opened. No official general operations CLI was established. Computer-use viability is unassessed. API and MCP both score 5; API is the best path because it is the durable export contract and does not require an MCP host.\n"
 }
}