Summary
get-account, list-sites, list-events and get-current-visitors are lookups; get-aggregation is the one that answers a question.
date_grouping and field_grouping are what turn a raw count into a report — pageviews by day, or by referrer — and filters narrows the set before the grouping applies, so the shape of the answer is settled in one call rather than by post-processing what came back. list-events is the read that handles its own pagination, which is the difference between a usable event audit and a first page.
What it is
A Fathom Analytics API client with 5 tools covering the account, its sites, a site's events, its live visitor count, and aggregated analytics.
What you get
- get-aggregation is the analytical tool: aggregates, entity and entity_id, date_from and date_to, date_grouping and field_grouping, filters, sort_by, limit and timezone.
- get-current-visitors returns the live visitor count for a site, with a detailed flag for the breakdown.
- list-sites for the sites on the account, and list-events for one site's events, paged automatically by the server.
- get-account for the account behind the key.
Requirements
A Fathom Analytics API key, supplied as FATHOM_API_KEY.
Setup effort
One command plus a key — npx -y mcp-fathom-analytics, then supply credentials