Skip to Content
AI Agents (MCP)Tool referenceget_product_analytics

get_product_analytics

A product’s activity over a date range, per day (or per hour for ranges up to 7 days), in the organization timezone: new installs, activations (incl. reactivations), deactivations, uninstalls (removals — not deactivations), telemetry events received, and for days the active-install snapshot. from/to are YYYY-MM-DD (default last 30 days, max 400). Ranges over 90 days cost 3 rate-limit units.

  • Server: Organization server
  • Scope: analytics:read
  • Read-only: yes

Input

{ "properties": { "product": { "description": "The product id (UUID) or slug, as list_products returns them.", "type": "string" }, "from": { "description": "YYYY-MM-DD, default 30 days ago.", "type": "string" }, "to": { "description": "YYYY-MM-DD inclusive, default today.", "type": "string" }, "granularity": { "description": "Default day; hour allows at most 7 days.", "enum": [ "day", "hour" ], "type": "string" } }, "type": "object", "required": [ "product" ] }

Output (structuredContent)

{ "properties": { "as_of": { "type": "string" }, "product_id": { "type": "string" }, "range": { "properties": { "from": { "type": "string" }, "to": { "type": "string" }, "timezone": { "type": "string" }, "days": { "type": "integer" } }, "type": "object" }, "granularity": { "type": "string" }, "totals": { "properties": { "installs_count": { "type": "integer" }, "activations_count": { "type": "integer" }, "deactivations_count": { "type": "integer" }, "uninstalls_count": { "type": "integer" }, "telemetry_events_count": { "type": "integer" } }, "type": "object" }, "series": { "type": "array" } }, "type": "object", "required": [ "as_of", "product_id", "range", "granularity", "totals", "series" ] }