What it does
Pageviews bucketed by viewport width: mobile_xs (<480), mobile (<768), tablet (<1024), desktop (<1440), desktop_xl (≥1440). Real usable viewport, not screen resolution.
Example prompts
Ask Claude (or any MCP client connected to mcp-analytics) something like:
Mobile vs desktop on mysite.com — what's the breakdown?The client will pick viewport_breakdown 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": "viewport_breakdown",
"arguments": {
"site_id": "abc12345"
}
}
}'Token comes from /settings after you sign up. Replace any required arguments above.
Related tools
top_user_agents: Top User-Agent strings with their traffic_class.list_sites: List all sites on the authenticated account.event_details: Details for one event.top_languages: Top browser languages (de-DE, en-US, ...) of visitors.get_timeseries: Time-bucketed metric over a period.