ga4_run_report

Description

Run a GA4 report (Data API runReport): arbitrary dimensions × metrics over one or more date ranges, with an optional simple dimension filter and ordering. Use ga4_get_metadata first to look up valid dimension/metric API names. Args: property_id (string, required): GA4 property ID (numeric) or full resource name. dimensions (string[], optional): Up to 9 dimension API names (e.g. sessionDefaultChannelGroup, date). metrics (string[], required): 1-10 metric API names (e.g. sessions, totalUsers, keyEvents, purchaseRevenue). date_ranges (array, required): 1-4 ranges of { start_date, end_date, name? }. Dates are YYYY-MM-DD or relative (30daysAgo, yesterday, today). dimension_filter (object, optional): Single-field filter { field, values[], match_type?, case_sensitive?, negate? }. order_by (object, optional): { type: 'metric'|'dimension', name, desc? }. limit (number, optional): Max rows, default 100, max 10000. offset (number, optional): Row offset for pagination. Returns: row_count (total rows before pagination), returned_rows, and rows flattened as { dimension: value, metric: value } objects. For a single date range: metric_totals ({ metric: total }). For multiple date ranges: metric_totals_by_range ({ "date_range_0": { metric: total }, ... }) keyed by the dateRange dimension value (or the range's name).

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ga4_run_report",
    "arguments": {
      "property_id": "123456789",
      "dimensions": [
        "sessionDefaultChannelGroup"
      ],
      "metrics": [
        "sessions",
        "totalUsers",
        "keyEvents"
      ],
      "date_ranges": [
        {
          "start_date": "30daysAgo",
          "end_date": "yesterday"
        }
      ],
      "reason": "Channel mix overview for the last 30 days"
    }
  }
}

hopkin ga4 report

{
  "mcpServers": {
    "ga4": {
      "url": "https://ga4.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

Parameters

Examples

{
  "property_id": "123456789",
  "dimensions": [
    "sessionDefaultChannelGroup"
  ],
  "metrics": [
    "sessions",
    "totalUsers",
    "keyEvents"
  ],
  "date_ranges": [
    {
      "start_date": "30daysAgo",
      "end_date": "yesterday"
    }
  ],
  "reason": "Channel mix overview for the last 30 days"
}

{
  "property_id": "123456789",
  "dimensions": [
    "landingPagePlusQueryString"
  ],
  "metrics": [
    "sessions",
    "purchaseRevenue"
  ],
  "date_ranges": [
    {
      "start_date": "2024-01-01",
      "end_date": "2024-01-31"
    }
  ],
  "dimension_filter": {
    "field": "sessionDefaultChannelGroup",
    "values": [
      "Paid Search"
    ]
  },
  "order_by": {
    "type": "metric",
    "name": "purchaseRevenue"
  },
  "limit": 25,
  "reason": "Top paid-search landing pages by revenue"
}