About Fathom Analytics
Fathom Analytics is an MCP server published by mackenly in the Maps category: mCP server for Fathom Analytics.
The repository has 4 stars and 5 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/mackenly/mcp-fathom-analyticsThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Fathom Analytics
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 5 hours ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
MCP Fathom Analytics
An unofficial Model Context Protocol (MCP) server for accessing Fathom Analytics data through an AI assistant. This implementation uses the @mackenly/fathom-api unofficial SDK to interact with the Fathom Analytics API. Not affiliated, endorsed, or supported by Fathom Analytics. Published to npm as an npx script.
Features
The MCP server provides the following Fathom Analytics tools:
Account Information
get-account: Retrieve details about your Fathom Analytics account
Sites Management
list-sites: List all your Fathom Analytics sites
Events
list-events: List events for a specific site
Analytics
get-aggregation: Generate aggregated analytics reports with flexible filtering and grouping options
Visitor Tracking
get-current-visitors: Get real-time data about current site visitors
Usage
If you're using Claude Desktop, you can add the MCP server using the json config (more info). Here's an example:
{
"mcpServers": {
"fathom-analytics": {
"command": "npx",
"args": [
"-y",
"mcp-fathom-analytics"
],
"env": {
"FATHOM_API_KEY": "your_api_key_here"
}
}
}
}
You can find more information about other MCP Clients here: Model Context Protocol Example Clients
API Structure
The MCP server uses the @mackenly/fathom-api SDK to interface with the Fathom Analytics API endpoints:
- Account API:
https://api.usefathom.com/v1/account - Sites API:
https://api.usefathom.com/v1/sites - Events API:
https://api.usefathom.com/v1/sites/SITE_ID/events - Aggregation API:
https://api.usefathom.com/v1/aggregations - Current Visitors API:
https://api.usefathom.com/v1/current_visitors
Aggregation Examples
The aggregation tool is highly flexible. Here are some example use cases:
- Daily pageview statistics for the last 30 days:
{
"entity": "pageview",
"entity_id": "SITE_ID",
"aggregates": "pageviews,uniques,visits",
"date_grouping": "day",
"date_from": "2023-08-01 00:00:00"
}
- Performance of individual pages:
{
"entity": "pageview",
"entity_id": "SITE_ID",
"aggregates": "pageviews,uniques,avg_duration",
"field_grouping": "pathname",
"sort_by": "pageviews:desc",
"limit": 10
}
- Traffic from specific countries:
{
"entity": "pageview",
"entity_id": "SITE_ID",
"aggregates": "visits",
"field_grouping": "country_code",
"sort_by": "visits:desc"
}
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This project is licensed under the MIT License - see the LICENSE file for details.
README fetched from the repository 5 hours ago. The original is authoritative.