remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Allows access to Fathom Analytics data including account information, sites management, events tracking, aggregated analytics reports, and real-time visitor tracking

Análisis de Fathom de MCP

Un servidor no oficial del Protocolo de Contexto de Modelo ( MCP ) para acceder a los datos de Fathom Analytics mediante un asistente de IA. Esta implementación utiliza el SDK no oficial @mackenly/fathom-api para interactuar con la API de Fathom Analytics. No está afiliado, respaldado ni soportado por Fathom Analytics. Publicado en npm como un script npx .

Características

El servidor MCP proporciona las siguientes herramientas de Fathom Analytics:

Información de la cuenta

get-account : recupera detalles sobre tu cuenta de Fathom Analytics

Gestión de sitios

list-sites : enumera todos tus sitios de Fathom Analytics

Eventos

list-events : enumera los eventos de un sitio específico

Analítica

get-aggregation : Genere informes analíticos agregados con opciones flexibles de filtrado y agrupación

Seguimiento de visitantes

get-current-visitors : Obtenga datos en tiempo real sobre los visitantes actuales del sitio

Uso

Si usa Claude Desktop, puede agregar el servidor MCP mediante la configuración JSON ( más información ). Aquí tiene un ejemplo:

{
    "mcpServers": {
        "fathom-analytics": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-fathom-analytics"
            ],
            "env": {
                "FATHOM_API_KEY": "your_api_key_here"
            }
        }
    }
}

Puede encontrar más información sobre otros clientes MCP aquí: Modelo Contexto Protocolo Clientes de ejemplo

Estructura de la API

El servidor MCP utiliza el SDK @mackenly/fathom-api para interactuar con los puntos finales de la API de Fathom Analytics:

API de cuenta : https://api.usefathom.com/v1/account
API de sitios : https://api.usefathom.com/v1/sites
API de eventos : https://api.usefathom.com/v1/sites/SITE_ID/events
API de agregación : https://api.usefathom.com/v1/aggregations
API de visitantes actuales : https://api.usefathom.com/v1/current_visitors

Ejemplos de agregación

La herramienta de agregación es muy flexible. A continuación, se muestran algunos ejemplos de uso:

Estadísticas diarias de visitas a la página de los últimos 30 días :

{
  "entity": "pageview",
  "entity_id": "SITE_ID",
  "aggregates": "pageviews,uniques,visits",
  "date_grouping": "day",
  "date_from": "2023-08-01 00:00:00"
}

Rendimiento de páginas individuales :

{
  "entity": "pageview",
  "entity_id": "SITE_ID",
  "aggregates": "pageviews,uniques,avg_duration",
  "field_grouping": "pathname",
  "sort_by": "pageviews:desc",
  "limit": 10
}

Tráfico de países específicos :

{
  "entity": "pageview",
  "entity_id": "SITE_ID",
  "aggregates": "visits",
  "field_grouping": "country_code",
  "sort_by": "visits:desc"
}

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

Un servidor no oficial que permite a los asistentes de IA acceder a los datos de Fathom Analytics, lo que permite a los usuarios recuperar información de la cuenta, estadísticas del sitio, eventos, informes agregados y seguimiento de visitantes en tiempo real.

Related Resources

Reddit Discussion about this server

MCP Fathom Analytics