MCP Fathom Analytics

MCP Fathom Analytics

Unofficial MCP server for AI-powered access to Fathom Analytics data.

2
Stars
5
Forks
2
Watchers
0
Issues
MCP Fathom Analytics provides an unofficial Model Context Protocol (MCP) server that enables AI assistants to access and interact with Fathom Analytics data. It integrates with the Fathom Analytics API via the @mackenly/fathom-api SDK, offering tools to retrieve account details, manage sites, list events, generate analytics reports, and access real-time visitor data. Designed for use in AI model workflows, it allows secure and flexible analytics integration and supports configuration for clients such as Claude Desktop.

Key Features

Retrieve Fathom Analytics account details
List and manage analytics sites
Access site-specific event data
Generate flexible analytics aggregation reports
Monitor real-time site visitors
Supports secure API key-based authentication
Easy npx installation and CLI usage
Configuration for MCP-compatible clients
Integration with Fathom Analytics API endpoints
Unofficial implementation with MIT License

Use Cases

Access Fathom Analytics data through AI assistants
Automate reporting and aggregation of website analytics
Monitor live visitor statistics for web properties
Analyze event trends and user interactions on tracked sites
Integrate Fathom Analytics insights into AI-powered dashboards
Enable third-party AI clients to interact with web analytics data
Support security-aware analytics access in managed environments
Aggregate and group analytics data for deeper insights
Programmatically retrieve site and account overviews for reporting
Facilitate flexible data exploration for marketing and product teams

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.

smithery badge

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:

json
{
    "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:
json
{
  "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:
json
{
  "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:
json
{
  "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.

Star History

Star History Chart

Repository Owner

mackenly
mackenly

User

Repository Details

Language TypeScript
Default Branch main
Size 35 KB
Contributors 4
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

TypeScript
93.35%
Dockerfile
4.53%
JavaScript
2.12%

Tags

Topics

fathom-analytics mcp mcp-server

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Authenticator App MCP Server

    Authenticator App MCP Server

    Secure MCP server for AI-assisted access to 2FA codes and passwords.

    Authenticator App MCP Server provides a secure Model Context Protocol (MCP) server enabling AI agents to interact with authentication credentials, such as 2FA codes and passwords. It facilitates automated login processes for AI assistants while maintaining robust security by requiring access tokens and integrating with the Authenticator App desktop client. This solution streamlines the management of user credentials across multiple platforms and websites, ensuring seamless and secure credential retrieval by AI agents.

    • 27
    • MCP
    • firstorderai/authenticator_mcp
  • Meta Ads MCP

    Meta Ads MCP

    AI-powered Meta Ads campaign analysis and management via MCP

    Meta Ads MCP is a Model Context Protocol (MCP) server for managing, analyzing, and optimizing Meta advertising campaigns. It enables AI interfaces, such as LLMs, to retrieve ad performance data, visualize creatives, and provide strategic insights across Facebook, Instagram, and related platforms. The solution supports integration with platforms like Claude and Cursor, leveraging Meta's public APIs to deliver actionable insights and campaign management capabilities. Authentication options include interactive login and token-based flows for various MCP clients.

    • 342
    • MCP
    • pipeboard-co/meta-ads-mcp
  • searchcraft-mcp-server

    searchcraft-mcp-server

    An MCP Server for managing Searchcraft clusters and powering AI-driven search administration.

    searchcraft-mcp-server is a TypeScript/Node.js server that implements the Model Context Protocol (MCP) for Searchcraft clusters. It provides a suite of programmable tools for managing indexes, documents, federations, access keys, and analytics using plain English prompts via AI model clients. The server enables seamless interaction between AI interfaces like Claude Desktop and Searchcraft's administrative functions by exposing these operations as protocol-driven actions.

    • 6
    • MCP
    • searchcraft-inc/searchcraft-mcp-server
  • Model Context Protocol Server for Home Assistant

    Model Context Protocol Server for Home Assistant

    Seamlessly connect Home Assistant to LLMs for natural language smart home control via MCP.

    Enables integration between a local Home Assistant instance and language models using the Model Context Protocol (MCP). Facilitates natural language monitoring and control of smart home devices, with robust API support for state management, automation, real-time updates, and system administration. Features secure, token-based access, and supports mobile and HTTP clients. Designed to bridge Home Assistant environments with modern AI-driven automation.

    • 468
    • MCP
    • tevonsb/homeassistant-mcp
  • Mifos MCP - Model Context Protocol (MCP)

    Mifos MCP - Model Context Protocol (MCP)

    Enabling AI agents to access and operate on financial data in the Mifos X ecosystem using Model Context Protocol.

    Mifos MCP provides a Model Context Protocol (MCP) interface tailored for the Mifos X ecosystem, empowering AI agents to interact with financial data and perform operations within the platform. It offers a Java (Quarkus) implementation, with easy configurability via environment variables and native executable support. Developers can test and debug deployments with the MCP Inspector, and detailed instructions ensure smooth setup and integration. Comprehensive examples demonstrate practical banking and financial automation workflows.

    • 17
    • MCP
    • openMF/mcp-mifosx
  • VictoriaMetrics MCP Server

    VictoriaMetrics MCP Server

    Model Context Protocol server enabling advanced monitoring and observability for VictoriaMetrics.

    VictoriaMetrics MCP Server implements the Model Context Protocol (MCP) to provide seamless integration with VictoriaMetrics, allowing advanced monitoring, data exploration, and observability. It offers access to almost all read-only APIs, as well as embedded documentation for offline usage. The server facilitates comprehensive metric querying, cardinality analysis, alert and rule testing, and automation capabilities for engineers and tools.

    • 87
    • MCP
    • VictoriaMetrics-Community/mcp-victoriametrics
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results