How to Use the Microsoft Clarity MCP in Mastra AI

Q: Can Mastra AI automate Microsoft Clarity reports?

Absolutely. You can build a workflow that calls getdashboard daily and pushes the results to your team Slack. The Mastra AI framework handles the timing and data formatting for you.

Q: Is it possible to use Microsoft Clarity data for conditional branching?

You can use the results from listrageclicks as a trigger. If the number of clicks exceeds a threshold, Mastra AI branches to a workflow that creates a ticket for your design team.

Q: How do I verify the server is active?

Call checkclaritystatus within your workflow definition. It confirms the connection before your agent starts executing expensive tasks.

Build automated UX audit workflows with Mastra AI and the Microsoft Clarity MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Microsoft Clarity MCP to Mastra AI

Create your Vinkius account to connect Microsoft Clarity to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Microsoft Clarity with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated UX audit workflows

Chain together diagnostic tools to create complex audit agents. Use `list_projects` to identify the correct scope, then trigger `list_rage_clicks` to find problematic areas that need immediate developer attention. If the agent detects high frustration, it can automatically trigger a secondary workflow to pull recordings. This setup ensures that your team only reviews sessions that actually contain genuine user friction.

Conditional behavioral monitoring

Set up agents that react to specific user patterns found via `list_dead_clicks`. If the agent finds that a checkout button isn't registering clicks, it can branch to a notification workflow to alert your engineering lead. This workflow engine handles retries automatically if the API connection drops. You define the logic, and the agent keeps running the diagnostics until it gets the data needed to justify a UI change.

Production-ready data pipelines

Deploy your analytics agents to any cloud provider with one command. By using `get_live_insights`, your agents maintain a constant pulse on site health and report back only when anomalies occur. Because Mastra supports human-in-the-loop approval, you can inspect the output of `get_scroll_depth` before the agent makes a final decision. It keeps you in control while the agent does the heavy lifting.

Setup guide

Set up Microsoft Clarity MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Microsoft Clarity tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "microsoft-clarity-mcp-client",
  servers: {
    "microsoft-clarity-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Microsoft Clarity Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Microsoft Clarity tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Microsoft Clarity transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Microsoft Clarity. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Microsoft Clarity now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Microsoft Clarity MCP in Mastra AI

Absolutely. You can build a workflow that calls `get_dashboard` daily and pushes the results to your team Slack. The Mastra AI framework handles the timing and data formatting for you.

Mastra AI includes built-in exponential backoff. If a call to `get_recording` fails, the agent will wait and try again automatically until it succeeds or hits your defined limit.

You can use the results from `list_rage_clicks` as a trigger. If the number of clicks exceeds a threshold, Mastra AI branches to a workflow that creates a ticket for your design team.

Call `check_clarity_status` within your workflow definition. It confirms the connection before your agent starts executing expensive tasks.

The connection uses an ephemeral token managed by Vinkius. Your session data like click coordinates and scroll events are never stored on our servers; they travel directly from the source to your agent.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript