# Hotjar MCP for AI Agents AI Agent Connect > Hotjar MCP connects your user experience data to your AI agent. It lets you pull heatmaps, session recordings, and survey results into a single chat interface so you can figure out why people are dropping off your pages or what they actually think about your new features without digging through the dashboard. ## Overview - **Category:** customer-support - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_683kR8pOstE12JRN5xU20SgKJIMKCpnDIqpqajf9/ai-agent-connect - **Tags:** heatmaps, session-recordings, user-feedback, conversion-funnels, nps-surveys, ux-research ## Description Connect your Hotjar account to any AI agent and access user experience analytics through natural conversation. This Connector lets you pull survey stats to see if users are actually happy, or grab specific feedback responses to see what is bugging them. It is about getting the 'why' behind the numbers without the manual labor of exporting CSVs or clicking through nested menus. Because Vinkius hosts this Connector, you can plug it into your existing workflow and start asking questions about your site's performance immediately. It turns raw user behavior into data you can actually use in a meeting or a sprint planning session. ## Tools ### get_feedback_widget Get the details and settings for a specific feedback widget. ### get_heatmap Get the specific click and scroll data for a heatmap snapshot. ### get_recording Get the metadata and events for a single session recording. ### get_survey_stats Get survey statistics like NPS scores and completion rates. ### get_survey Get the specific questions and settings for a survey. ### list_feedback_responses List all incoming feedback responses from your users. ### list_feedback List all the feedback widgets active on your site. ### list_funnels List all conversion funnels and their drop-off data. ### list_recordings List all session recordings with duration and page counts. ### list_sites List all the websites tracked in your Hotjar account. ### list_survey_responses List all individual responses from a specific survey. ### list_surveys List all the surveys you have created. ### lookup_user Find the session history and behavior for a specific user ID. ### list_heatmaps List all heatmap snapshots available in your account. ### check_hotjar_status Verify that your connection to the Hotjar API is active. ## Prompt Examples **Prompt:** ``` What's the biggest drop-off point in our signup funnel? ``` **Response:** ``` Based on the current conversion data: | Step | Visitors | Drop-off % | | :--- | :--- | :--- | | Landing Page | 8,400 | 0% | | Pricing Page | 3,200 | 61.9% | | Plan Selection | 1,100 | 65.6% | | Signup Form | 680 | 38.2% | | Completed | 420 | 38.2% | The biggest drop-off occurs between the **Landing Page** and the **Pricing Page** (61.9%). Would you like to see the session recordings for that specific page? ``` **Prompt:** ``` Show me the latest NPS scores and some actual feedback from users. ``` **Response:** ``` Here are the latest survey results: **NPS Score: 42 (Good)** * Promoters: 58% * Passives: 26% * Detractors: 16% **Recent Feedback Submissions:** * ⭐⭐⭐⭐⭐ 'Love the new dashboard redesign!' (Page: /dashboard) * ⭐⭐ 'Checkout is too slow on mobile' (Page: /checkout) * ⭐⭐⭐⭐ 'Would be great to have dark mode' (Page: /settings) * ⭐ 'Can't find the export button' (Page: /reports) ``` **Prompt:** ``` Look up the behavior for user 'usr_9988' and tell me what they did. ``` **Response:** ``` User **usr_9988** has been active for 7 sessions over the last 3 weeks. **Summary of behavior:** * **Device:** Chrome/Desktop (5 sessions), Safari/Mobile (2) * **Total Time:** 48 minutes * **Pages Viewed:** 23 * **Key Friction:** Visited /pricing 4 times but never clicked a CTA. Spent 8 minutes on /features reading the comparison table. * **Feedback:** Submitted 'Pricing is confusing' (2 stars). ``` ## Capabilities ### Pull survey stats Get completion rates and NPS scores instantly. ### View feedback widgets See what users are saying in real-time with screenshots. ### Analyze heatmaps Check click and scroll data for specific pages. ### Review session recordings Watch how users navigate your site and identify friction. ### Track conversion funnels See exactly where people drop off in your signup flow. ### Look up user behavior Get the history of a specific user to see their journey. ## Use Cases ### Finding checkout friction A product manager asks the agent to find drop-offs in the signup funnel. The agent uses list_funnels and list_recordings to pinpoint a broken button. ### Analyzing survey trends A UX researcher wants to know if the new hero section is working. They use get_survey_stats to check the NPS score of the latest survey. ### User troubleshooting A support lead wants to see why a specific user is stuck. They use lookup_user to see the sessions for that ID and identify the page they're hitting. ### Heatmap analysis A growth marketer asks for a summary of click data on the pricing page. The agent uses list_heatmaps and get_heatmap to report on the hottest buttons. ## Benefits - Stop digging through dashboards by using list_heatmaps to see where people click. - Find where people get stuck faster by using list_recordings to watch real user sessions. - Track customer sentiment easily with get_survey_stats to see NPS trends. - Spot conversion leaks using list_funnels to see exactly where users drop off. - Get direct user quotes by using list_feedback_responses to see what they're saying. - Understand specific user journeys by using lookup_user to see their full history. ## How It Works The bottom line is you get direct access to Hotjar's user behavior data through a natural conversation with your AI client. 1. Subscribe to the Hotjar MCP on Vinkius. 2. Add your Hotjar Client Secret from your API settings. 3. Ask your agent to analyze your heatmaps or survey results. ## Frequently Asked Questions **Can I use the Hotjar MCP to see why people are leaving my site?** Yes, it lets you pull session recordings and heatmaps to see exactly where users get stuck or where they stop scrolling. **How does the Hotjar MCP help with survey results?** It lets you pull NPS scores and completion rates so you can see how users feel about your product in real-time. **Can I see specific user feedback with this Connector?** Yes, you can pull individual feedback responses including the user's comments and screenshots to see their exact experience. **Does the Hotjar MCP show conversion funnels?** It lists all your funnels and shows the drop-off data for each step in the process, helping you find where you're losing people. **Can I find specific user history with the Hotjar MCP?** You can use the lookup tool to see the session history and behavior for a specific user ID to understand their individual journey. **Is the Hotjar MCP good for UX research?** It's a great way to quickly analyze heatmaps and survey trends without manually clicking through the Hotjar dashboard for every request. **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.