List events

What it does

All event names with counts (includes 'pageview' and custom events). Volume metric — counts include AI-mediated human browsing (ai_user_action).

Example prompts

Ask Claude (or any MCP client connected to mcp-analytics) something like:

What custom events fired on mysite.com last 14 days?

The client will pick list_events automatically based on the prompt and your account's available sites.

Arguments

Name	Type	Required	Description / Default
site_id	string	required	Site identifier from list_sites (8-character base32, e.g. 'wjxayhdd').
period	string	optional	Time window. Keywords: today, yesterday, last_7_days, last_30_days, last_90_days, last_12_months. Or a custom date range YYYY-MM-DD..YYYY-MM-DD (inclusive). default: last_7_days

How to call it directly

If you're integrating from your own code rather than a chat client, this is the JSON-RPC payload:

curl -X POST https://mcp-analytics.com/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_events",
    "arguments": {
      "site_id": "abc12345"
    }
  }
}'

Token comes from /settings after you sign up. Replace any required arguments above.

Related tools

• get_tracking_snippet: Return the HTML <script> snippet for a given site_id.
• color_scheme_breakdown: Share of visitors with prefers-color-scheme: dark vs light.
• compare_periods: Compare a metric between two periods.
• top_languages: Top browser languages (de-DE, en-US, ...) of visitors.
• event_details: Details for one event.