# Hotjar Behavior Analytics MCP > Hotjar Behavior Analytics connects your user feedback, heatmaps, and session recordings directly to your agent. Pull site details, analyze individual survey responses, or pull comments from feedback widgets using natural conversation. ## Overview - **Category:** customer-support - **Price:** Free - **Tags:** behavior-analytics, heatmaps, session-recordings, user-feedback, surveys, conversion-optimization ## Description You can talk directly to your site's behavior analytics data through this MCP. Instead of logging into Hotjar and navigating five different dashboards, you just ask your AI client a question. It pulls everything together—site details, user survey answers, and recorded session notes—and gives you an immediate summary. Need to know if the 'Checkout Funnel' is broken? Just ask. Want to check GDPR compliance for specific users? The MCP handles it. Vinkius hosts this connection so your agent can talk to all your behavior data sources without needing complex API calls or multiple subscriptions. You get full visibility into user journeys and friction points by simply asking the right questions. ## Tools ### list_sites Retrieves a list of all tracked sites configured within your Hotjar account. ### list_funnels Lists and shows details for conversion funnels you have set up on your site. ### get_site Pulls specific, high-level operational details about a single registered website. ### list_heatmaps Generates a list of all available heatmaps for your site to review user interaction patterns. ### get_heatmap Retrieves detailed data and insights from one specific heatmap report. ### list_surveys Generates a comprehensive list of all active surveys you've deployed across your domain. ### get_survey Fetches the full details and setup information for any specific survey ID. ### list_survey_responses Pulls a list of individual user responses from active surveys, including answers and metadata. ### list_feedback Gathers an enumerated list of all incoming feedback submitted via widgets. ### list_recordings Lists available session recordings, allowing you to identify user flows for review. ## 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 ### Review User Feedback Pull detailed ratings, comments, and screenshots from the incoming feedback widgets. ### Analyze Survey Data Retrieve individual survey responses, including answers, timestamps, and device information to gauge user sentiment. ### Map Site Structure List all registered sites, conversion funnels, and overall site health details. ### Review User Sessions Get detailed information on session recordings, allowing you to audit user behavior flow. ### Manage Compliance Data Look up specific user profiles and execute data deletion requests for GDPR compliance. ## Use Cases ### Diagnosing a Checkout Drop-off Point A PM notices the cart abandonment rate spiked. They ask their agent: 'Check my conversion funnels and look at recent session recordings.' The agent uses 'list_funnels' and reviews 'list_recordings', identifying that users are repeatedly clicking on an outdated payment option link. ### Auditing User Data Compliance A Data Privacy Officer needs to comply with a legal request. They instruct their agent: 'Find all user data for account X and execute the right-to-erasure.' The MCP handles the lookup and deletion, fulfilling GDPR requirements instantly. ### Understanding Post-Purchase Pain Points A UX Researcher needs to know why users are unhappy after buying. They ask: 'What were the common complaints from post-purchase surveys?' The agent uses 'list_survey_responses', summarizing sentiment and flagging key issues. ### Auditing Multiple Site Deployments A Marketing Director manages three separate brand sites. They ask: 'Give me a list of all registered sites.' The MCP executes 'list_sites', providing tracking status across the entire organization at once. ## Benefits - Analyze specific feedback widgets by calling 'list_feedback', pulling concrete ratings, comments, and screenshots instantly—no manual scraping required. - Deep dive into user sentiment using 'list_survey_responses'. You can get the average rating and common themes from hundreds of submissions with one prompt. - Stay compliant easily. Use the dedicated compliance tools to look up specific user profiles or execute data deletion requests for GDPR purposes. - Map out your site architecture by calling 'list_sites' and 'list_funnels', giving you a clear, real-time view of what's tracked and where users are dropping off. - Review actual behavior with 'get_heatmap' and 'list_recordings'. You get to see exactly *how* users interacted—not just where they clicked. ## How It Works The bottom line is that you control all of your user behavior and feedback analysis through conversation, bypassing manual dashboards entirely. 1. Subscribe to this MCP and provide your Hotjar Client ID, Client Secret, and Site ID. 2. Connect your preferred AI client (Claude, Cursor, etc.) to the Vinkius catalog using these credentials. 3. Ask your agent a natural language question—like 'What were the top complaints from last week'—and get an immediate data summary. ## Frequently Asked Questions **How do I check if my site is properly tracked using the Hotjar Behavior Analytics MCP?** You can use the 'list_sites' tool. This command pulls a list of all sites and confirms their current tracking status directly from your agent. **Can I analyze survey results for multiple groups at once with Hotjar Behavior Analytics MCP?** Yes, you can pull data using 'list_survey_responses'. You simply ask the agent to compare responses across different funnels or time periods. **How does the GDPR compliance work with this MCP?** The MCP provides tools that let your agent look up specific user profiles and execute right-to-erasure requests, helping you maintain legal compliance. **What is the difference between 'list_feedback' and 'list_survey_responses'?** Feedback widgets are for spontaneous comments and ratings (use 'list_feedback'). Surveys are structured polls with specific questions and answers, which you pull using 'list_survey_responses'. **Do I need to manually export data from the MCP?** No. The purpose of this connection is conversational analysis. Your agent retrieves the data and summarizes it for you directly in the chat window.