get-account
Get Fathom Analytics account information
LABSCO 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
USE CASES
01
Answering a traffic question with the grouping it actually needs
Aggregates, date grouping, field grouping and filters all travel on one call, so the report comes back in the shape you asked for rather than needing to be reshaped.
02
Checking who is on the site right now
The live count is its own read, with a detailed flag when the total is not enough.
03
Auditing which events a site is actually recording
The event list pages itself, so a site with a long history comes back whole rather than as a first page you then have to walk.
04
Confirming what a key can see before building on it
The account read and the site list together settle which properties are in scope for everything else.
5 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get-aggregation
Get aggregated analytics data from Fathom
get-current-visitors
Get current visitors for a Fathom Analytics site
list-events
List all events for a Fathom Analytics site (automatically handles pagination)
list-sites
List all Fathom Analytics sites on the account
BEFORE YOU INSTALL
What to know first
Tools you get
5 tools when we connected.
Requires
- npx on PATH
- FATHOM_API_KEY in your environment
Where it runs
The documented client runs the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 5 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y mcp-fathom-analyticsMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"fathom-analytics": {
"command": "npx",
"args": [
"-y",
"mcp-fathom-analytics"
],
"env": {
"FATHOM_API_KEY": "<YOUR_FATHOM_API_KEY>"
}
}
}
}
