MCP.so
Sign In

MCP Fathom Analytics

@mackenly

About MCP Fathom Analytics

MCP server for Fathom Analytics

Basic information

Category

Data & Analytics

License

MIT

Runtime

node

Transports

stdio

Publisher

mackenly

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Do I need a Fathom API key?

Yes, a valid Fathom API key must be set as the FATHOM_API_KEY environment variable to authenticate with the Fathom Analytics API.

Comments

More Data & Analytics MCP servers