MCP Fathom Analytics

Name: MCP Fathom Analytics
Author: mackenly

@mackenly

代码仓库主页

关于 MCP Fathom Analytics

MCP server for Fathom Analytics

#mcp #fathom-analytics #mcp-server

基本信息

分类

数据与分析

许可证

MIT

运行时

node

传输方式

stdio

发布者

mackenly

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "fathom-analytics": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-fathom-analytics"
      ],
      "env": {
        "FATHOM_API_KEY": "your_api_key_here"
      }
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is MCP Fathom Analytics?

An unofficial Model Context Protocol server that enables AI assistants to access and query Fathom Analytics data. It uses the @mackenly/fathom-api SDK to interact with the Fathom Analytics API and is published as an npx script. Not affiliated with or endorsed by Fathom Analytics.

How to use MCP Fathom Analytics?

Install and configure via the JSON config for Claude Desktop (or other MCP clients). Set the FATHOM_API_KEY environment variable. Run with npx -y mcp-fathom-analytics. Example config snippet is provided in the README.

Key features of MCP Fathom Analytics

Retrieve Fathom account information (get-account)
List all Fathom Analytics sites (list-sites)
List events for a specific site (list-events)
Generate aggregated analytics reports with flexible filtering and grouping (get-aggregation)
Get real‑time current visitor data (get-current-visitors)

Use cases of MCP Fathom Analytics

Query daily pageview statistics for the last 30 days
Analyze performance of individual pages (pageviews, uniques, average duration)
See traffic breakdown by country (visits per country code)
Monitor current visitors in real time
Retrieve account and site details for administrative checks

FAQ from MCP Fathom Analytics

Is this an official Fathom Analytics product?

No, this server is unofficial and not affiliated, endorsed, or supported by Fathom Analytics.

How do I set up the MCP server?

Add a JSON entry to your MCP client config (e.g., Claude Desktop) with command: "npx", args: ["-y", "mcp-fathom-analytics"], and the environment variable FATHOM_API_KEY set to your Fathom API key.

What tools does the server provide?

It provides five tools: get-account, list-sites, list-events, get-aggregation, and get-current-visitors.

What aggregation options are available?

The get-aggregation tool supports entity, entity_id, aggregates (pageviews, uniques, visits, avg_duration), date_grouping, field_grouping, sort_by, and limit. Full examples are documented in the README.