Agent Analytics

agent-analytics/agent-analytics-mcp

Gives your AI agent a direct line to analytics tracking and experimentation. You can log events, track user behavior, run A/B tests, and pull performance metrics without building your own analytics infrastructure. Works over streamable HTTP, so you can drop it into any MCP-compatible setup and start instrumenting your agent's interactions immediately. Reach for this when you need to understand how users actually interact with your agent, which prompts perform better, or where conversations drop off. It's the observability layer for AI agents that lets you iterate based on real usage data instead of guessing.

tools: 28
transport: HTTP
last updated: Feb 22, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://mcp.agentanalytics.sh/mcp --name agent-analytics-mcp

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http agent-analytics-mcp https://mcp.agentanalytics.sh/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 28 tools

Verified live against the running server on Nov 6, 2026.

account_usageRead 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.

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.

No parameters. Call it with no arguments.

analytics_panelUse 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 r...

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 r...

No parameters. Call it with no arguments.

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

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

No parameters. Call it with no arguments.

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

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

Parameters* required

allowed_originsstring

Allowed CORS origins, defaults to *

name*string

Project name (letters, numbers, hyphens, dots, max 64 chars)

get_project_contextGet 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.1 params

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* required

project*string

Project name or ID

set_project_contextSet 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, ev...5 params

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, ev...

Parameters* required

activation_eventsarray

Event names that define activation, max 8

annotationsarray

Major date annotations, max 100

glossaryarray

Event-name glossary entries, max 10

goalsarray

Short business goals, max 5

project*string

Project name or ID

propertiesDiscover 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.2 params

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* required

daysnumber

Lookback window in daysdefault: 30

project*string

Project name

properties_receivedProperty 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.3 params

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* required

project*string

Project name

samplenumber

Events to sampledefault: 5000

sincestring

Start date (ISO or shorthand like 7d)

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

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

Parameters* required

limitnumber

Max resultsdefault: 100

project*string

Project name

sincestring

Start date

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

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* required

project*string

Project name

create_experimentCreate an A/B experiment5 params

Create an A/B experiment

Parameters* required

goal_event*string

Goal event name to measure conversions

name*string

Experiment name

project*string

Project name

variants*array

Variant keys, e.g. ['control', 'new_cta']

weightsarray

Variant weights, e.g. [50, 50]

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

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

Parameters* required

id*string

Experiment ID

update_experimentUpdate experiment status (pause, resume, complete)3 params

Update experiment status (pause, resume, complete)

Parameters* required

id*string

Experiment ID

status*string

New statusone of active · paused · completed

winnerstring

Winning variant (for completing)

delete_experimentDelete an experiment1 params

Delete an experiment

Parameters* required

id*string

Experiment ID

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

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

Parameters* required

project*string

Project name

windownumber

Time window in seconds (10-300, default 60)default: 60

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

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

Parameters* required

limitnumber

Max projects to include in the top-project listdefault: 10

periodstring

Comparison periodone of 1d · 7d · 14d · 30d · 90ddefault: 7d

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

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

Parameters* required

limitnumber

Max actors to includedefault: 10

periodstring

Comparison periodone of 1d · 7d · 14d · 30d · 90ddefault: 7d

project*string

Project name

all_sites_bot_trafficFiltered automated traffic across all active projects in your account.2 params

Filtered automated traffic across all active projects in your account.

Parameters* required

limitnumber

Max projects to includedefault: 10

periodstring

Comparison periodone of 1d · 7d · 14d · 30d · 90ddefault: 7d

queryRun 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 sign...11 params

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 sign...

Parameters* required

count_modestring

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 t...one of raw · session_then_user

date_fromstring

Start date (ISO 8601 or Nd shorthand like '30d'). Defaults to 7 days ago.

date_tostring

End date (ISO 8601). Defaults to today.

emailstring

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.

filtersarray

Filters to apply

group_byarray

