Skip to main content
Glama
MCP Fathom Analytics

MCP Fathom Analytics

by mackenly

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 엔드포인트와 인터페이스합니다.

  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 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

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