MCP Fathom Analytics
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 エンドポイントとインターフェースします。
アカウント API :
https://api.usefathom.com/v1/accountサイト API :
https://api.usefathom.com/v1/sitesイベント API :
https://api.usefathom.com/v1/sites/SITE_ID/events集計 API :
https://api.usefathom.com/v1/aggregations現在の訪問者 API :
https://api.usefathom.com/v1/current_visitors
集計の例
集計ツールは非常に柔軟性が高いです。以下に使用例をいくつかご紹介します。
過去 30 日間の毎日のページビュー統計:
{
"entity": "pageview",
"entity_id": "SITE_ID",
"aggregates": "pageviews,uniques,visits",
"date_grouping": "day",
"date_from": "2023-08-01 00:00:00"
}個々のページのパフォーマンス:
{
"entity": "pageview",
"entity_id": "SITE_ID",
"aggregates": "pageviews,uniques,avg_duration",
"field_grouping": "pathname",
"sort_by": "pageviews:desc",
"limit": 10
}特定の国からのトラフィック:
{
"entity": "pageview",
"entity_id": "SITE_ID",
"aggregates": "visits",
"field_grouping": "country_code",
"sort_by": "visits:desc"
}貢献
貢献を歓迎します!お気軽にプルリクエストを送信してください。
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。
Available Tools
5 toolsget-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
Scored across 5 tools
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.
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.
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.
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
Related MCP Connectors
Privacy-first, cookie-free web analytics. Read stats and manage sites from your AI.
AI access to Hitsteps analytics, live visitors, uptime, goals, alerts, and chats.
Ask an assistant about your website traffic. Privacy-first web analytics, no cookies. OAuth.
Privacy-first web analytics. Query pageviews, referrers, trends, and AI insights.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables AI assistants to query privacy-first web analytics from Measure.events, including pageviews, top pages, referrers, and custom event tracking, all via natural language.62MIT
- AlicenseAqualityDmaintenanceExposes DataFast analytics as tools for AI assistants, enabling natural language queries about website metrics such as visitors, referrers, revenue, and real-time data.221MIT
- FlicenseNot gradedqualityDmaintenanceConnects AI assistants to the Fathom meeting recording API to retrieve meeting summaries, transcripts, and action items.-
- AlicenseAqualityFmaintenanceUnofficial MCP server that lets AI agents query Aptabase analytics using cookie-authenticated dashboard endpoints, providing tools for metrics, events, and sessions.171MIT