Skip to main content
Glama

MCP Fathom Analytics

by mackenly

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:

  1. Account API: https://api.usefathom.com/v1/account
  2. Sites API: https://api.usefathom.com/v1/sites
  3. Events API: https://api.usefathom.com/v1/sites/SITE_ID/events
  4. Aggregation API: https://api.usefathom.com/v1/aggregations
  5. Current Visitors API: https://api.usefathom.com/v1/current_visitors

Aggregation Examples

The aggregation tool is highly flexible. Here are some example use cases:

  1. 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" }
  1. Performance of individual pages:
{ "entity": "pageview", "entity_id": "SITE_ID", "aggregates": "pageviews,uniques,avg_duration", "field_grouping": "pathname", "sort_by": "pageviews:desc", "limit": 10 }
  1. 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.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

An unofficial server that allows AI assistants to access Fathom Analytics data, enabling users to retrieve account information, site statistics, events, aggregated reports, and real-time visitor tracking.

  1. Features
    1. Account Information
    2. Sites Management
    3. Events
    4. Analytics
    5. Visitor Tracking
  2. Usage
    1. API Structure
      1. Aggregation Examples
        1. Contributing
          1. License

            Related MCP Servers

            • A
              security
              A
              license
              A
              quality
              Provides comprehensive access to Roam Research's API functionality. This server enables AI assistants like Claude to interact with your Roam Research graph through a standardized interface.
              Last updated -
              18
              302
              52
              TypeScript
              MIT License
              • Apple
            • A
              security
              A
              license
              A
              quality
              A server for interacting with the Iaptic API, allowing AI models like Claude to query customer, purchase, and transaction data, as well as retrieve statistical insights.
              Last updated -
              16
              4
              TypeScript
              MIT License
            • A
              security
              A
              license
              A
              quality
              This server provides tools for AI assistants to interact with the Eventbrite API, allowing users to search for events, get event details, retrieve venue information, and list event categories.
              Last updated -
              4
              2
              2
              JavaScript
              MIT License
              • Apple
            • -
              security
              A
              license
              -
              quality
              This server implementation allows AI assistants to interact with Asana's API, enabling users to manage tasks, projects, workspaces, and comments through natural language requests.
              Last updated -
              189
              TypeScript
              MIT License

            View all related MCP servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/mackenly/mcp-fathom-analytics'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server