MCP Fathom Analytics
Аналитика MCP Fathom
Неофициальный сервер Model Context Protocol ( MCP ) для доступа к данным Fathom Analytics через помощника на основе искусственного интеллекта. Эта реализация использует неофициальный SDK @mackenly/fathom-api для взаимодействия с API Fathom Analytics. Не аффилирован, не одобрен и не поддерживается Fathom Analytics. Опубликовано в npm как скрипт npx .
Функции
Сервер 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, вы можете добавить сервер MCP с помощью конфигурации json ( подробнее ). Вот пример:
{
"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 для взаимодействия с конечными точками API Fathom Analytics:
API аккаунта :
https://api.usefathom.com/v1/accountAPI сайтов :
https://api.usefathom.com/v1/sitesAPI событий :
https://api.usefathom.com/v1/sites/SITE_ID/eventsAPI агрегации :
https://api.usefathom.com/v1/aggregationsAPI текущих посетителей :
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