# Hotjar MCP > Hotjar MCP Server gives your AI agent full access to user experience analytics. You get heatmaps, session recordings, and detailed feedback surveys, letting you see exactly where visitors get stuck or why they leave your site. Run full conversion funnel analyses and look up specific user behavior by ID, all through natural conversation. ## Overview - **Category:** customer-support - **Price:** Free - **Tags:** heatmaps, session-recordings, user-feedback, conversion-funnels, nps-surveys, ux-research ## Description Connect your Hotjar account to your AI agent and start seeing why people bail on your site. You don't gotta guess anymore. Your agent lets you pull user experience analytics just by talking to it. **Diagnose Visual Friction Points:** You can list all available heatmaps, then get detailed click, scroll, and move data for any page you point it to. This shows exactly where users are clicking, where they're scrolling, and where their attention is going. **Analyze User Flow Drop-off:** You can list all defined conversion funnels, and then get step-by-step data showing where visitors drop out of a conversion path. This lets you pinpoint exactly which step is killing your conversion rate. **Review Specific User Behavior:** Give your AI client a specific user ID, and it pulls up that user's entire session history and behavior data. You get the full picture of what they did on your site. **Watch Past User Sessions:** You can list all recorded user sessions available for review, and then get details and metadata for any single recording. This lets you observe how users actually interact with your site. **Manage Survey Data:** You can list all your Hotjar surveys and then get quantitative statistics for any specific survey, like NPS scores, completion rates, and response trends. You can also list all individual survey responses and get the full details and settings for a specific survey. **Deep Dive into User Feedback:** You can list all available feedback widgets and then list all incoming user feedback submissions. You can also get specific details about a feedback widget, and review all individual responses submitted to a survey, which often include screenshots. **Site and Account Management:** You can list every site tracked in your Hotjar account, and you can also check the connection status to your Hotjar account. ## Tools ### check_hotjar_status Verifies the connection status to the Hotjar account. ### get_feedback_widget Retrieves specific details about a feedback widget. ### get_heatmap Gets detailed click, scroll, and move data for a specified page heatmap. ### get_recording Retrieves details and metadata for a specific user session recording. ### get_survey Gets the full details and settings for a specific survey. ### get_survey_stats Retrieves quantitative statistics for a given survey, like NPS scores. ### list_feedback Lists all available feedback widgets configured on the site. ### list_feedback_responses Lists all incoming user feedback submissions. ### list_funnels Lists all defined conversion funnels and their steps. ### list_heatmaps Lists all available heatmap snapshots for different pages. ### list_recordings Lists all recorded user sessions available for review. ### list_sites Lists every site tracked within your Hotjar account. ### list_survey_responses Lists all individual responses submitted to a survey. ### list_surveys Lists all the surveys you have set up in Hotjar. ### lookup_user Retrieves all session history and behavior 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 ### Analyze User Flow Drop-off List funnels and get step-by-step data showing where visitors drop out of a conversion path. ### Diagnose Visual Friction Points List and get heatmaps to see where users click, scroll, and move attention on specific pages. ### Review Specific User Behavior Look up a user by ID to get their entire session history and behavior data. ### Deep Dive into User Feedback List feedback widgets and list responses to review user-submitted comments and screenshots. ### Watch Past User Sessions List recordings and get individual recordings to observe how users interact with your site. ### Manage Survey Data List surveys and get survey statistics to analyze NPS scores, completion rates, and response trends. ## Use Cases ### Checkout Funnel Failure The conversion rate dropped 15% last month. The Product Manager asks the agent to run `list_funnels` and `list_heatmaps`. The agent identifies that the drop-off happens between the 'plan selection' and 'signup form' steps, and the heatmap shows users are repeatedly scrolling past the CTA button. ### Investigating High Support Tickets A support agent needs to understand why users can't use the export feature. They ask the agent to `lookup_user` for a sample user ID. The agent returns the user's session history, revealing they visited the report page multiple times but never interacted with the export button. ### Understanding Low NPS Scores The team sees an NPS score that is too low. The Growth Manager asks the agent to `list_feedback_responses`. The agent pulls the top submissions, revealing recurring complaints about mobile speed and confusing navigation. ### Feature Adoption Mystery The team suspects a new feature isn't being used. They run `list_surveys` to check the completion rate and then use `get_survey` to check the specific questions, confirming if the feature was even visible to the user. ## Benefits - See precise drop-off points. Use `list_funnels` to map conversion paths step-by-step. Pinpoint exactly which step causes users to abandon the process. - Visualize user attention with `get_heatmap`. See where users actually click, scroll, and move their mouse on any page, finding visual pain points instantly. - Watch the problem live. `list_recordings` and `get_recording` let you play back actual user sessions. You see the friction firsthand, not just the metric. - Know the 'why.' Use `list_feedback_responses` and `list_feedback` to gather direct user quotes and screenshots of what they hate. - Quantify satisfaction. Running `get_survey_stats` gives you NPS scores and completion rates, backed by the full data set from `list_surveys`. - Track specific users. The `lookup_user` tool lets you pull a complete behavioral report for a single user ID, perfect for bug reproduction. ## How It Works The bottom line is, your AI client turns raw user data into actionable insights without you having to click through 15 separate dashboards. 1. Subscribe to the Hotjar MCP Server and provide your Hotjar Client Secret. 2. Your AI agent uses the tools to request specific data (e.g., 'list_funnels' for drop-off data, or 'get_heatmap' for clicks). 3. The server returns the structured data, which your AI client synthesizes into a plain-language report detailing user behavior. ## Frequently Asked Questions **How do I use the list_funnels tool to find a drop-off point?** You use the agent to call `list_funnels`. This tool lists all conversion funnels on your site. The agent then gives you step-by-step drop-off data, showing the exact drop-off percentage and the transition between steps. **What does the get_heatmap tool actually show?** The `get_heatmap` tool gives you click, scroll, and move data for a specific page. It shows a visual representation of where users focus their attention and how far down the page they scroll. **Can I check the NPS score using get_survey_stats?** Yes, the `get_survey_stats` tool pulls the quantitative data for any survey. It provides the NPS score, the percentage breakdown of Promoters, Passives, and Detractors, and the overall completion rate. **How do I get detailed user behavior data for a single person?** Use the `lookup_user` tool. You provide the user ID, and the agent retrieves the user's complete session history, total time on site, and pages viewed over time. **Is list_feedback_responses the right tool for qualitative data?** Yes. `list_feedback_responses` pulls individual user submissions. You get the text, the rating, and crucially, the attached screenshots, giving you the raw qualitative evidence. **How do I use list_sites to find out which pages are being tracked?** The list_sites tool provides a complete inventory of every domain or subsite currently configured in your Hotjar account. It's useful for verifying tracking coverage or checking if a new page needs to be added before analysis. **What is the difference between list_heatmaps and get_heatmap?** list_heatmaps shows a list of all available heatmap snapshots you've generated. The get_heatmap tool retrieves the detailed data for one specific snapshot, allowing you to inspect click, scroll, and move metrics. **When should I use list_survey_responses instead of list_feedback_responses?** Use list_survey_responses for structured, quantitative data from formal surveys. Use list_feedback_responses when you're looking at raw, qualitative user comments from the general feedback widget. **Can I view survey responses and NPS scores?** Yes. Use `list_surveys` to see all surveys with response counts and status. Use `get_survey_stats` for aggregate metrics including completion rate, NPS score, and response trends. Use `list_survey_responses` to read individual user responses. Use `get_survey` for the full question list and settings. **Can I analyze heatmap data for specific pages?** Yes. Use `list_heatmaps` to browse all heatmap snapshots, then `get_heatmap` with a specific Heatmap ID to retrieve click, scroll, and move interaction data along with the page URL. This reveals where users focus attention and which elements they interact with most. **Can I track conversion funnel drop-offs?** Yes. The `list_funnels` tool retrieves all configured conversion funnels with step-by-step drop-off data. Each funnel shows the number of users entering each step and the percentage that continue to the next, helping you identify exactly where users abandon the flow.