get-aggregation

get-aggregation

Retrieve aggregated analytics data from Fathom for specified entities, date ranges, and filters. Group, sort, and analyze metrics like visits, pageviews, and conversions to gain actionable insights.

Instructions

Get aggregated analytics data from Fathom

Input Schema

Name	Required	Description
`aggregates`	Yes	Comma-separated list of aggregates to include (visits,uniques,pageviews,avg_duration,bounce_rate,conversions,unique_conversions,value)
`date_from`	Yes	Start date (e.g., 2025-01-01 00:00:00 or 2025-01-01)
`date_grouping`	No	Optional date grouping
`date_to`	Yes	End date (e.g., 2025-12-31 23:59:59 or 2025-12-31)
`entity`	Yes	The entity to aggregate (pageview or event)
`entity_id`	Yes	ID of the entity (site ID or event ID)
`field_grouping`	No	Comma-separated fields to group by (e.g., hostname,pathname)
`filters`	No	Array of filter objects
`limit`	No	Limit on number of results
`sort_by`	No	Field to sort by (e.g., pageviews:desc)
`timezone`	No	Timezone for date calculations (default: UTC)

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "aggregates": {
      "description": "Comma-separated list of aggregates to include (visits,uniques,pageviews,avg_duration,bounce_rate,conversions,unique_conversions,value)",
      "type": "string"
    },
    "date_from": {
      "description": "Start date (e.g., 2025-01-01 00:00:00 or 2025-01-01)",
      "type": "string"
    },
    "date_grouping": {
      "description": "Optional date grouping",
      "enum": [
        "hour",
        "day",
        "month",
        "year"
      ],
      "type": "string"
    },
    "date_to": {
      "description": "End date (e.g., 2025-12-31 23:59:59 or 2025-12-31)",
      "type": "string"
    },
    "entity": {
      "description": "The entity to aggregate (pageview or event)",
      "enum": [
        "pageview",
        "event"
      ],
      "type": "string"
    },
    "entity_id": {
      "description": "ID of the entity (site ID or event ID)",
      "type": "string"
    },
    "field_grouping": {
      "description": "Comma-separated fields to group by (e.g., hostname,pathname)",
      "type": "string"
    },
    "filters": {
      "description": "Array of filter objects",
      "items": {
        "additionalProperties": false,
        "properties": {
          "operator": {
            "enum": [
              "is",
              "is not",
              "is like",
              "is not like"
            ],
            "type": "string"
          },
          "property": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        },
        "required": [
          "property",
          "operator",
          "value"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "limit": {
      "description": "Limit on number of results",
      "exclusiveMinimum": 0,
      "type": "number"
    },
    "sort_by": {
      "description": "Field to sort by (e.g., pageviews:desc)",
      "type": "string"
    },
    "timezone": {
      "description": "Timezone for date calculations (default: UTC)",
      "type": "string"
    }
  },
  "required": [
    "entity",
    "entity_id",
    "aggregates",
    "date_from",
    "date_to"
  ],
  "type": "object"
}

MCP Fathom Analytics

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from MCP Fathom Analytics

Related Tools