Agent Analytics

io.github.dannyshmueliPublished by GitHub account dannyshmueliv1.0.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableProductivity & WorkflowData & Analytics

Overview

AI-generated overview

A remote analytics MCP server that lets an assistant read Agent Analytics projects, run queries, funnels, retention and experiments, and manage project context.

What you can do
List and create projects, and read or set compact project context such as goals and event glossaries, with a tracking snippet returned on creation. Explore events and properties, list sessions, and run ad-hoc queries with custom metrics, filters, grouping and date ranges. Get overviews, KPIs, breakdowns, page and path stats, session histograms, heatmaps, funnels and cohort retention. Compare periods with insights, view real-time traffic, and summarize all projects or bot traffic. Create, inspect, update and delete A/B experiments, and check plan, usage and spend cap.
When to use it
Useful when you want an assistant to answer product analytics questions, investigate drop-off or retention, review experiments, or set up a new project without leaving the conversation.
Requirements
Remote streamable HTTP endpoint; no local runtime or declared environment variables. Most tools need a signed-in Agent Analytics account with project access; without sign-in only a synthetic read-only demo project is available. Some tools require the account:read permission.
Before you install
Tools can create projects, write project context, and create, update or delete experiments, so changes affect live analytics data. Account usage and billing estimates are read-only and cannot charge. Customer email lookup is described as privacy-first; analytics data is sent to the remote service.

Installation

In SourceWeft

  1. Open Agent Analytics in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.dannyshmueli%2Fagent-analytics-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

This repository has no README.

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.

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_projects

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_project

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

Parametersnamerequiredallowed_origins

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.

Parametersprojectrequired

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.

Parametersgoalsprojectrequiredglossaryannotationsactivation_events

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.

Parametersdaysprojectrequired

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.

Parameterssincesampleprojectrequired

sessions

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

Parameterslimitsinceprojectrequired

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.

Parametersprojectrequired

create_experiment

Create an A/B experiment

Parametersnamerequiredprojectrequiredweightsvariantsrequiredgoal_eventrequired

get_experiment

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

Update experiment status (pause, resume, complete)

Parametersidrequiredstatusrequiredwinner

delete_experiment

Delete an experiment

Parametersidrequired

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.

Parameterswindowprojectrequired

all_sites_overview

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

Parameterslimitperiod

bot_traffic_overview

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

Parameterslimitperiodprojectrequired

all_sites_bot_traffic

Filtered automated traffic across all active projects in your account.

Parameterslimitperiod

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.

Parametersemaillimitorderdate_tofiltersmetricsprojectrequiredgroup_byorder_bydate_fromcount_mode

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.

Parameterssincestepsrequiredprojectrequiredcount_bybreakdownbreakdown_limitconversion_window_hours

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.

Parameterseventperiodcohortsprojectrequiredreturning_event

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.

Parametersdaysprojectrequired

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.

Parametersperiodprojectrequired

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.

Parametersdayseventlimitprojectrequiredproperty

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.

Parameterstypelimitprojectrequired

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.

Parameterssinceprojectrequiredmax_stepsgoal_eventrequiredpath_limitentry_limitcandidate_session_cap

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.

Parametersprojectrequired

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.

Parametersprojectrequired

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.