How to Use the Microsoft Clarity MCP in CrewAI

Q: Can CrewAI agents collaborate on Microsoft Clarity data?

Yes, agents share memory, allowing one to fetch data using listrageclicks and another to analyze the impact. They coordinate their efforts to produce a single, actionable report for your team.

Q: Which tools are best for a CrewAI monitoring crew?

We recommend pairing listtoppages and getliveinsights. These give your agents a high-level view of site performance, allowing them to spot issues before they become major problems.

Deploy a specialized crew of autonomous agents to analyze user behavior using Microsoft Clarity and CrewAI.

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 CrewAI

Create your Vinkius account to connect Microsoft Clarity to CrewAI 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 CrewAI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous UX monitoring crews

Assign a Researcher agent to monitor `list_top_pages` while an Analyst agent reviews `get_heatmap` data. This division of labor allows your team to cover more ground than a single agent ever could. The agents share a memory space, so the Researcher can pass its findings directly to the Analyst. This keeps the workflow focused on identifying real conversion blockers rather than just gathering raw numbers.

Role-based behavioral analysis

Configure your crew to act based on specific roles. A Moderator agent can filter the output of `list_dead_clicks` to ignore noise, while an Action agent prepares a summary for your backlog. This hierarchical execution prevents the agents from getting stuck in loops. Each member of the crew understands its unique responsibility and uses the specific tools required to reach a conclusion.

Escalation and response teams

Create a loop where agents escalate critical findings to you. If the crew identifies a sudden drop in engagement via `get_scroll_depth`, it can flag the issue for human review immediately. You remain the ultimate decision maker. By defining the scope of the MCP Server tools each agent can use, you ensure the crew stays within its operational boundaries while managing your analytics.

Setup guide

Set up Microsoft Clarity MCP in CrewAI

Prerequisites

Python 3.10+ installed
crewai package (pip install crewai)
Active Vinkius subscription with a valid endpoint token

1

Install CrewAI
Run pip install crewai to install the framework. MCP support is built-in via the mcps parameter.
2

Add the MCP URL to your agent
Pass your Vinkius endpoint directly to the mcps list. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. CrewAI handles tool discovery and caching automatically.
3

Kick off your crew
Create a Crew with your agent and tasks. Call crew.kickoff() — the agent will automatically invoke Microsoft Clarity tools as needed.

crew.py

from crewai import Agent, Task, Crew

agent = Agent(
    role="Microsoft Clarity Analyst",
    goal="Access and analyze Microsoft Clarity data via MCP.",
    backstory="Expert analyst with direct Microsoft Clarity access.",
    mcps=[
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ],
)

task = Task(
    description="List recent Microsoft Clarity transactions",
    agent=agent,
    expected_output="A summary of recent activity",
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
print(result)

Get your connection token →

Prerequisites

Python 3.10+ installed
crewai + crewai-tools packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install crewai crewai-tools. The MCPServerAdapter handles lifecycle management and tool conversion.
2

Connect with MCPServerAdapter
Use MCPServerAdapter as a context manager with SseServerParameters pointing to your Vinkius endpoint. The adapter automatically manages connection lifecycle.
3

Assign tools and run
Pass the returned mcp_tools to your agent's tools parameter. The adapter converts MCP tools to native BaseTool objects compatible with all CrewAI agents.

crew.py

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
from mcp import SseServerParameters

server_params = SseServerParameters(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

with MCPServerAdapter(server_params) as mcp_tools:
    agent = Agent(
        role="Microsoft Clarity Analyst",
        goal="Access and analyze Microsoft Clarity data via MCP.",
        backstory="Expert analyst with direct Microsoft Clarity access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent Microsoft Clarity transactions",
        agent=agent,
        expected_output="A summary of recent activity",
    )

    crew = Crew(agents=[agent], tasks=[task])
    result = crew.kickoff()
    print(result)

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 CrewAI

You simply pass the server URL to the agent's MCP configuration. Once connected, your CrewAI agents can access all 13 tools, including `list_recordings` and `get_dashboard`, to perform their assigned tasks.

Yes, agents share memory, allowing one to fetch data using `list_rage_clicks` and another to analyze the impact. They coordinate their efforts to produce a single, actionable report for your team.

We recommend pairing `list_top_pages` and `get_live_insights`. These give your agents a high-level view of site performance, allowing them to spot issues before they become major problems.

Not at all. You define the goals, and the crew works autonomously. You only step in when the agents trigger an escalation based on the criteria you set.

All behavioral data, such as mouse movements and click logs, remains encrypted during transit. The MCP Server acts as a secure bridge, and Vinkius ensures your endpoint token remains private and isolated.

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