MCP Fathom Analytics
MCP Fathom 分析
一个非官方的模型上下文协议 ( MCP ) 服务器,用于通过 AI 助手访问Fathom Analytics数据。此实现使用@mackenly/fathom-api非官方 SDK 与 Fathom Analytics API 进行交互。Fathom Analytics 与此无关,亦未获得其认可或支持。已作为 npx script 发布到 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"
}贡献
欢迎贡献代码!欢迎提交 Pull 请求。
执照
该项目根据 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