ga4_get_metadata

Description

List the dimensions and metrics available on a GA4 property (including custom definitions), so ga4_run_report calls use valid API names instead of guessing. A property can expose hundreds of dimensions and metrics combined, so results are paginated — use the search parameter to narrow down first. Args: property_id (string, required): GA4 property ID (numeric) or full resource name. search (string, optional): Case-insensitive substring filter on API name / UI name (e.g. 'channel', 'revenue'). Omit to list everything. limit (number, optional): Max dimensions+metrics per page (default 100, max 500). cursor (string, optional): Opaque pagination cursor from a previous response's top-level nextCursor. Do not construct by hand. Returns: data — dimensions and metrics combined, each tagged kind: 'dimension'|'metric', with api_name, ui_name, category, metric_type (metrics only), and custom flag. count (total matches before pagination) and nextCursor (present only when another page exists).

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ga4_get_metadata",
    "arguments": {
      "property_id": "123456789",
      "search": "revenue",
      "reason": "Find valid revenue metric API names"
    }
  }
}

hopkin ga4 metadata

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

Parameters

Examples

{
  "property_id": "123456789",
  "search": "revenue",
  "reason": "Find valid revenue metric API names"
}

{
  "property_id": "123456789",
  "reason": "Full dimension/metric inventory including custom definitions"
}