How to Use the Hotjar (Behavior Analytics) MCP in Mastra AI

Q: How do I set up the Hotjar MCP server with Mastra AI?

Install the @mastra/mcp package, then create a new MCPClient and pass your Vinkius server URL. Mastra handles the tool discovery automatically, so you can start using tools like listsites in your agents right away.

Build resilient Hotjar data workflows with Mastra AI. Automate user behavior analysis and trigger actions based on real insights.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Hotjar (Behavior Analytics) MCP to Mastra AI

Create your Vinkius account to connect Hotjar (Behavior Analytics) 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 Hotjar (Behavior Analytics) with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Funnel Drop-off Alerts

Build a monitoring workflow that actually works. Your Mastra AI agent can periodically run `list_funnels` to check conversion rates. If it sees a sudden drop, it can automatically trigger a multi-step response. Here's the thing: Mastra's engine handles the complex logic. IF `list_funnels` shows a >10% drop on checkout, THEN get relevant `list_recordings` from the last hour AND create a high-priority ticket in Jira with links. It just runs, no babysitting required.

Reliable Survey Data Processing

Stop losing feedback to flaky API calls. You can build a Mastra AI workflow that pulls survey data without fail. The agent calls `list_surveys` to find the correct survey, then uses `list_survey_responses` to pull all the answers. If the Hotjar API is slow or returns an error, Mastra's built-in exponential backoff and automatic retries kick in. Your workflow won't crash because of a temporary network issue. This ensures you capture every piece of user feedback, every time.

Conditional Analysis with this MCP Server

This is where Mastra's conditional branching really pays off. You can design an agent that starts by checking the `get_site` status. If the site is active, it proceeds to `get_heatmap` for a critical page, but if not, it logs an error and waits. Build more intelligent workflows. For instance, an agent could fetch data using `list_feedback`, run a sentiment check, and branch its logic. If it finds negative comments, it then automatically calls `list_recordings` to find the session recordings for those specific users, giving developers instant context for a bug report.

Setup guide

Set up Hotjar (Behavior Analytics) 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 Hotjar (Behavior Analytics) 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: "hotjar-behavior-analytics-mcp-client",
  servers: {
    "hotjar-behavior-analytics-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Hotjar (Behavior Analytics) 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 Hotjar. 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 Hotjar (Behavior Analytics) 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 Hotjar (Behavior Analytics) MCP in Mastra AI

Add the MCP server to your Mastra client with your URL. Your agent can then call tools like `list_funnels` as steps in a workflow, using the returned data to make decisions and trigger other actions, like sending alerts.

Mastra AI has automatic retries with exponential backoff built in. If a call to `get_heatmap` fails, Mastra will try again, making your data collection workflows much more resilient to temporary network problems.

Yes, it's designed for that. You can build conditional logic into your workflow. For example, IF `list_feedback` contains the word "broken," THEN the agent can decide to call `list_recordings` to find sessions from that user.

Install the `@mastra/mcp` package, then create a new `MCPClient` and pass your Vinkius server URL. Mastra handles the tool discovery automatically, so you can start using tools like `list_sites` in your agents right away.

Your workflow only accesses the specific data it's instructed to, like survey content from `list_survey_responses`. The connection is secured by your unique Vinkius token, and the server runs in an ephemeral sandbox, meaning no data is stored after your workflow completes.

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