List Report Fields

Search and browse available Google Analytics (GA4) reporting metrics and dimensions before running reports

Search and browse available Google Analytics (GA4) reporting metrics and dimensions before running reports. For complete field discovery, first call ga4_select_accounts, then provide both connection_id and one selected account/property to include property-specific custom metrics, custom dimensions, and key-event fields. Omit both only when the generic static GA4 field catalog is sufficient. Use filters to search fields by name or ID e.g [{‘field’:‘id’,‘operator’:‘REGEXP_MATCH’,‘value’:’.(sessions|pageviews).’}].

App	Google Analytics
Operation ID	ga4_list_report_fields
Type	Action
Connection	None
Credits per run	Free
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
field_type	string or SelectableOption	No	all	Filter by field type: ‘all’, ‘dimension’, or ‘metric’. Default is ‘all’.
filters	array of FilterItem	No	-	Use this to search fields by name or ID. Each filter must have a field, operator, and value. Available fields to filter by are: - ‘id’: The field ID [{“field”:“id”,“operator”:“REGEXP_MATCH”,“value”:”.(session|user).”}] - ‘name’: The field name [{“field”:“name”,“operator”:“CONTAINS”,“value”:“session”}] Filters are combined using AND logic. If you want to use OR logic, use relevant operators like REGEXP_MATCH or IN_LIST.
limit	integer	No	-	The maximum number of fields to return. Set it to avoid too many results.
account	array (also accepts a comma-separated string)	No	-	Strongly recommended for complete field discovery. Call ga4_select_accounts first, then provide exactly one selected GA4 property together with connection_id. This includes the property’s custom metrics, custom dimensions, and key-event fields. Omit both account and connection_id only when the generic static GA4 field catalog is sufficient.

FilterItem

Field	Type	Required	Default	Description
field	string or SelectableOption	Yes	-	The field to filter on, must be one of the current selected metrics or dimensions.
operator	string	Yes	-	The operator to use for filtering. Must be one of the supported values. Use REGEXP_MATCH to search/filter by multiple OR values like ’.(summer|holiday).’
value	string	Yes	-	The value to filter by, always as a string: text, a number, or a regex. For IN_LIST and NOT_IN_LIST, pass the values as one comma-separated string such as ‘a,b,c’, not as an array.

SelectableOption

Field	Type	Required	Default	Description
value	string	Yes	-
label	string	Yes	-

Output

Type: List[Dict]

Returns list of available report fields.

Fields: id, name, type, data_type