happ_analytics
Статистика компании из раздела «Аналитика». metric: overview — ТОЛЬКО сводные числа за период с сравнением к прошлому (звонки, диалоги, контакты, средняя длительность), без динамики; диалоги/контакты считаются по АКТИВНОСТИ в периоде (чат открыт в периоде ИЛИ в нём были сообщения), а не только но...
This record as markdown: /tools/happ-ai-platform-mcp/happ-analytics.md
What happ_analytics does on Platform
AI agents call happ_analytics to retrieve information from Platform without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.
| Parameter | Type | Required | Description |
|---|---|---|---|
to | string | — | Конец периода, ISO-дата |
from | string | — | Начало периода, ISO-дата (например 2026-06-01) |
skip | integer | — | |
take | integer | — | Лимит (для contacts/recent-contacts) |
metric | string | Yes | Какую метрику получить. Динамика звонков или чатов по дням/неделям/месяцам → usage; calls — часы пик, длительности и топ номеров без динамики; overview — сводны |
groupBy | string | — | Группировка: usage — day/week/month; time-series — hour/day/week/month. Для графика по дням — day |
companyId | string | Yes | ID компании |
assistantId | string | — | Фильтр по ассистенту (для tools/channels/time-series) |
Parameters from the server's own tool schema.
Why happ_analytics is rated Low
Even though happ_analytics only reads data, uncontrolled read access leaks sensitive information and racks up API costs: an agent caught in a retry loop can make thousands of calls a minute without anyone noticing.
Attacks that exploit this kind of access
The rule that runs happ_analytics safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Platform, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For happ_analytics, this is the rule to start with:
happ_analytics is read-only, so it stays allowed. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Platform, apply this rule, and every happ_analytics call is checked against it from then on.
Questions about happ_analytics
Статистика компании из раздела «Аналитика». metric: overview — ТОЛЬКО сводные числа за период с сравнением к прошлому (звонки, диалоги, контакты, средняя длительность), без динамики; диалоги/контакты считаются по АКТИВНОСТИ в периоде (чат открыт в периоде ИЛИ в нём были сообщения), а не только новые чаты; usage — динамика чатов и звонков по периодам (groupBy day/week/month); assistants-time-series / channels-time-series — динамика по ассистентам / по каналам (groupBy hour/day/week/month); ai-performance — эффективность ИИ; assistants, channels, contacts / recent-contacts, tools (вызовы инструментов) — срезы без динамики; calls — ТОЛЬКО часы пик (звонки по часам суток), распределение длительности и топ номеров, БЕЗ динамики по дням. ВАЖНО: динамика / по дням / за месяц для звонков ИЛИ чатов — это metric=usage (в ответе серии «Чаты» и «Звонки»), не calls. ДЛЯ ГРАФИКА («график», «динамика», «тренд», «по дням/неделям/месяцам», «сколько чатов было в августе по дням») вызывай metric=usage (чаты + звонки) или *-time-series с groupBy и from/to — платформа сама нарисует график по результату, текстом его пересказывать не нужно. Расход токенов/кредитов по дням — happ_billing_credits_history. (GET /analytics/company/*). It is categorised as a Read tool in the Platform MCP Server, which means it retrieves data without modifying state.
happ_analytics accepts 8 parameters: to, from, skip, take, metric, groupBy, companyId, assistantId. Required: metric, companyId. The full parameter table on this page comes from the server's own tool schema.
Register the Platform MCP server in PolicyLayer and add a rule for happ_analytics: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Platform. Nothing to install.
happ_analytics is a Read tool with low risk. Read-only tools are generally safe to allow by default.
Yes. Add a rate_limit block to the happ_analytics rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for happ_analytics. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
happ_analytics is provided by the Platform MCP server (@happ-ai/platform-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Platform, and thousands of servers like it.
This server
Across the catalogue