Read current account plan, usage, billing estimate and spend cap, Pro pricing, and a human payment handoff when needed. Requires account:read. Read-only: cannot charge or manage billing. Call again after checkout to verify hosted entitlement, then retry the original task.
Takes no parameters.
analytics_panel
Analytics explorer
Use this when you want to explore an authorized project's analytics beside the conversation. Opens a compact project/view picker; accepts empty input. Analysis queries retain their existing plan and access checks. Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.
Takes no parameters.
List all your Agent Analytics projects Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.
Takes no parameters.
Create a new Agent Analytics project. Returns the tracking snippet and API example. Idempotent — returns existing project if name already taken.
Parametersnamerequiredallowed_origins
Get compact self-improving project context: goals, activation events, event-name glossary, and major date annotations used to interpret analytics results. Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.
Parametersprojectrequired
Set or replace compact project context. The encoded API request body is capped at 512KB. Read existing context first, merge still-valid entries, inspect event names with properties or properties_received, and save only durable product truth tied to goals, activation events, event-name glossary entries, or date annotations for major product changes. Use annotations for meaningful landing page, pricing, onboarding, feature, release, or experiment changes; do not store git commit logs, noisy edits, PII, secrets, or long release notes.
Parametersgoalsprojectrequiredglossaryannotationsactivation_events
Discover event names and property keys from recent events Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.
Parametersdaysprojectrequired
Property keys by event name, sampled from recent events Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.
Parameterssincesampleprojectrequired
List individual session records Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.
Parameterslimitsinceprojectrequired
List A/B experiments for a project Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.
Parametersprojectrequired
Create an A/B experiment
Parametersnamerequiredprojectrequiredweightsvariantsrequiredgoal_eventrequired
Get experiment details with results Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.
Parametersidrequired
Update experiment status (pause, resume, complete)
Parametersidrequiredstatusrequiredwinner
Delete an experiment
Parametersidrequired
Real-time snapshot: active visitors, sessions, events per minute, top pages, and recent events. Reads from in-memory ring buffer — no D1 query.
Parameterswindowprojectrequired
Historical summary across all projects in your account: total events, active project count, daily trend, and top projects.
Parameterslimitperiod
Filtered automated traffic for a single project: automated requests, dropped events, categories, and top actors.
Parameterslimitperiodprojectrequired
Filtered automated traffic across all active projects in your account.
Parameterslimitperiod
Run a flexible ad-hoc analytics query with custom metrics, filters, grouping, date ranges, and privacy-first customer email lookup. This is the most powerful endpoint — use it when other tools don't answer the question.
Examples of questions this tool answers:
- "How many signups from Germany this week?" → filters: [{field:"event",op:"eq",value:"signup"},{field:"country",op:"eq",value:"DE"}]
- "Which events contain 'page' in the name?" → filters: [{field:"event",op:"contains",value:"page"}], group_by: ["event"]
- "Daily unique users for the last 30 days" → metrics: ["unique_users"], group_by: ["date"], date_from: "30d"
- "Events per country" → group_by: ["country"]
Filter operators: eq, neq, gt, lt, gte, lte, contains
Filterable fields: event, user_id, date, country, session_id, timestamp, and any properties.* field (e.g. properties.path)
For customer-specific reads, use the top-level email input instead of hashing locally. Raw email is sent only in the authenticated HTTPS POST body; the server matches via a project-scoped HMAC index and does not store raw email in event rows or profile traits.
Built-in fields are a closed list. Event properties such as referrer, utm_source, path, browser, and hostname must be queried as properties.referrer, properties.utm_source, properties.path, properties.browser, and properties.hostname.
Invalid filter fields fail loudly and return /properties-style guidance instead of being silently ignored.
Group by: event, date, user_id, session_id, country
Metrics: event_count, unique_users, session_count, bounce_rate, avg_duration
Count modes: raw, session_then_user. The default for event_count is session_then_user for activation-safe counting: session-backed rows count by session, no-session rows fall back to user only when that user has no session-backed row in the same group, and fully anonymous rows fall back to event id. count_mode is ignored when event_count is not requested.
Parametersemaillimitorderdate_tofiltersmetricsprojectrequiredgroup_byorder_bydate_fromcount_mode
Funnel analysis: track where users drop off across a sequence of events (e.g. page_view → signup → purchase). Returns per-step user counts, conversion rates, and average time between steps. Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.
Parameterssincestepsrequiredprojectrequiredcount_bybreakdownbreakdown_limitconversion_window_hours
Cohort retention analysis — track what % of users return over time. By default uses session-based retention (any return visit counts). Pass 'event' to switch to event-based retention. Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.
Parameterseventperiodcohortsprojectrequiredreturning_event
Get time series chart, KPIs (events, users), and country breakdown (events, unique users) for a project over N days Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.
Parametersdaysprojectrequired
Period-over-period comparison with trend (events, users, bounce rate, session duration) Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.
Parametersperiodprojectrequired
Top property values ranked by count (pages, referrers, UTM sources, etc.) Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.
Parametersdayseventlimitprojectrequiredproperty
Entry/exit page stats with bounce rate, avg duration, events per session Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.
Parameterstypelimitprojectrequired
Bounded session path analysis from entry pages to goal, drop-off, or truncation. Useful for connecting page behavior to funnels, retention, and experiments. Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.
Parameterssinceprojectrequiredmax_stepsgoal_eventrequiredpath_limitentry_limitcandidate_session_cap
Session duration histogram with engaged percentage and median bucket Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.
Parametersprojectrequired
Day-of-week × hour traffic grid with peak detection (times in UTC) Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.
Parametersprojectrequired