# Hotjar MCP > Hotjar connects user experience analytics directly into your agent. It lets you analyze heatmaps, session recordings, and survey data through natural conversation. Instead of clicking through dashboards to find drop-off points or confusing feedback, simply ask your AI client about specific users, funnels, or site interactions to get immediate, actionable insights. ## Overview - **Category:** customer-support - **Price:** Free - **Tags:** heatmaps, session-recordings, user-feedback, conversion-funnels, nps-surveys, ux-research ## Description Hotjar brings user behavior analytics into the chat window. You can stop manually compiling reports from different tabs just to understand why people leave your site. This MCP lets your agent talk directly to your Hotjar data, giving you deep insights without ever seeing a dashboard. Need to know what users are clicking on a specific page? Ask for the heatmaps. Want to see exactly where they got stuck? You can review conversion funnels and identify those drop-off points instantly. If you're investigating a bad user journey, your agent can even find session recordings or pull up all feedback submissions—complete with screenshots. By connecting Hotjar through Vinkius, you treat your site data like any other source of information: something you just ask questions about. You get answers on NPS scores, survey trends, and specific user activity for a given ID. It's simple conversation that delivers complex product insights. ## Tools ### check_hotjar_status Verifies that the connection to your Hotjar account is working properly. ### get_feedback_widget Retrieves specific details about a feedback widget you've set up on your site. ### get_heatmap Pulls the click and scroll data for a particular page to visualize user attention. ### get_recording Gets specific metadata about an individual recorded session. ### get_survey_stats Retrieves aggregated statistics for a survey, including NPS scores and completion rates. ### get_survey Fetches the full details and settings of any specific survey you've created. ### list_feedback_responses Lists all individual user feedback submissions, including screenshots and ratings. ### list_feedback Shows a list of all the feedback widgets configured on your tracked sites. ### list_funnels Lists every conversion funnel you've set up, showing overall drop-off data for each step. ### list_heatmaps Provides a list of all the heatmap snapshots available across your tracked pages. ### list_recordings Lists all recorded user sessions, including their duration and page count. ### list_sites Retrieves a list of every single website that Hotjar is tracking for you. ### list_survey_responses Lists all individual responses submitted to your surveys, allowing review of answers and dates. ### list_surveys Retrieves a list of every survey you've created in the Hotjar account. ### lookup_user Looks up all recorded behavior, session history, and data for a specific user ID. ## Prompt Examples **Prompt:** ``` Show the NPS survey results and the top feedback submissions this month. ``` **Response:** ``` NPS Survey 'Product Satisfaction Q2' (survey_401): NPS Score: 42 (Good). Promoters: 58%, Passives: 26%, Detractors: 16%. Completion rate: 34.2% (342 responses / 1,000 views). Response trend: +8% vs last month. Top feedback submissions: 1) ⭐⭐⭐⭐⭐ 'Love the new dashboard redesign!' — /dashboard page. 2) ⭐⭐ 'Checkout is too slow on mobile' — /checkout (screenshot attached). 3) ⭐⭐⭐⭐ 'Would be great to have dark mode' — /settings. 4) ⭐ 'Can't find the export button' — /reports. Would you like to see the heatmap for the checkout page or the full survey responses? ``` **Prompt:** ``` Show the heatmap data for our pricing page and the conversion funnel from landing to signup. ``` **Response:** ``` Pricing page heatmap (heatmap_089): Click data: 'Pro Plan CTA' button — 342 clicks (hottest). 'Compare Plans' toggle — 189 clicks. 'Enterprise Contact' link — 67 clicks. FAQ accordion — 45 clicks. Scroll data: 78% of users scroll past the hero section. Only 34% reach the FAQ section at bottom. Conversion funnel 'Landing → Signup': Step 1: Landing page — 8,400 visitors (100%). Step 2: Pricing page — 3,200 (38.1%, -61.9% drop). Step 3: Plan selection — 1,100 (34.4%, -65.6% drop). Step 4: Signup form — 680 (61.8%, -38.2% drop). Step 5: Completed signup — 420 (61.8% of form, 5% overall). Biggest drop-off: Landing → Pricing (61.9%). Would you like to see session recordings from the pricing page? ``` **Prompt:** ``` Look up user behavior for user ID 'usr_12345' and show their session recordings. ``` **Response:** ``` User 'usr_12345': 7 sessions over 3 weeks. Device: Chrome/Desktop (5 sessions), Safari/Mobile (2). Total time on site: 48 minutes. Pages viewed: 23. Key behaviors: Visited /pricing 4 times but never clicked a CTA. Spent 8 minutes on /features reading comparison table. Submitted feedback: 'Pricing is confusing' (2 stars). Session recordings: 1) rec_7701 (Apr 20, 12 min, 6 pages — desktop). 2) rec_7689 (Apr 15, 8 min, 4 pages). 3) rec_7645 (Apr 10, 5 min, 3 pages — mobile). This user shows high interest but pricing friction. Would you like to watch a specific recording? ``` ## Capabilities ### Identify user drop-off points Examines conversion funnels to pinpoint exactly where visitors are leaving your site. ### Analyze click and scroll patterns Generates heatmap data, showing which parts of a page users pay attention to most. ### Review individual user sessions Retrieves session recordings and detailed behavior history for specific user IDs. ### Summarize feedback trends Gathers all incoming survey responses, rating breakdowns, and written comments into digestible reports. ### Check site performance metadata Lists all tracked sites within your Hotjar account to manage scope and context. ## Use Cases ### Investigating a sudden drop in signups A growth team noticed conversion rates dropped 15% yesterday. They ask the agent to check `list_funnels` and immediately see that the biggest step-down is between 'Pricing Page' and 'Plan Selection'. The agent also pulls up recent feedback from `list_feedback_responses`, showing several users complaining about mandatory signups. ### Profiling a high-value, confused user A PM identifies an important user ID. They use the agent to perform a `lookup_user` for that ID. The resulting report shows the user spent 10 minutes on the features page but never clicked the main CTA. This points directly to a friction point needing redesign. ### Comparing two different site layouts A UX Researcher wants to compare old and new product pages. They use `list_heatmaps` to pull data for both versions, allowing the agent to summarize which version generates more clicks in key areas. ### Summarizing market sentiment post-launch A Product Manager asks about recent user sentiment after a major feature release. The agent reviews all `list_surveys` responses and summarizes the top three positive trends, alongside the most common negative critique. ## Benefits - Stop digging through raw data. Instead of manually reviewing `list_funnels` to find the biggest drop-off point, your agent instantly tells you where 60% of users are bailing out. - Get deep user context immediately. With `lookup_user`, you can feed your AI client a specific ID and get a full summary of that person's journey across all pages. - Review qualitative feedback without logging in. You can ask the agent to summarize or list responses using `list_feedback_responses` right from the chat, complete with screenshots. - Understand visual attention instantly. Instead of guessing where users are looking on a page, use `get_heatmap` to see precise click and scroll data for any element. - Keep track of your setup easily. Use `list_sites` to confirm which URLs Hotjar is actively tracking before running an analysis. ## How It Works The bottom line is that you get expert-level site analytics without having to click through any dashboard yourself. 1. Subscribe to this MCP and enter your unique Hotjar Client Secret via the API settings. 2. Your AI client connects, authenticating access to all your user behavior data streams. 3. You ask a question like, 'What's wrong with the checkout funnel?' and get an immediate, summarized answer backed by raw data. ## Frequently Asked Questions **How do I find out which pages are tracked with Hotjar MCP?** You can list all the sites by calling `list_sites`. This tells you exactly which URLs your account is monitoring right now, so you know where to focus your analysis. **What does the Hotjar MCP do with user IDs?** It performs a comprehensive lookup of a specific user's activity. Using `lookup_user` gives you their entire session history, pages visited, and total time on site in one place. **Can Hotjar MCP help me analyze NPS scores?** Yes, the agent accesses your survey data using `get_survey_stats`. It provides the full NPS score breakdown (Promoters/Detractors) and tracks trends over time for you. **Is Hotjar MCP better than just looking at analytics reports?** It’s different. While standard reports show numbers, this MCP interprets those numbers by combining heatmaps (`get_heatmap`), funnels, and feedback into a single narrative answer for you. **What if I want to see the full text of survey responses?** You can list all individual submissions using `list_survey_responses`. This allows you to review not just the aggregated stats, but the raw text and context from every user.