Fathom Analytics

MCP server for Fathom Analytics

typescript

3

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can access Fathom Analytics data through an MCP server that exposes common data endpoints (account info, sites, events, analytics aggregations, and real-time visitors) to your AI assistant. This MCP server runs via npx and uses your Fathom API key to securely fetch data for you.

How to use

Connect the MCP server to your preferred MCP client (for example Claude Desktop or another client that supports MCP) using the provided config. Once connected, you can request account details, list your sites, fetch site events, generate analytics aggregations with flexible filtering, and query real-time visitor data. Each tool is designed to help you quickly retrieve the exact dataset you need from Fathom Analytics without leaving your conversational workflow.

How to install

Prerequisites: you need Node.js and npm installed on your system.

Install Node.js and npm if you don’t have them yet. Then install the MCP client package and run the MCP server via npx as shown in the configuration example.

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

Additional notes

The MCP server provides a focused set of tools for interacting with Fathom Analytics through an AI assistant. Be sure to keep your API key secure and rotate it if you suspect it has been compromised.

Available tools

get-account

Retrieve details about your Fathom Analytics account.

list-sites

List all your Fathom Analytics sites.

list-events

List events for a specific site.

get-aggregation

Generate aggregated analytics reports with flexible filtering and grouping options.

get-current-visitors

Get real-time data about current site visitors.