# Hotjar MCP > Hotjar (Behavior Analytics) MCP Server lets your AI agent analyze user behavior, retrieve survey responses, and manage user feedback. It gives you direct access to site lists, funnels, heatmaps, and session recordings from your Hotjar account. Need to check user sentiment or find where users drop off? Your agent handles it all via natural conversation. ## Overview - **Category:** customer-support - **Price:** Free - **Tags:** behavior-analytics, heatmaps, session-recordings, user-feedback, surveys, conversion-optimization ## Description This Hotjar MCP Server lets your AI agent dig into user behavior and feedback. You'll get direct access to site lists, funnels, heatmaps, and session recordings from your Hotjar account, all through natural conversation. Need to check user sentiment or find where users drop off? Your agent handles it. **Audit Site Health and Compliance** Check the site's overall status and get high-level metadata using `get_site`. You can see every site Hotjar tracks with `list_sites`. To keep things compliant, your agent even handles data deletion requests for GDPR, so you don't gotta worry about that. You can also review all the funnels you've set up with `list_funnels` and check every available heatmap with `list_heatmaps`. **Map User Interaction Points** Review session recordings using `list_recordings` and then get detailed click and movement heatmaps for a specific page with `get_heatmap`. You can pinpoint exactly where users are clicking and how they move across a page. You can also see all the active and inactive surveys you've set up with `list_surveys` and grab a list of individual user responses from active surveys using `list_survey_responses` to get detailed answers, average ratings, and device metadata. **Manage and Collect User Feedback** List incoming user feedback via `list_feedback` to pull specific ratings, comments, and screenshots for product review. You can also view all the user-submitted feedback in bulk using `list_feedback`. **Analyze User Flow and Drop-Off Points** View defined conversion funnels for tracking user journey progression using `list_funnels`. You can check all available heatmaps with `list_heatmaps` to spot where users are dropping off on a specific page. ## Tools ### get_heatmap Retrieves detailed click and movement heatmaps for a specified page. ### get_site Gets high-level metadata and status for the current tracked site. ### get_survey Retrieves detailed information about a specific user survey. ### list_feedback Lists incoming user feedback, including ratings, comments, and screenshots. ### list_funnels Lists defined conversion funnels for tracking user journey progression. ### list_heatmaps Lists all available heatmaps and their associated site IDs. ### list_recordings Retrieves a list of all session recordings available for analysis. ### list_sites Lists every single site that Hotjar is currently tracking and monitoring. ### list_survey_responses Retrieves a list of individual user responses from active surveys. ### list_surveys Lists all active and inactive surveys set up in your Hotjar account. ## Prompt Examples **Prompt:** ``` List all surveys for our main marketing site ``` **Response:** ``` I've found 3 active surveys on your main marketing site: 'Post-Purchase Feedback' (ID: 123), 'Feature Request Poll' (ID: 456), and 'Homepage NPS' (ID: 789). Which one would you like to see responses for? ``` **Prompt:** ``` Show me the last 5 responses for survey ID 123 ``` **Response:** ``` Retrieving survey responses… The last 5 respondents gave an average rating of 4.2/5. Common feedback includes 'Easy to use checkout' and 'Would like more payment options'. Would you like to see the full text for any response? ``` **Prompt:** ``` How many responses has our 'NPS Widget' received so far? ``` **Response:** ``` Your 'NPS Widget' (ID: fb-987) has received a total of 1,245 responses with an average rating of 8.4. I can retrieve the detailed comments and device metadata if you'd like to analyze the trends. ``` ## Capabilities ### Analyze User Flow and Drop-Off Points Use `list_funnels` and `list_heatmaps` to view conversion funnels and identify where users are dropping off on a specific page. ### Extract Specific User Sentiments Run `list_survey_responses` to get detailed answers, average ratings, and device metadata from active user surveys. ### Audit Site Health and Compliance Check site status, list all sites using `list_sites`, and perform data deletion requests to ensure GDPR compliance. ### Map User Interaction Points Use `list_recordings` and `get_heatmap` to review session recordings and see click density heatmaps for specific pages. ### Manage and Collect User Feedback List incoming feedback via `list_feedback` to pull specific ratings, comments, and screenshots for product review. ## Use Cases ### Finding Out Why Users Abandon the Cart A PM notices high drop-off rates. They ask their agent, 'What are the drop-off points on the checkout page?' The agent uses `list_funnels` and `get_heatmap` to pinpoint the exact step and the element causing the issue, giving the PM immediate action items. ### Assessing Product Changes Post-Launch A UX Researcher needs to know if the new signup flow is working. They ask the agent to 'Show me the feedback and survey responses for the signup page.' The agent runs `list_feedback` and `list_survey_responses` to give a summarized view of user sentiment and specific pain points. ### Cleaning Up Old User Data A Data Privacy Officer receives a data deletion request. They tell their agent, 'Delete all data for user X.' The agent executes the necessary compliance tools, proving the deletion occurred and maintaining GDPR records. ### Comparing User Behavior Across Markets A PM managing multi-tenant sites asks the agent, 'List all sites and tell me the tracking status for our European and US markets.' The agent uses `list_sites` to compare site statuses across different organizational units. ## Benefits - Get a full view of all sites and tracking statuses using `list_sites`. You instantly know if a site is active or if the tracking code is broken—no need to check the dashboard manually. - Analyze user sentiment directly. Instead of downloading a massive CSV, your agent uses `list_survey_responses` to summarize key themes and average ratings from surveys. - Pinpoint friction points instantly. `list_feedback` pulls specific ratings, comments, and screenshots, letting you see exactly what users are struggling with without having to manually sort through widget submissions. - Track conversion paths. You can list funnels using `list_funnels` to see which steps are failing, helping you narrow down where users quit the buying process. - Audit your data. Use `list_recordings` to see session recordings and `get_heatmap` to visualize click density, giving you a deep look at user interaction patterns. - Maintain compliance easily. Running a data deletion request (via specific tools) keeps your user data clean and proves GDPR adherence without logging into the compliance portal. ## How It Works The bottom line is, your AI client treats the Hotjar API like a native conversation, letting you bypass the dashboard clicks and CSV exports. 1. Subscribe to the Hotjar MCP Server and input your Hotjar Client ID, Client Secret, and Site ID. 2. Ask your AI agent a question. The agent identifies the needed action (e.g., 'List all surveys'). 3. The agent executes the appropriate tool (e.g., `list_surveys`) and passes the resulting data back to you in plain language. ## Frequently Asked Questions **How do I use the `list_sites` tool with the Hotjar MCP Server?** The `list_sites` tool lists every site Hotjar is tracking. You run it to get a full list of URLs and IDs, which is necessary before you can run specific tools like `get_heatmap` on a particular domain. **What information does `list_survey_responses` provide?** `list_survey_responses` gives you a list of individual responses. You get the answers, timestamps, and device metadata for each response, helping you track how different devices affect user answers. **Can I see all the available surveys using `list_surveys`?** Yes, `list_surveys` lists all surveys set up in your account. This allows you to know which surveys are active and what their IDs are before you try to retrieve responses. **How does `get_heatmap` work?** You run `get_heatmap` to get a visual representation of user activity—where people click and move most often—on a specific page. This is key for spotting visual bottlenecks. **What is the difference between `list_heatmaps` and `get_heatmap`?** `list_heatmaps` shows you a list of all heatmaps you have access to. `get_heatmap` actually fetches the data for a specific heatmap you've already identified. **When should I use `list_recordings` to check user behavior?** Use `list_recordings` when you need an overview of recorded user sessions. It provides a list of session IDs, start dates, and the associated site, letting you quickly identify which recordings cover the areas you need to audit. **How do I handle privacy or data deletion using the Hotjar MCP Server?** You use the designated privacy tools (implied by the data) to perform data deletion requests. The server supports executing 'right-to-erasure' requests, allowing you to securely delete specific user profiles or session data. **What kind of data does `list_feedback` pull for user insights?** `list_feedback` pulls discrete user-submitted feedback. It gives you the actual ratings, written comments, and even screenshots, which helps you pinpoint specific friction points in the user journey. **Can I see individual survey responses through my agent?** Yes. Use the `get_survey_responses` tool with a specific Survey ID to retrieve all recorded answers, timestamps, and device info. This allows your agent to summarize user sentiment and identify common themes automatically. **How do I handle GDPR data deletion requests?** The agent includes a `delete_user_data` tool for GDPR compliance. You can provide a User ID to irreversibly wipe all associated behavioral data from Hotjar, ensuring you meet privacy regulations efficiently. **Can I list all feedback widgets for a specific site?** Absolutely. Use the `list_feedback` tool to enumerate all active feedback widgets on your configured site. Your agent will return widget IDs and response counts, helping you identify which areas of your site are generating the most user input.