How to Use the Hotjar MCP in VS Code Copilot

Q: How do I switch tracked sites in VS Code Copilot?

Use listsites inside VS Code Copilot to fetch the IDs of your tracked domains. You can target different environments by passing the correct site ID to any Hotjar tool in the chat.

Pull Hotjar user feedback and session data directly into VS Code Copilot to diagnose frontend bugs as a team.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Hotjar MCP to VS Code Copilot

Create your Vinkius account to connect Hotjar to VS Code Copilot 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 with VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Debug Hotjar session recordings in VS Code Copilot

The `list_recordings` tool imports user session details directly into your VS Code Copilot chat window to speed up team debugging. By calling `get_recording` inside VS Code Copilot, your team finds the exact code block that caused a Hotjar user to drop off. This direct access lets VS Code Copilot read real Hotjar telemetry instead of forcing developers to manually search for bugs. Engineers get immediate context on Hotjar user errors without leaving their active VS Code Copilot session.

Read Hotjar survey stats inside VS Code Copilot

The `list_surveys` tool brings Hotjar user feedback metrics directly to your VS Code Copilot terminal workspace. To prioritize bug fixes based on actual Hotjar user complaints, your team uses `get_survey_stats` and `list_survey_responses` in VS Code Copilot. This workflow allows VS Code Copilot to analyze Hotjar user sentiment across your entire engineering team. Developers can instantly map Hotjar survey feedback to specific repository files in VS Code Copilot.

Optimize layouts with Hotjar MCP Server in VS Code Copilot

The `list_heatmaps` tool pulls visual Hotjar click density metrics straight into your VS Code Copilot editing session. Once you call `get_heatmap` in VS Code Copilot, your team can rewrite CSS layouts to align with actual Hotjar user interaction patterns. This shared configuration lets every developer on your team access Hotjar metrics inside VS Code Copilot. Teams build interfaces based on actual Hotjar user behavior rather than team opinions inside VS Code Copilot.

Setup guide

Set up Hotjar MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the Hotjar MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the Hotjar tools listed. Try asking: "List my recent Hotjar transactions" and Copilot will invoke them automatically.

.vscode/mcp.json

{
  "mcpServers": {
    "hotjar-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 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 MCP in VS Code Copilot

Create a .vscode/mcp.json file in your repository root and add the Hotjar server configuration. Once committed, every developer on your team can access the analytical tools via VS Code Copilot.

Yes, because the configuration is committed to your repository, all team members can run `list_surveys` and `get_survey_stats` inside VS Code Copilot. This ensures everyone looks at the same user feedback.

No, the server connects directly to the Hotjar API via Vinkius, meaning VS Code Copilot does not need any local tracking scripts or SDKs to fetch session recordings.

Use `list_sites` inside VS Code Copilot to fetch the IDs of your tracked domains. You can target different environments by passing the correct site ID to any Hotjar tool in the chat.

The VS Code Copilot client accesses Hotjar recordings and feedback responses through an encrypted HTTPS connection. Vinkius hosts the server in an isolated sandbox, ensuring your team-wide API credentials and customer data remain secure.

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