Agent Analytics

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Analytics your AI agent can actually use. Track, experiment, and optimize via MCP.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Agent Analytics": {
      "url": "https://mcp.agentanalytics.sh/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (28)

• account_usage read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• analytics_panel read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_projects read-only

  List all your Agent Analytics projects Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• create_project

  Create a new Agent Analytics project. Returns the tracking snippet and API example. Idempotent — returns existing project if name already taken.

  Parameters:

  • name (required) — string — Project name (letters, numbers, hyphens, dots, max 64 chars)
  • allowed_origins — string — Allowed CORS origins, defaults to *

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• get_project_context read-only

  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.

  Parameters:

  • project (required) — string — Project name or ID

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• set_project_context destructive

  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.

  Parameters:

  • project (required) — string — Project name or ID
  • goals — array — Short business goals, max 5
  • glossary — array — Event-name glossary entries, max 10
  • annotations — array — Major date annotations, max 100
  • activation_events — array — Event names that define activation, max 8

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• properties read-only

  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.

  Parameters:

  • project (required) — string — Project name
  • days — number — Lookback window in days

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• properties_received read-only

  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.

  Parameters:

  • project (required) — string — Project name
  • since — string — Start date (ISO or shorthand like 7d)
  • sample — number — Events to sample

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• sessions read-only

  List individual session records Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.

  Parameters:

  • project (required) — string — Project name
  • limit — number — Max results
  • since — string — Start date

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_experiments read-only

  List A/B experiments for a project Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.

  Parameters:

  • project (required) — string — Project name

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• create_experiment

  Create an A/B experiment

  Parameters:

  • project (required) — string — Project name
  • name (required) — string — Experiment name
  • variants (required) — array — Variant keys, e.g. ['control', 'new_cta']
  • goal_event (required) — string — Goal event name to measure conversions
  • weights — array — Variant weights, e.g. [50, 50]

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• get_experiment read-only

  Get experiment details with results Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.

  Parameters:

  • id (required) — string — Experiment ID

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• update_experiment destructive

  Update experiment status (pause, resume, complete)

  Parameters:

  • id (required) — string — Experiment ID
  • status (required) — string — New status
  • winner — string — Winning variant (for completing)

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• delete_experiment destructive

  Delete an experiment

  Parameters:

  • id (required) — string — Experiment ID

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• live_now read-only

  Real-time snapshot: active visitors, sessions, events per minute, top pages, and recent events. Reads from in-memory ring buffer — no D1 query.

  Parameters:

  • project (required) — string — Project name
  • window — number — Time window in seconds (10-300, default 60)

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• all_sites_overview read-only

  Historical summary across all projects in your account: total events, active project count, daily trend, and top projects.

  Parameters:

  • limit — number — Max projects to include in the top-project list
  • period — string — Comparison period

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• bot_traffic_overview read-only

  Filtered automated traffic for a single project: automated requests, dropped events, categories, and top actors.

  Parameters:

  • project (required) — string — Project name
  • limit — number — Max actors to include
  • period — string — Comparison period

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• all_sites_bot_traffic read-only

  Filtered automated traffic across all active projects in your account.

  Parameters:

  • limit — number — Max projects to include
  • period — string — Comparison period

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• query read-only

  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.

  Parameters:

  • project (required) — string — Project name
  • email — string — Filter by server-side scoped HMAC email lookup. Raw email is sent only in the authenticated HTTPS POST body and is not stored in event rows or profile traits.
  • limit — number — Max results (default 100, max 1000)
  • order — string — Sort direction
  • date_to — string — End date (ISO 8601). Defaults to today.
  • filters — array — Filters to apply
  • metrics — array — Metrics to compute
  • group_by — array — Fields to group results by
  • order_by — string — Field to sort by
  • date_from — string — Start date (ISO 8601 or Nd shorthand like '30d'). Defaults to 7 days ago.
  • count_mode — string — How event_count is aggregated. Default for event_count: session_then_user. 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. Ignored for queries without event_count. Use raw for ingestion/debugging counts.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• analytics_funnel read-only

  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.

  Parameters:

  • project (required) — string — Project name
  • steps (required) — array — Funnel steps (2-8), each with an event name and optional filters
  • since — string — Lookback period (e.g. '30d', '90d', or ISO date)
  • count_by — string — Count by users or sessions
  • breakdown — string — Property key to segment by (e.g. 'variant', 'country'). Extracted from step 1 events.
  • breakdown_limit — number — Max breakdown groups (default 10, max 50)
  • conversion_window_hours — number — Max hours from step 1 to last step (default: 168 = 7 days)

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• analytics_retention read-only

  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.

  Parameters:

  • project (required) — string — Project name
  • event — string — First-seen event filter (e.g. signup). Switches to event-based retention.
  • period — string — Cohort grouping period
  • cohorts — number — Number of cohort periods (max: day=30, week=12, month=12)
  • returning_event — string — What counts as 'returned' (defaults to same as event)

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• analytics_overview read-only

  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.

  Parameters:

  • project (required) — string — Project name
  • days — number — Lookback window in days

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• analytics_insights read-only

  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.

  Parameters:

  • project (required) — string — Project name
  • period — string — Comparison period

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• analytics_breakdown read-only

  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.

  Parameters:

  • project (required) — string — Project name
  • days — number — Lookback window in days
  • event — string — Filter by event name (e.g. page_view)
  • limit — number — Max results
  • property — string — Property key to group by (e.g. path, referrer, utm_source)

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• analytics_pages read-only

  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.

  Parameters:

  • project (required) — string — Project name
  • type — string — Page type
  • limit — number — Max results

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• analytics_paths read-only

  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.

  Parameters:

  • project (required) — string — Project name
  • goal_event (required) — string — Goal event to attribute within the same session
  • since — string — Lookback period
  • max_steps — integer — Max mixed page/event steps before truncation
  • path_limit — integer — Max children kept per node
  • entry_limit — integer — Max entry pages to include
  • candidate_session_cap — integer — Bound on candidate sessions scanned

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• analytics_sessions read-only

  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.

  Parameters:

  • project (required) — string — Project name

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• analytics_heatmap read-only

  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.

  Parameters:

  • project (required) — string — Project name

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.