Engagement overview

What it does

Real reading time + scroll depth from the engagement beacon (fired on pagehide). Returns engaged_pages count, avg/median/p90 engagement seconds, and avg/median scroll-depth percentage. Better signal than session duration which counts inactive tabs.

Example prompts

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

How engaged are mysite.com visitors? Scroll depth and time on page.

The client will pick engagement_overview 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": "engagement_overview",
    "arguments": {
      "site_id": "abc12345"
    }
  }
}'

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

Related tools

• top_timezones: Top IANA timezones (Europe/Berlin, America/New_York, ...) of visitors.
• top_pages: Most-viewed URL paths.
• get_started_guide: Markdown walkthrough of the mcp-analytics workflow: adding sites, installing the tracker, querying analytics, custom events.
• top_sources: Top UTM source/medium/campaign combinations.
• top_referrers: Top referring hosts.