Get site stats
Read the top stats of a site dashboard for a date range, optionally compared with an earlier one.
MCP tool plausible_read → get_site_stats
read
Returns unique visitors, visits, pageviews, views per visit, bounce rate and visit duration for the range, the same numbers as the graph at the top of the dashboard. With compare, it adds the same numbers for the matching earlier range and the change in visitors. The current day is incomplete, so a range that ends today understates it.
Parameters
| Name | Type | Description |
|---|---|---|
| site string required | string | Domain of the site as the Sites page lists it, e.g. acme-shop.example. |
| from string | string | First day of the date range, YYYY-MM-DD. Default: the last 30 days. |
| to string | string | Last day of the date range, YYYY-MM-DD. Default: today. |
| compare string | string | previous_period or year_over_year. Leave out for no comparison. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "plausible_read",
"arguments": {
"operation": "get_site_stats",
"arguments": {
"site": "acme-shop.example",
"from": "2026-10-12",
"to": "2026-10-18",
"compare": "previous_period"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"site": "acme-shop.example",
"from": "2026-10-12",
"to": "2026-10-18",
"visitors": 4210,
"visits": 5033,
"pageviews": 9120,
"views_per_visit": 1.81,
"bounce_rate": "58%",
"visit_duration": "1m 34s",
"compared_to": {
"from": "2026-10-05",
"to": "2026-10-11",
"visitors": 3890,
"pageviews": 8410
},
"visitors_change": "+8%"
},
"isError": false
}