ga4_get_metadata

Get GA4 Dimensions & Metrics

Ga4

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. 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. Returns: dimension_count, metric_count, and matching dimensions/metrics with api_name, ui_name, category, type (metrics), and custom flag.

Read-onlyOpen-world

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"
    }
  }
}

Parameters

NameTypeRequiredDescription
property_id string Required GA4 property ID (numeric) or full resource name.minLength: 1
reason string Required Why this tool call is neededminLength: 1, maxLength: 500
Optional parameters (1)
NameTypeRequiredDescription
search string Optional Case-insensitive substring filter on API name / UI name (e.g. 'channel', 'revenue'). Omit to list everything.

Examples

Search revenue metrics

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

hopkin ga4 metadata --property-id 123456789 --search revenue

List everything

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

hopkin ga4 metadata --property-id 123456789