get_workspace_overview
Aggregate visitors, pageviews, sessions, bounce rate, and top sites across all workspace sites. Supports dimension filters and custom date ranges for targeted analysis.
Instructions
Aggregate metrics across all sites in the workspace (visitors, pageviews, sessions, bounce rate, top sites). Supports filters and custom date ranges.
Optional dimension filters. Each filter is {dim, op, value}. Available dims: page, entry_page, exit_page, referrer, hostname, channel, ai_source, utm_source, utm_medium, utm_campaign, country, region, city, language, device, browser, screen, event_name, or prop:. Available ops: is, is_not, contains, not_contains. Filters AND together. Example: [{dim:'country', op:'is', value:'US'}, {dim:'device', op:'is_not', value:'mobile'}].
Optional date range. Either {preset:'last_7_days'} (also: today, yesterday, last_14_days, last_30_days, last_90_days, last_year, month_to_date, last_month, all_time) OR {from:'2026-05-01', to:'2026-05-15'} for a custom range (ISO 8601 dates or timestamps). Defaults vary by tool.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date_range | No | Optional date range. Either {preset:'last_7_days'} OR {from:'2026-05-01', to:'2026-05-15'}. Defaults per tool — usually last_7_days. | |
| filters | No | AND-joined dimension filters. Each is {dim, op, value}. See MCPFilter schema for dim/op options. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| visitors | Yes | ||
| pageviews | Yes | ||
| sessions | Yes | ||
| totalEvents | Yes | ||
| uniqueSites | Yes | ||
| bounceRate | Yes | ||
| avgSessionSeconds | Yes | ||
| viewsPerVisit | Yes | ||
| topSites | Yes | Top sites by visitor count, capped at 10. NOT filter-aware — operators want 'biggest sites' as workspace context. |