MCP Fathom Analytics
MCP Fathom 분석
AI 어시스턴트를 통해 Fathom Analytics 데이터에 액세스하기 위한 비공식 모델 컨텍스트 프로토콜( MCP ) 서버입니다. 이 구현은 Fathom Analytics API와 상호 작용하기 위해 @mackenly/fathom-api 비공식 SDK를 사용합니다. 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 서버를 추가할 수 있습니다( 자세한 내용은 여기를 참조하세요 ). 다음은 예시입니다.
지엑스피1
다른 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 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
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