Fields to group results by

limitnumber

Max results (default 100, max 1000)default: 100

metricsarray

Metrics to compute

orderstring

Sort directionone of asc · descdefault: desc

order_bystring

Field to sort byone of event_count · unique_users · session_count · date · event

project*string

Project name

analytics_funnelFunnel 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 f...7 params

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 f...

Parameters* required

breakdownstring

Property key to segment by (e.g. 'variant', 'country'). Extracted from step 1 events.

breakdown_limitnumber

Max breakdown groups (default 10, max 50)default: 10

conversion_window_hoursnumber

Max hours from step 1 to last step (default: 168 = 7 days)default: 168

count_bystring

Count by users or sessionsone of user_id · session_iddefault: user_id

project*string

Project name

sincestring

Lookback period (e.g. '30d', '90d', or ISO date)default: 30d

steps*array

Funnel steps (2-8), each with an event name and optional filters

analytics_retentionCohort 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 you...5 params

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 you...

Parameters* required

cohortsnumber

Number of cohort periods (max: day=30, week=12, month=12)default: 8

eventstring

First-seen event filter (e.g. signup). Switches to event-based retention.

periodstring

Cohort grouping periodone of day · week · monthdefault: week

project*string

Project name

returning_eventstring

What counts as 'returned' (defaults to same as event)

analytics_overviewGet 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.2 params

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* required

daysnumber

Lookback window in daysdefault: 7

project*string

Project name

analytics_insightsPeriod-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.2 params

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* required

periodstring

Comparison periodone of 1d · 7d · 14d · 30d · 90ddefault: 7d

project*string

Project name

analytics_breakdownTop 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.5 params

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* required

daysnumber

Lookback window in daysdefault: 7

eventstring

Filter by event name (e.g. page_view)

limitnumber

Max resultsdefault: 20

project*string

Project name

propertystring

Property key to group by (e.g. path, referrer, utm_source)default: path

analytics_pagesEntry/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.3 params

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* required

limitnumber

Max resultsdefault: 20

project*string

Project name

typestring

Page typeone of entry · exit · bothdefault: entry

analytics_pathsBounded 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.7 params

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* required

candidate_session_capinteger

Bound on candidate sessions scanneddefault: 5000

entry_limitinteger

Max entry pages to includedefault: 10

goal_event*string

Goal event to attribute within the same session

max_stepsinteger

Max mixed page/event steps before truncationdefault: 5

path_limitinteger

Max children kept per nodedefault: 5

project*string

Project name

sincestring

Lookback periodone of 7d · 14d · 30d · 90ddefault: 30d

analytics_sessionsSession 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.1 params

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* required

project*string

Project name

analytics_heatmapDay-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.1 params

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* required

project*string

Project name

Readme

Details

Repository: github.com/agent-analytics/agent-analytics-mcp
Categories: AI & LLM Tools, Monitoring & Observability
Transport: HTTP
Registry: MCP registry, active
Resources: 41
Tools verified: Nov 6, 2026

Related AI & LLM Tools MCP servers

View all

A2atlassianagentic-eng/a2atlassianJira & Confluence for AI agents. Pre-configured connections, compact output.0stars

i18n-agenti18n-agent/mcp-clientAI-powered translation for 48 languages with context-aware quality0stars

Free Agent Toolsakiba-labs/free-agent-tools43 free no-auth tools: Japan life, visas, travel and work checks, plus pitch roast.0stars

Agent Brokerbasilalshukaili/agentbroker23 MCP tools: compliance, verification, messaging, booking, US contracts. 15 need no key.0stars

Agent Commerce Mcpbch1212/agent-commerce-mcpAgent Commerce MCP — agent-native A2A storefront. Discovery, Stripe checkout, affiliate program.0stars

Agenttunebernardjhuang/agenttunePersonality tuning files for AI agents: 43 MIT-licensed tunings + 5 inline personality tests.0stars