Skip to main content
Glama
MCP Fathom Analytics

MCP Fathom Analytics

by mackenly

MCP ファゾムアナリティクス

AIアシスタントを介してFathom Analyticsデータにアクセスするための非公式モデルコンテキストプロトコル( MCP )サーバーです。この実装では、@mackenly/fathom-api非公式SDKを使用してFathom Analytics APIと連携します。Fathom Analyticsと提携、承認、またはサポート関係にはありません。npxスクリプトとしてnpmに公開されています。

特徴

MCP サーバーは、次の Fathom Analytics ツールを提供します。

アカウント情報

  • get-account : Fathom Analytics アカウントの詳細を取得します

サイト管理

  • list-sites : Fathom Analytics のすべてのサイトを一覧表示します

イベント

  • list-events : 特定のサイトのイベントを一覧表示する

分析

  • get-aggregation : 柔軟なフィルタリングとグループ化のオプションを使用して集計分析レポートを生成します

訪問者追跡

  • get-current-visitors : 現在のサイト訪問者に関するリアルタイムデータを取得する

Related MCP server: @datafast/mcp-server

使用法

Claude Desktop をお使いの場合は、json 設定を使って MCP サーバーを追加できます(詳細はこちら)。以下に例を示します。

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

他のMCPクライアントの詳細については、こちらをご覧ください:モデルコンテキストプロトコルのサンプルクライアント

API構造

MCP サーバーは、@mackenly/fathom-api SDK を使用して Fathom Analytics API エンドポイントとインターフェースします。

  1. アカウント API : https://api.usefathom.com/v1/account

  2. サイト API : https://api.usefathom.com/v1/sites

  3. イベント API : https://api.usefathom.com/v1/sites/SITE_ID/events

  4. 集計 API : https://api.usefathom.com/v1/aggregations

  5. 現在の訪問者 API : https://api.usefathom.com/v1/current_visitors

集計の例

集計ツールは非常に柔軟性が高いです。以下に使用例をいくつかご紹介します。

  1. 過去 30 日間の毎日のページビュー統計:

{
  "entity": "pageview",
  "entity_id": "SITE_ID",
  "aggregates": "pageviews,uniques,visits",
  "date_grouping": "day",
  "date_from": "2023-08-01 00:00:00"
}
  1. 個々のページのパフォーマンス:

{
  "entity": "pageview",
  "entity_id": "SITE_ID",
  "aggregates": "pageviews,uniques,avg_duration",
  "field_grouping": "pathname",
  "sort_by": "pageviews:desc",
  "limit": 10
}
  1. 特定の国からのトラフィック:

{
  "entity": "pageview",
  "entity_id": "SITE_ID",
  "aggregates": "visits",
  "field_grouping": "country_code",
  "sort_by": "visits:desc"
}

貢献

貢献を歓迎します!お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

Available Tools

5 tools
get-accountB

Get Fathom Analytics account information

Inputs: no named parameters.

get-aggregationC

Get aggregated analytics data from Fathom

Inputs: entity (required), entity_id (required), aggregates (required), date_from (required), +7 more.

get-current-visitorsC

Get current visitors for a Fathom Analytics site

Inputs: site_id (required), detailed.

list-eventsB

List all events for a Fathom Analytics site (automatically handles pagination)

Inputs: site_id (required), limit.

list-sitesC

List all Fathom Analytics sites on the account

Inputs: limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting different resources: account info, aggregated data, current visitors, events, and sites. There is no overlap in functionality, making it easy for an agent to select the right tool without confusion.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using hyphen-separated lowercase words (e.g., get-account, list-sites). The naming is predictable and uniform across all tools, enhancing readability and usability.

    Tool Count5/5

    With 5 tools, the server is well-scoped for analytics purposes, covering key operations like retrieving account details, aggregated data, real-time visitors, events, and sites. Each tool earns its place without being overly sparse or bloated.

    Completeness4/5

    The tool set provides comprehensive read-only coverage for analytics data, including account, sites, events, and current visitors. A minor gap exists in write operations (e.g., creating or updating sites/events), but agents can still perform most common analytics tasks effectively.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables AI assistants to query privacy-first web analytics from Measure.events, including pageviews, top pages, referrers, and custom event tracking, all via natural language.
      6
      2
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Exposes DataFast analytics as tools for AI assistants, enabling natural language queries about website metrics such as visitors, referrers, revenue, and real-time data.
      22
      1
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Connects AI assistants to the Fathom meeting recording API to retrieve meeting summaries, transcripts, and action items.
      -
    • A
      license
      A
      quality
      F
      maintenance
      Unofficial MCP server that lets AI agents query Aptabase analytics using cookie-authenticated dashboard endpoints, providing tools for metrics, events, and sessions.
      17
      1
      MIT