# Hotjar tools in Cogny Cogny's Hotjar integration exposes 5 tools (5 read) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app. - **Read** (5): only reads data. - **Write** (0): creates or changes something. - **Destructive** (0): deletes, removes or replaces something. Over MCP your own AI client asks before it runs a write. To take a tool away from your agent, block it in Settings → Integrations. ## Notes Hotjar connects with an API key, which is a Client ID and a Client Secret. Only an Admin of the Hotjar organization can create one, under Settings → API, where you pick the organization and the scope. Cogny also needs the Site ID of each site to read (Hotjar → Sites & Organizations); separate several with commas, and the first is the default. Hotjar's API is available on Scale plans only: survey responses need **Ask Scale**. On other plans every call answers 403. Hotjar API keys expire one year after they're created and can't be extended. When a key expires, Cogny marks the connection as needing a reconnect; generate a new key in Hotjar and paste it in. Responses come back newest first, at most 100 per call, paged with a cursor. `summarize_survey_responses` reads up to 2,000 of the newest responses and works out NPS (promoters 9–10, detractors 0–6), rating averages and distributions, counts per choice, Hotjar's sentiment and tag counts, devices, countries and the pages responses came from. Sentiment is only present when your Hotjar plan includes it. Hotjar allows 3,000 API requests per minute. ## Known gaps - Read-only. Hotjar's API has no way to create, edit, turn on or pause a survey, or to tag a response. - No heatmaps, session recordings, funnels, trends, events or feedback widgets: Hotjar's API doesn't offer them. A response links to its recording when there is one, but the recording itself can't be read. - Sites can't be listed through the API; they come from the Site ID field on the connection. - Responses can't be filtered by date, page or answer in the API. To look at one period, page until `created_time` is older than you need. - Multiple-choice answers are counted as the text Hotjar returns for the whole answer; picks within one answer aren't split. - Hotjar's User Lookup (GDPR data reports and deletion) is not offered: it emails visitors or deletes their data, which isn't something a marketing agent should do. ## All tools | Tool | Kind | What it does | |---|---|---| | `list_sites` | Read | Lists the Hotjar sites this connection reads and checks that each one answers. | | `list_surveys` | Read | Lists the surveys on a Hotjar site, with their type and whether they are live. | | `get_survey` | Read | Shows one Hotjar survey with all its questions, answer choices and rating labels. | | `list_survey_responses` | Read | Lists the answers people gave to a Hotjar survey, newest first. | | `summarize_survey_responses` | Read | Summarizes a Hotjar survey's results: NPS, rating averages, choice counts, sentiment and sample answers. | Exact input schemas come from `tools/list` once Hotjar is connected; the free plan is enough to check. Missing something? Your agent can ask for it with `request_feature`. --- All integrations: https://cogny.com/integrations/tools/index.md Plans, approvals, limits and data protection: https://cogny.com/buying-guide.md What Cogny is: https://cogny.com/llms.txt