All servers / Analytics / Microsoft Clarity MCP server
Microsoft Clarity MCP server
The official MCP server for Microsoft Clarity
Tested by ConnectATDScore 92 out of 100. Tested 2026-11-18 on package version 3.0.0. Package: @microsoft/clarity-mcp-server · source
Score breakdown
| Runs | 18 / 20 | |
|---|---|---|
| Tool descriptions | 18 / 20 | |
| Package safety | 20 / 20 | |
| Maintenance | 20 / 20 | |
| Adoption | 16 / 20 |
What we saw
- Starts and answers the MCP handshake: yes (4.1 seconds including download)
- Tools offered: 30
- Last published: 2026-11-16
- Weekly downloads (npm): 30,749
- License: MIT · Direct dependencies: 3
Want this server set up for your team?
ConnectATD builds AI automation and wires up MCP servers like this one. Tell us what you are trying to do.
Talk to ConnectATDTools and how they are described
Agents choose tools from these descriptions. Under each name you can see how many of its parameters are explained.
query-analytics-dashboard2 of 2 parameters describedFetch Microsoft Clarity analytics data using a simplified natural language search query. The query should be focused on one specific data retrieval or aggregation task. Avoid complex multi-purpose queries. Time ranges should be explicitly specified when possible. If no time range is provided, prompt the user to specify one. Do NOT use this tool for AI bot, crawler, or crawling-activity questions (which bots or AI crawlers accessed the site, crawled paths, content or page types, HTTP status codes, robots.txt violations, or scrape-to-referral) - use the dedicated Bot Activity tools for those instead.
list-session-recordings4 of 4 parameters describedList Microsoft Clarity session recordings based on specified filters. The filters allow you to narrow down the recordings by various criteria such as URLs, device types, browser, OS, country, city, and more. The date filter is required and must be in UTC ISO 8601 format.
get-citation-overview1 of 2 parameters describedGet an AI Visibility citations overview for the Clarity project, including citation counts, share of authority, branded and non-branded citation shares, AI referred traffic, topic availability, and data freshness. Supports date, query type, query, query topic, and cited-page filters.
list-citation-queries3 of 4 parameters describedList the AI queries that cite the Clarity project's verified domain, ranked by citation count. Returns query topic, citation count, share of authority, and branded status. Supports citation filters and pagination.
list-citation-topics3 of 4 parameters describedList AI query topics that cite the Clarity project's verified domain, ranked by citation count. Returns citation count and share of authority. Supports citation filters and pagination.
list-top-cited-pages3 of 4 parameters describedList pages from the Clarity project's verified domain that were cited in AI answers, ranked by citation count. Supports citation filters and pagination.
get-citation-metric-trends2 of 3 parameters describedGet AI Visibility citation trends over time for whole-project metrics: total citations or share of authority. Returns one series of dated values. Does not take selected items.
get-citation-item-trends3 of 4 parameters describedGet AI Visibility citation trends over time for specific queries or cited pages. Requires values containing exact values previously returned by list-citation-queries or list-top-cited-pages for the matching dimension - do not invent values. Returns one dated series per selected item.
get-bot-activity-overview1 of 2 parameters describedGet Bot Activity (also called Crawling Activity or AI crawler activity) summary metrics for the Clarity project. Use this and the other Bot Activity tools - not the analytics dashboard tool - for any question about AI bots, crawlers, crawling activity, or bot traffic. Returns raw counts plus the percentages shown on the dashboard cards: shareOfTotalTrafficPercent (scoped vs all-traffic requests), uniqueHtmlPathsSharePercent (scoped vs all-traffic unique HTML paths), and violationsSharePercent (robots.txt violations vs scoped requests). Also returns selectedCdnProvider and cdnProviders with their connection status and last data timestamps. Does not require a verified AI Visibility domain. Unless overridden, results are scoped to the selected default CDN provider and to the domains covered by both the CDN logs and the Clarity tag.
list-ai-crawlers6 of 7 parameters describedList AI crawlers and their request counts for the Clarity project. Supports Bot Activity filters plus labelColumn and itemColumn grouping.
list-bot-path-requests5 of 6 parameters describedList the paths requested by AI bots for the Clarity project, ranked by request count. Each row includes count and its percent share. Supports Bot Activity filters, pagination, sorting, and optional content-type grouping.
get-bot-activity-distribution2 of 3 parameters describedGet a Bot Activity distribution for one dimension: content type, page type, or HTTP status code. Each entry includes count and its percent share of the distribution total. Supports all Bot Activity filters.
get-bot-activity-metric-trends2 of 3 parameters describedGet Bot Activity trends over time for whole-project metrics: total AI requests, unique site pages crawled, or robots.txt violations. Returns one dated series where value is the filtered metric, totalValue is the comparable unfiltered total, and percent is value as a share of totalValue. Does not take selected items. The bucket size follows the date range, as in the dashboard.
get-bot-activity-item-trends3 of 4 parameters describedGet Bot Activity trends over time for specific crawled paths, HTTP status codes, or content types. Requires values containing exact values previously returned by list-bot-path-requests (its full url field for paths) or get-bot-activity-distribution for the matching dimension - do not invent values. Returns one dated series per selected item.
get-ai-crawler-trends4 of 5 parameters describedGet Bot Activity trends over time for specific AI crawlers. Requires values containing exact label and item values previously returned by list-ai-crawlers, using the same labelColumn and itemColumn - do not invent values. Returns one dated series per selected crawler.
get-scrape-to-referral-ratio1 of 2 parameters describedGet the scrape-to-referral ratio for the Clarity project: how many AI scrapes each operator performed for every visit it referred back. Returns per-provider ratios, referrer breakdowns, the domains covered by CDN logs and by the Clarity tag, and a coverage state explaining any gap. Requires a date filter.
list-connected-cdn-providers1 of 2 parameters describedList the CDN providers connected to the Clarity project, with each provider's connection status and the domain its bot logs cover. Use this to explain missing Bot Activity data before analyzing crawl coverage.
get-topic-insight-constraints1 of 1 parameter describedGet the current validation rules for Topic Insights: the maximum topic name length, the allowed range of questions per topic, the allowed question length, the maximum number of reports a project can generate in a 7-day window, and the per-topic regeneration cooldown in days. Call this before create-topic-insight-report or regenerate-topic-insight-report and state the rules to the user before collecting their input, so their topic and questions satisfy the rules on the first try. Requires a verified AI Visibility domain.
list-topic-insights1 of 1 parameter describedList the Topic Insight (AI Economy simulation) topics for the Clarity project. Returns two groups matching the dashboard: topics (the user's own topics - approved or already generated) and suggestedTopics (auto-generated topic suggestions the user has not adopted yet). Each entry has topicId, topicName, userApproved, questions, and its generated reports (runId, status, citationRate, competitiveShare). Also returns reportsMetadata (canGenerate and the number of reports generated in the current window). Treat suggestedTopics as suggestions, not the user's active topics, unless they ask about suggestions. Requires a verified AI Visibility domain.
get-topic-insight-report3 of 3 parameters describedGet a completed Topic Insight report for one topic (topicId required, runId optional for a specific run; omitted selects the latest completed run). Returns the resolved runId, status, dataReady, simulation metrics (citation rate, competitive share, answer/citation counts), per-domain ranking, content strengths/opportunities, and simulated questions. In-progress runs cannot be read as final reports. If dataReady=false, wait for ingestion and do not interpret metrics. Requires a verified AI Visibility domain.
get-topic-insight-status2 of 2 parameters describedGet the generation status for one or more Topic Insight runs (runIds required). Returns each run's status, progress percentage, and - once completed - its citation rate and competitive share. Poll this after create-topic-insight-report or regenerate-topic-insight-report until the status is Completed, then call get-topic-insight-report.
create-topic-insight-report3 of 3 parameters describedCreate a new Topic Insight topic and start generating its report. Call get-topic-insight-constraints first and state its rules to the user before collecting the topic name and questions. Returns the topicId and the generation runId to poll with get-topic-insight-status. If the project has hit its weekly report limit or the topic's cooldown, the response has generated=false with a reason to relay to the user. To refresh an existing topic use regenerate-topic-insight-report instead. Requires a verified AI Visibility domain.
regenerate-topic-insight-report3 of 3 parameters describedRegenerate the report for an existing Topic Insight topic (topicId and topicName required). Returns the new generation runId to poll with get-topic-insight-status. If the topic is within its 7-day cooldown or the project hit its weekly limit, the response has generated=false with a reason to relay to the user. Requires a verified AI Visibility domain.
delete-topic-insight2 of 2 parameters describedDelete a Topic Insight topic and its reports (topicId required). This is destructive and cannot be undone - confirm with the user before calling. Requires a verified AI Visibility domain.
list-projects1 of 1 parameter describedList the Microsoft Clarity projects the signed-in user can access as an admin or member, with each project's id, name and hostname, and which one is selected. Each API request is restricted by the user's permissions for that project; being listed does not grant every action. The list is reused for a few minutes; pass refresh: true to re-read it, e.g. after the user gains access to a new project. Requires a Clarity sign-in: not available with a Data Export API token, which is tied to a single project.
select-project1 of 1 parameter describedSelect the user's default Microsoft Clarity project: the one the Clarity data tools (such as query-analytics-dashboard and list-session-recordings) query when no projectId is passed. The choice is remembered for this sign-in until another one is selected. Call it when the user chooses a default project or asks to switch their default; to query or compare other projects without changing the default, pass projectId to those tools instead. Take the project id from list-projects. Not used with a Data Export API token, which is tied to one project.
query-documentation-resources1 of 1 parameter describedRetrieve Microsoft Clarity documentation snippets for finding answers to user questions including step-by-step screenshots for setup guides, features, usage, troubleshooting, and integration instructions. The query should be focused on one specific documentation topic or question. Avoid complex multi-purpose queries.
loginno parametersSign in to Microsoft Clarity with the user's Clarity account. Opens the Clarity sign-in and consent page in the browser and returns its URL so it can be shown to the user if the browser does not open. Returns immediately; call login-status right away and repeat while loginPending is true, without asking the user to confirm completion. The server automatically receives the authorization code and exchanges tokens when the browser redirects. Project requests are restricted by the user's admin or member permissions for each project. Recommended instead of using a Data Export API token, especially after HTTP 401 or 403 token failures.
login-statusno parametersShow whether the user is signed in to Microsoft Clarity, accessible projects, the selected project, and the active credentials. While browser sign-in is pending, waits up to 10 seconds for completion or failure. Call immediately after login and repeat while loginPending is true without asking for user confirmation. Report lastLoginError and stop on failure. Project requests are restricted by the user's admin or member permissions for each project, not OAuth scopes.
logoutno parametersSign out of Microsoft Clarity: ends the sign-in on the Clarity service and removes it from this machine. Does not affect a configured Data Export API token.
Tested in a sandbox with an empty environment: no API keys, a throwaway folder, nothing from a real account. A passing test shows the server runs and responds. It is not a security audit.