Agent Analytics

---

name: agent-analytics

description: "Run analytics end-to-end from your agent without opening a dashboard. English-first workflow, with Chinese docs and content available. Create projects, ship tracking, query results, and run experiments."

version: 4.0.3

author: dannyshmueli

license: MIT

repository: https://github.com/Agent-Analytics/agent-analytics-mcp

homepage: https://agentanalytics.sh

compatibility: Requires npx and an Agent Analytics API key in AGENT_ANALYTICS_API_KEY. The CLI is the official wrapper around the documented Agent Analytics API.

tags:

- analytics

- tracking

- web

- events

- experiments

- live

metadata:

openclaw:

requires:

env:

- AGENT_ANALYTICS_API_KEY

anyBins:

- npx

primaryEnv: AGENT_ANALYTICS_API_KEY

---

# Agent Analytics

After install, your agent can create projects, ship tracking, query analytics, run experiments, and iterate without opening a dashboard.

English-first workflow, with Chinese docs and content available for OpenClaw users and teams in China.

Use it when you want an agent to operate growth analytics end-to-end, automate recurring checks, and manage multiple projects from one conversation loop.

Hosted free tier includes 100k events/month across 2 projects.

Chinese support / 中文支持

What `npx` is doing

Command format

The examples below use the CLI binary form:

agent-analytics <command>

In OpenClaw, that usually means:

npx @agent-analytics/cli@0.5.1 <command>

If the package is already installed, run the same commands directly as `agent-analytics <command>`.

For the full command list and flags:

agent-analytics --help

Safe operating rules

First-time setup

agent-analytics login --token aak_YOUR_API_KEY
agent-analytics create my-site --domain https://mysite.com
agent-analytics events my-site --days 7 --limit 20

The `create` command returns a project token and a ready-to-use tracking snippet. Add that snippet before `</body>`.

Common commands

agent-analytics projects
agent-analytics all-sites --period 7d
agent-analytics stats my-site --days 7
agent-analytics insights my-site --period 7d
agent-analytics events my-site --days 7 --limit 20
agent-analytics breakdown my-site --property path --event page_view --limit 10
agent-analytics funnel my-site --steps "page_view,signup,purchase"
agent-analytics retention my-site --period week --cohorts 8
agent-analytics experiments list my-site

If a task needs something outside these common flows, use `agent-analytics --help` first.

Tracker setup

The easiest install flow is:

1. Run `agent-analytics create my-site --domain https://mysite.com`

2. Copy the returned snippet into the page before `</body>`

3. Deploy

4. Verify with `agent-analytics events my-site --days 7 --limit 20`

If you already know the project token, the tracker looks like:

<script defer src="https://api.agentanalytics.sh/tracker.js"
  data-project="my-site"
  data-token="aat_..."></script>

Use `window.aa?.track('signup', {method: 'github'})` for custom events after the tracker loads.

Query caution

`agent-analytics query` exists for advanced reporting, but it should be used carefully because `--filter` accepts JSON.

Experiments

The CLI supports the full experiment lifecycle:

agent-analytics experiments list my-site
agent-analytics experiments create my-site --name signup_cta --variants control,new_cta --goal signup

References