# Agent Analytics

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

- name: io.github.dannyshmueli/agent-analytics-mcp
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 78/100
- quality: 85/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.dannyshmueli%2Fagent-analytics-mcp
- tools: https://api.protogrid.dev/v1/servers/io.github.dannyshmueli%2Fagent-analytics-mcp/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "agent-analytics-mcp": {
      "type": "http",
      "url": "https://mcp.agentanalytics.sh/mcp"
    }
  }
}
```


## Trust

- hygiene: 100
- liveness: 97
- freshness: 45
- provenance: 65
- drivers: +repository +reachable +uptime-92% -stale-240d
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 85/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 86 (weight 30)

- pass `tools.descriptions`: every tool has a description
- warn `tools.description_length`: 1 tools have descriptions over 1,024 characters, which crowds the context
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 28 of 28 tools declare readOnlyHint or destructiveHint
- warn `tools.directory_hints`: 2 of 28 tools declare all four hints; missing: update_experiment (idempotentHint); analytics_funnel (idempotentHint); analytics_retention (idempotentHint); …
- pass `tools.token_cost`: about 5,470 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: 2 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 28, about 5,470 tokens to load them all
- tool set hash: 166ad27f0557dbf4075291077b5fb4f8
- tools last changed: 2026-10-09T14:56:48.704Z
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.dannyshmueli/agent-analytics-mcp.svg)](https://protogrid.dev/servers/io.github.dannyshmueli/agent-analytics-mcp)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-09 `account_usage` added
  - 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.
- 2026-10-09 `analytics_overview` changed (description)
  - before: Get time series chart + KPIs (events, users) for a project over N days Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.
  - after: 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.

Full history: https://api.protogrid.dev/v1/servers/io.github.dannyshmueli%2Fagent-analytics-mcp/changes

## Remotes

- https://mcp.agentanalytics.sh/mcp (streamable-http, auth none, reachable true, uptime30d 0.9189189)

## Packages

_none_

## Tools (28)

- `account_usage`: 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.
- `all_sites_bot_traffic`: Filtered automated traffic across all active projects in your account.
- `all_sites_overview`: Historical summary across all projects in your account: total events, active project count, daily trend, and top projects.
- `analytics_breakdown`: 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.
- `analytics_funnel`: 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.
- `analytics_heatmap`: 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.
- `analytics_insights`: 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.
- `analytics_overview`: 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.
- `analytics_pages`: 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.
- `analytics_panel`: 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.
- `analytics_paths`: 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.
- `analytics_retention`: 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.
- `analytics_sessions`: 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.
- `bot_traffic_overview`: Filtered automated traffic for a single project: automated requests, dropped events, categories, and top actors.
- `create_experiment`: Create an A/B experiment
- `create_project`: Create a new Agent Analytics project. Returns the tracking snippet and API example. Idempotent — returns existing project if name already taken.
- `delete_experiment`: Delete an experiment
- `get_experiment`: Get experiment details with results Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.
- `get_project_context`: 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.
- `list_experiments`: List A/B experiments for a project Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.
- `list_projects`: List all your Agent Analytics projects Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.
- `live_now`: Real-time snapshot: active visitors, sessions, events per minute, top pages, and recent events. Reads from in-memory ring buffer — no D1 query.
- `properties`: 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.
- `properties_received`: 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.
- `query`: 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.
- `sessions`: List individual session records Anonymous preview is limited to agentanalytics-demo synthetic read-only data; sign in for your own projects.
- `set_project_context`: 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.
- `update_experiment`: Update experiment status (pause, resume, complete)