HYPD for Google Analytics: GA4 reporting for the user's connected properties — traffic, engagement, conversions, e-commerce, attribution, funnels, and realtime activity. Call `init` at the start of a new conversation and follow the guide it returns — the recommended workflow (list properties, check the schema, run reports) and the reporting conventions. All data comes from the user's own connected Google account: when ga4_list_account_summaries returns no properties, tell the user to reconnect the Google Analytics connector from their MCP client's connector settings — its connect step links a Google account and picks properties — instead of guessing. Report tool errors as errors — never invent metrics a tool did not return.
Discoverability
2 pass · 1 partial2 passed · 1 partial42/100
Client listings and public setup information.
mcp.json or server-card.json
Either mcp.json or an MCP Server Card declaring this endpoint passes.
The MCP Server Card declares this server's exact endpoint.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description95/100
Returns the GA4 guide for this server — call it first in a new conversation. Covers what each ga4_* tool reads, the recommended workflow (list properties, verify the schema, run reports), the property_id and date conventions, what to do when no properties are connected, and starter prompts.
The description explains the capability, when to use it, and what to expect.
Inputs100/100
This tool declares no inputs, so argument descriptions are not needed.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description97/100
The user's connected GA4 accounts with their properties — each property row carries the exact property_id ('properties/<digits>') every other ga4_* tool takes. Start here in every conversation: an empty list means the user has not connected Google Analytics yet — tell them to reconnect this connector from their MCP client's settings and complete its connect step — and plan_notice explains properties held back by the user's plan.
The description explains the capability, when to use it, and what to expect.
Inputs100/100
This tool declares no inputs, so argument descriptions are not needed.
Align the output schema with the tool’s documented result.
View output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"account_summaries"
],
"properties": {
"plan_notice": {
"type": "string",
"description": "Explains properties held back by the user's plan."
},
"account_summaries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"account": {
"type": "string",
"description": "The account id, accounts/<digits>."
},
"displayName": {
"type": "string",
"description": "The account's name."
},
"propertySummaries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"property": {
"type": "string",
"description": "The property id every report takes."
},
"displayName": {
"type": "string",
"description": "The property's name."
},
"propertyType": {
"type": "string",
"description": "e.g. PROPERTY_TYPE_ORDINARY."
}
},
"additionalProperties": {}
},
"description": "The account's GA4 properties."
}
},
"additionalProperties": {}
},
"description": "The user's selected GA4 accounts and their properties."
}
},
"additionalProperties": false
}
Original tool metadata
{
"name": "ga4_list_account_summaries",
"title": "List GA4 accounts and properties",
"description": "The user's connected GA4 accounts with their properties — each property row carries the exact property_id ('properties/<digits>') every other ga4_* tool takes. Start here in every conversation: an empty list means the user has not connected Google Analytics yet — tell them to reconnect this connector from their MCP client's settings and complete its connect step — and plan_notice explains properties held back by the user's plan.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"account_summaries"
],
"properties": {
"plan_notice": {
"type": "string",
"description": "Explains properties held back by the user's plan."
},
"account_summaries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"account": {
"type": "string",
"description": "The account id, accounts/<digits>."
},
"displayName": {
"type": "string",
"description": "The account's name."
},
"propertySummaries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"property": {
"type": "string",
"description": "The property id every report takes."
},
"displayName": {
"type": "string",
"description": "The property's name."
},
"propertyType": {
"type": "string",
"description": "e.g. PROPERTY_TYPE_ORDINARY."
}
},
"additionalProperties": {}
},
"description": "The account's GA4 properties."
}
},
"additionalProperties": {}
},
"description": "The user's selected GA4 accounts and their properties."
}
},
"additionalProperties": false
},
"annotations": {
"title": "List GA4 accounts and properties",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description81/100
One property's configuration under `object`: display name, time zone, currency, industry category, service level, and creation time. The time zone matters before any daily report — GA4 buckets days in the property's zone, not UTC.
The description explains the capability, when to use it, and what to expect.
Inputs75/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
property_id
The GA4 property, EXACTLY as a ga4_list_account_summaries row names it. Never invent or reformat one.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description89/100
The Google Ads accounts linked to one property, one row each: the Ads customer id, whether it is a manager account, and whether GA4 audiences may personalize its ads. No links means Ads campaign data cannot appear in this property's acquisition reports.
The description explains the capability, when to use it, and what to expect.
Inputs75/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
property_id
The GA4 property, EXACTLY as a ga4_list_account_summaries row names it. Never invent or reformat one.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Align the output schema with the tool’s documented result.
View output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The link id, properties/<digits>/googleAdsLinks/<id>."
},
"createTime": {
"type": "string",
"description": "When the link was created (RFC 3339)."
},
"customerId": {
"type": "string",
"description": "The linked Google Ads customer id."
},
"updateTime": {
"type": "string",
"description": "When the link last changed (RFC 3339)."
},
"canManageClients": {
"type": "boolean",
"description": "true when the Ads account is a manager account."
},
"creatorEmailAddress": {
"type": "string",
"description": "Who created the link."
},
"adsPersonalizationEnabled": {
"type": "boolean",
"description": "Whether GA4 audiences may personalize ads in Google Ads."
}
},
"description": "One Google Ads account linked to the property.",
"additionalProperties": {}
},
"description": "The links; empty when no Google Ads account is linked."
},
"guidance": {
"type": "string",
"description": "What to tell the user when nothing is connected."
},
"connected": {
"type": "boolean",
"const": false,
"description": "false when no Google Analytics connection exists — follow `guidance`; the data fields are absent."
}
},
"additionalProperties": false
}
Original tool metadata
{
"name": "ga4_list_google_ads_links",
"title": "List linked Google Ads accounts",
"description": "The Google Ads accounts linked to one property, one row each: the Ads customer id, whether it is a manager account, and whether GA4 audiences may personalize its ads. No links means Ads campaign data cannot appear in this property's acquisition reports.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"property_id"
],
"properties": {
"property_id": {
"type": "string",
"pattern": "^properties\\/\\d+$",
"description": "The GA4 property, EXACTLY as a ga4_list_account_summaries row names it. Never invent or reformat one."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The link id, properties/<digits>/googleAdsLinks/<id>."
},
"createTime": {
"type": "string",
"description": "When the link was created (RFC 3339)."
},
"customerId": {
"type": "string",
"description": "The linked Google Ads customer id."
},
"updateTime": {
"type": "string",
"description": "When the link last changed (RFC 3339)."
},
"canManageClients": {
"type": "boolean",
"description": "true when the Ads account is a manager account."
},
"creatorEmailAddress": {
"type": "string",
"description": "Who created the link."
},
"adsPersonalizationEnabled": {
"type": "boolean",
"description": "Whether GA4 audiences may personalize ads in Google Ads."
}
},
"description": "One Google Ads account linked to the property.",
"additionalProperties": {}
},
"description": "The links; empty when no Google Ads account is linked."
},
"guidance": {
"type": "string",
"description": "What to tell the user when nothing is connected."
},
"connected": {
"type": "boolean",
"const": false,
"description": "false when no Google Analytics connection exists — follow `guidance`; the data fields are absent."
}
},
"additionalProperties": false
},
"annotations": {
"title": "List linked Google Ads accounts",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description88/100
Every dimension and metric API name this property can report on, standard and custom, with descriptions. Check names here BEFORE building a report — guessing an API name is the top cause of rejected report requests.
The description explains the capability, when to use it, and what to expect.
Inputs75/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
property_id
The GA4 property, EXACTLY as a ga4_list_account_summaries row names it. Never invent or reformat one.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Annotations100/100
All four behavior hints are declared.
{
"title": "List available dimensions and metrics",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
Output schema88/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"object": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The metadata resource, properties/<digits>/metadata."
},
"metrics": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "The value type, e.g. TYPE_INTEGER or TYPE_CURRENCY."
},
"uiName": {
"type": "string",
"description": "The name the GA4 interface shows."
},
"apiName": {
"type": "string",
"description": "The name report requests use, e.g. sessionSource."
},
"category": {
"type": "string",
"description": "The group the GA4 interface files it under."
},
"expression": {
"type": "string",
"description": "The formula of a calculated metric."
},
"description": {
"type": "string",
"description": "What the field means."
},
"blockedReasons": {
"type": "array",
"items": {
"type": "string"
},
"description": "Why the user can't see it, e.g. NO_COST_METRICS."
},
"customDefinition": {
"type": "boolean",
"description": "true for a custom dimension or metric."
},
"deprecatedApiNames": {
"type": "array",
"items": {
"type": "string"
},
"description": "Older names that still work."
}
},
"description": "One metric.",
"additionalProperties": {}
},
"description": "Every metric the property can report on."
},
"dimensions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uiName": {
"type": "string",
"description": "The name the GA4 interface shows."
},
"apiName": {
"type": "string",
"description": "The name report requests use, e.g. sessionSource."
},
"category": {
"type": "string",
"description": "The group the GA4 interface files it under."
},
"description": {
"type": "string",
"description": "What the field means."
},
"customDefinition": {
"type": "boolean",
"description": "true for a custom dimension or metric."
},
"deprecatedApiNames": {
"type": "array",
"items": {
"type": "string"
},
"description": "Older names that still work."
}
},
"description": "One dimension.",
"additionalProperties": {}
},
"description": "Every dimension the property can report on."
},
"comparisons": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uiName": {
"type": "string",
"description": "The name the GA4 interface shows."
},
"apiName": {
"type": "string",
"description": "The comparison's name."
},
"description": {
"type": "string",
"description": "What it compares."
}
},
"additionalProperties": {}
},
"description": "Saved comparisons the property can use."
}
},
"description": "The property's report schema, standard and custom fields.",
"additionalProperties": {}
},
"guidance": {
"type": "string",
"description": "What to tell the user when nothing is connected."
},
"connected": {
"type": "boolean",
"const": false,
"description": "false when no Google Analytics connection exists — follow `guidance`; the data fields are absent."
}
},
"additionalProperties": false
}
Original tool metadata
{
"name": "ga4_get_metadata",
"title": "List available dimensions and metrics",
"description": "Every dimension and metric API name this property can report on, standard and custom, with descriptions. Check names here BEFORE building a report — guessing an API name is the top cause of rejected report requests.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"property_id"
],
"properties": {
"property_id": {
"type": "string",
"pattern": "^properties\\/\\d+$",
"description": "The GA4 property, EXACTLY as a ga4_list_account_summaries row names it. Never invent or reformat one."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"object": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The metadata resource, properties/<digits>/metadata."
},
"metrics": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "The value type, e.g. TYPE_INTEGER or TYPE_CURRENCY."
},
"uiName": {
"type": "string",
"description": "The name the GA4 interface shows."
},
"apiName": {
"type": "string",
"description": "The name report requests use, e.g. sessionSource."
},
"category": {
"type": "string",
"description": "The group the GA4 interface files it under."
},
"expression": {
"type": "string",
"description": "The formula of a calculated metric."
},
"description": {
"type": "string",
"description": "What the field means."
},
"blockedReasons": {
"type": "array",
"items": {
"type": "string"
},
"description": "Why the user can't see it, e.g. NO_COST_METRICS."
},
"customDefinition": {
"type": "boolean",
"description": "true for a custom dimension or metric."
},
"deprecatedApiNames": {
"type": "array",
"items": {
"type": "string"
},
"description": "Older names that still work."
}
},
"description": "One metric.",
"additionalProperties": {}
},
"description": "Every metric the property can report on."
},
"dimensions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uiName": {
"type": "string",
"description": "The name the GA4 interface shows."
},
"apiName": {
"type": "string",
"description": "The name report requests use, e.g. sessionSource."
},
"category": {
"type": "string",
"description": "The group the GA4 interface files it under."
},
"description": {
"type": "string",
"description": "What the field means."
},
"customDefinition": {
"type": "boolean",
"description": "true for a custom dimension or metric."
},
"deprecatedApiNames": {
"type": "array",
"items": {
"type": "string"
},
"description": "Older names that still work."
}
},
"description": "One dimension.",
"additionalProperties": {}
},
"description": "Every dimension the property can report on."
},
"comparisons": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uiName": {
"type": "string",
"description": "The name the GA4 interface shows."
},
"apiName": {
"type": "string",
"description": "The comparison's name."
},
"description": {
"type": "string",
"description": "What it compares."
}
},
"additionalProperties": {}
},
"description": "Saved comparisons the property can use."
}
},
"description": "The property's report schema, standard and custom fields.",
"additionalProperties": {}
},
"guidance": {
"type": "string",
"description": "What to tell the user when nothing is connected."
},
"connected": {
"type": "boolean",
"const": false,
"description": "false when no Google Analytics connection exists — follow `guidance`; the data fields are absent."
}
},
"additionalProperties": false
},
"annotations": {
"title": "List available dimensions and metrics",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description93/100
The property's registered custom dimensions and custom metrics, with scope and the event parameter each is bound to. Read this when a business-specific question needs fields the standard schema lacks.
The description explains the capability, when to use it, and what to expect.
Inputs75/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
property_id
The GA4 property, EXACTLY as a ga4_list_account_summaries row names it. Never invent or reformat one.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description86/100
Whether a dimension/metric combination can appear in one report together — GA4 forbids many pairings. Run this before a complex report instead of burning quota on a rejected request.
The description explains the capability, when to use it, and what to expect.
Inputs80/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
property_id
The GA4 property, EXACTLY as a ga4_list_account_summaries row names it. Never invent or reformat one.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
dimensions
GA4 dimension API names, e.g. date, sessionDefaultChannelGroup, pagePath — verify names with ga4_get_metadata.
Clear enough to supply this argument.
metrics
GA4 metric API names to check against the dimensions, e.g. sessions or totalRevenue. Each gets its own verdict.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
dimension_filter › filter › fieldName
The GA4 dimension or metric API name to filter on.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"object": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"description": "Google's explanation when compatible is false."
},
"compatible": {
"type": "boolean",
"const": false,
"description": "false when Google rejected the combination as a whole."
},
"metricCompatibilities": {
"type": "array",
"items": {
"type": "object",
"properties": {
"compatibility": {
"type": "string",
"description": "COMPATIBLE or INCOMPATIBLE with the rest of the request."
},
"metricMetadata": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "The value type, e.g. TYPE_INTEGER or TYPE_CURRENCY."
},
"uiName": {
"type": "string",
"description": "The name the GA4 interface shows."
},
"apiName": {
"type": "string",
"description": "The name report requests use, e.g. sessionSource."
},
"category": {
"type": "string",
"description": "The group the GA4 interface files it under."
},
"expression": {
"type": "string",
"description": "The formula of a calculated metric."
},
"description": {
"type": "string",
"description": "What the field means."
},
"blockedReasons": {
"type": "array",
"items": {
"type": "string"
},
"description": "Why the user can't see it, e.g. NO_COST_METRICS."
},
"customDefinition": {
"type": "boolean",
"description": "true for a custom dimension or metric."
},
"deprecatedApiNames": {
"type": "array",
"items": {
"type": "string"
},
"description": "Older names that still work."
}
},
"description": "One metric.",
"additionalProperties": {}
}
},
"additionalProperties": {}
},
"description": "A verdict for each metric."
},
"dimensionCompatibilities": {
"type": "array",
"items": {
"type": "object",
"properties": {
"compatibility": {
"type": "string",
"description": "COMPATIBLE or INCOMPATIBLE with the rest of the request."
},
"dimensionMetadata": {
"type": "object",
"properties": {
"uiName": {
"type": "string",
"description": "The name the GA4 interface shows."
},
"apiName": {
"type": "string",
"description": "The name report requests use, e.g. sessionSource."
},
"category": {
"type": "string",
"description": "The group the GA4 interface files it under."
},
"description": {
"type": "string",
"description": "What the field means."
},
"customDefinition": {
"type": "boolean",
"description": "true for a custom dimension or metric."
},
"deprecatedApiNames": {
"type": "array",
"items": {
"type": "string"
},
"description": "Older names that still work."
}
},
"description": "One dimension.",
"additionalProperties": {}
}
},
"additionalProperties": {}
},
"description": "A verdict for each dimension."
}
},
"description": "Which requested fields can share one report.",
"additionalProperties": {}
},
"guidance": {
"type": "string",
"description": "What to tell the user when nothing is connected."
},
"connected": {
"type": "boolean",
"const": false,
"description": "false when no Google Analytics connection exists — follow `guidance`; the data fields are absent."
}
},
"additionalProperties": false
}
Original tool metadata
{
"name": "ga4_check_compatibility",
"title": "Check report field compatibility",
"description": "Whether a dimension/metric combination can appear in one report together — GA4 forbids many pairings. Run this before a complex report instead of burning quota on a rejected request.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"property_id"
],
"properties": {
"metrics": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 10,
"description": "GA4 metric API names to check against the dimensions, e.g. sessions or totalRevenue. Each gets its own verdict."
},
"dimensions": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 9,
"description": "GA4 dimension API names, e.g. date, sessionDefaultChannelGroup, pagePath — verify names with ga4_get_metadata."
},
"property_id": {
"type": "string",
"pattern": "^properties\\/\\d+$",
"description": "The GA4 property, EXACTLY as a ga4_list_account_summaries row names it. Never invent or reformat one."
},
"metric_filter": {
"type": "object",
"properties": {
"filter": {
"type": "object",
"required": [
"fieldName"
],
"properties": {
"fieldName": {
"type": "string",
"pattern": "^[A-Za-z0-9_:.]+$",
"minLength": 1,
"description": "The GA4 dimension or metric API name to filter on."
},
"inListFilter": {
"type": "object",
"required": [
"values"
],
"properties": {
"values": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "Match when the field equals any of these values."
},
"caseSensitive": {
"type": "boolean",
"description": "Match upper and lower case exactly when true. Defaults to false."
}
}
},
"stringFilter": {
"type": "object",
"required": [
"matchType",
"value"
],
"properties": {
"value": {
"type": "string",
"description": "The text compared with the field's value, e.g. /blog/ with CONTAINS or ^/products/ with PARTIAL_REGEXP."
},
"matchType": {
"enum": [
"EXACT",
"BEGINS_WITH",
"ENDS_WITH",
"CONTAINS",
"FULL_REGEXP",
"PARTIAL_REGEXP"
],
"type": "string",
"description": "How value is matched against the field."
},
"caseSensitive": {
"type": "boolean",
"description": "Match upper and lower case exactly when true. Defaults to false."
}
}
},
"betweenFilter": {
"type": "object",
"required": [
"fromValue",
"toValue"
],
"properties": {
"toValue": {
"type": "object",
"properties": {
"int64Value": {
"type": "string",
"description": "Use for whole-number fields such as sessions, e.g. \"25\"."
},
"doubleValue": {
"type": "number",
"description": "Use for fractional fields such as engagementRate, e.g. 0.5."
}
},
"description": "Provide exactly one of int64Value or doubleValue."
},
"fromValue": {
"type": "object",
"properties": {
"int64Value": {
"type": "string",
"description": "Use for whole-number fields such as sessions, e.g. \"25\"."
},
"doubleValue": {
"type": "number",
"description": "Use for fractional fields such as engagementRate, e.g. 0.5."
}
},
"description": "Provide exactly one of int64Value or doubleValue."
}
}
},
"numericFilter": {
"type": "object",
"required": [
"operation",
"value"
],
"properties": {
"value": {
"type": "object",
"properties": {
"int64Value": {
"type": "string",
"description": "Use for whole-number fields such as sessions, e.g. \"25\"."
},
"doubleValue": {
"type": "number",
"description": "Use for fractional fields such as engagementRate, e.g. 0.5."
}
},
"description": "Provide exactly one of int64Value or doubleValue."
},
"operation": {
"enum": [
"EQUAL",
"LESS_THAN",
"LESS_THAN_OR_EQUAL",
"GREATER_THAN",
"GREATER_THAN_OR_EQUAL"
],
"type": "string",
"description": "How the field's number compares with value."
}
}
}
},
"description": "A single condition."
},
"orGroup": {
"type": "object",
"required": [
"expressions"
],
"properties": {
"expressions": {
"type": "array",
"items": {
"type": "object",
"required": [
"filter"
],
"properties": {
"filter": {
"type": "object",
"required": [
"fieldName"
],
"properties": {
"fieldName": {
"type": "string",
"pattern": "^[A-Za-z0-9_:.]+$",
"minLength": 1,
"description": "The GA4 dimension or metric API name to filter on."
},
"inListFilter": {
"type": "object",
"required": [
"values"
],
"properties": {
"values": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "Match when the field equals any of these values."
},
"caseSensitive": {
"type": "boolean",
"description": "Match upper and lower case exactly when true. Defaults to false."
}
}
},
"stringFilter": {
"type": "object",
"required": [
"matchType",
"value"
],
"properties": {
"value": {
"type": "string",
"description": "The text compared with the field's value, e.g. /blog/ with CONTAINS or ^/products/ with PARTIAL_REGEXP."
},
"matchType": {
"enum": [
"EXACT",
"BEGINS_WITH",
"ENDS_WITH",
"CONTAINS",
"FULL_REGEXP",
"PARTIAL_REGEXP"
],
"type": "string",
"description": "How value is matched against the field."
},
"caseSensitive": {
"type": "boolean",
"description": "Match upper and lower case exactly when true. Defaults to false."
}
}
},
"betweenFilter": {
"type": "object",
"required": [
"fromValue",
"toValue"
],
"properties": {
"toValue": {
"type": "object",
"properties": {
"int64Value": {
"type": "string",
"description": "Use for whole-number fields such as sessions, e.g. \"25\"."
},
"doubleValue": {
"type": "number",
"description": "Use for fractional fields such as engagementRate, e.g. 0.5."
}
},
"description": "Provide exactly one of int64Value or doubleValue."
},
"fromValue": {
"type": "object",
"properties": {
"int64Value": {
"type": "string",
"description": "Use for whole-number fields such as sessions, e.g. \"25\"."
},
"doubleValue": {
"type": "number",
"description": "Use for fractional fields such as engagementRate, e.g. 0.5."
}
},
"description": "Provide exactly one of int64Value or doubleValue."
}
}
},
"numericFilter": {
"type": "object",
"required": [
"operation",
"value"
],
"properties": {
"value": {
"type": "object",
"properties": {
"int64Value": {
"type": "string",
"description": "Use for whole-number fields such as sessions, e.g. \"25\"."
},
"doubleValue": {
"type": "number",
"description": "Use for fractional fields such as engagementRate, e.g. 0.5."
}
},
"description": "Provide exactly one of int64Value or doubleValue."
},
"operation": {
"enum": [
"EQUAL",
"LESS_THAN",
"LESS_THAN_OR_EQUAL",
"GREATER_THAN",
"GREATER_THAN_OR_EQUAL"
],
"type": "string",
"description": "How the field's number compares with value."
}
}
}
},
"description": "One condition: fieldName plus exactly one of stringFilter, inListFilter, numericFilter, or betweenFilter."
}
}
},
"minItems": 1,
"description": "The conditions to combine."
}
},
"description": "ANY of these conditions may match."
},
"andGroup": {
"type": "object",
"required": [
"expressions"
],
"properties": {
"expressions": {
"type": "array",
"items": {
"type": "object",
"required": [
"filter"
],
"properties": {
"filter": {
"type": "object",
"required": [
"fieldName"
],
"properties": {
"fieldName": {
"type": "string",
"pattern": "^[A-Za-z0-9_:.]+$",
"minLength": 1,
"description": "The GA4 dimension or metric API name to filter on."
},
"inListFilter": {
"type": "object",
"required": [
"values"
],
"properties": {
"values": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "Match when the field equals any of these values."
},
"caseSensitive": {
"type": "boolean",
"description": "Match upper and lower case exactly when true. Defaults to false."
}
}
},
"stringFilter": {
"type": "object",
"required": [
"matchType",
"value"
],
"properties": {
"value": {
"type": "string",
"description": "The text compared with the field's value, e.g. /blog/ with CONTAINS or ^/products/ with PARTIAL_REGEXP."
},
"matchType": {
"enum": [
"EXACT",
"BEGINS_WITH",
"ENDS_WITH",
"CONTAINS",
"FULL_REGEXP",
"PARTIAL_REGEXP"
],
"type": "string",
"description": "How value is matched against the field."
},
"caseSensitive": {
"type": "boolean",
"description": "Match upper and lower case exactly when true. Defaults to false."
}
}
},
"betweenFilter": {
"type": "object",
"required": [
"fromValue",
"toValue"
],
"properties": {
"toValue": {
"type": "object",
"properties": {
"int64Value": {
"type": "string",
"description": "Use for whole-number fields such as sessions, e.g. \"25\"."
},
"doubleValue": {
"type": "number",
"description": "Use for fractional fields such as engagementRate, e.g. 0.5."
}
},
"description": "Provide exactly one of int64Value or doubleValue."
},
"fromValue": {
"type": "object",
"properties": {
"int64Value": {
"type": "string",
"description": "Use for whole-number fields such as sessions, e.g. \"25\"."
},
"doubleValue": {
"type": "number",
"description": "Use for fractional fields such as engagementRate, e.g. 0.5."
}
},
"description": "Provide exactly one of int64Value or doubleValue."
}
}
},
"numericFilter": {
"type": "object",
"required": [
"operation",
"value"
],
"properties": {
"value": {
"type": "object",
"properties": {
"int64Value": {
"type": "string",
"description": "Use for whole-number fields such as sessions, e.g. \"25\"."
},
"doubleValue": {
"type": "number",
"description": "Use for fractional fields such as engagementRate, e.g. 0.5."
}
},
"description": "Provide exactly one of int64Value or doubleValue."
},
"operation": {
"enum": [
"EQUAL",
"LESS_THAN",
"LESS_THAN_OR_EQUAL",
"GREATER_THAN",
"GREATER_THAN_OR_EQUAL"
],
"type": "string",
"description": "How the field's number compares with value."
}
}
}
},
"description": "One condition: fieldName plus exactly one of stringFilter, inListFilter, numericFilter, or betweenFilter."
}
}
},
"minItems": 1,
"description": "The conditions to combine."
}
},
"description": "ALL of these conditions must match."
},
"notExpression": {
"type": "object",
"required": [
"filter"
],
"properties": {
"filter": {
"type": "object",
"required": [
"fieldName"
],
"properties": {
"fieldName": {
"type": "string",
"pattern": "^[A-Za-z0-9_:.]+$",
"minLength": 1,
"description": "The GA4 dimension or metric API name to filter on."
},
"inListFilter": {
"type": "object",
"required": [
"values"
],
"properties": {
"values": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "Match when the field equals any of these values."
},
"caseSensitive": {
"type": "boolean",
"description": "Match upper and lower case exactly when true. Defaults to false."
}
}
},
"stringFilter": {
"type": "object",
"required": [
"matchType",
"value"
],
"properties": {
"value": {
"type": "string",
"description": "The text compared with the field's value, e.g. /blog/ with CONTAINS or ^/products/ with PARTIAL_REGEXP."
},
"matchType": {
"enum": [
"EXACT",
"BEGINS_WITH",
"ENDS_WITH",
"CONTAINS",
"FULL_REGEXP",
"PARTIAL_REGEXP"
],
"type": "string",
"description": "How value is matched against the field."
},
"caseSensitive": {
"type": "boolean",
"description": "Match upper and lower case exactly when true. Defaults to false."
}
}
},
"betweenFilter": {
"type": "object",
"required": [
"fromValue",
"toValue"
],
"properties": {
"toValue": {
"type": "object",
"properties": {
"int64Value": {
"type": "string",
"description": "Use for whole-number fields such as sessions, e.g. \"25\"."
},
"doubleValue": {
"type": "number",
"description": "Use for fractional fields such as engagementRate, e.g. 0.5."
}
},
"description": "Provide exactly one of int64Value or doubleValue."
},
"fromValue": {
"type": "object",
"properties": {
"int64Value": {
"type": "string",
"description": "Use for whole-number fields such as sessions, e.g. \"25\"."
},
"doubleValue": {
"type": "number",
"description": "Use for fractional fields such as engagementRate, e.g. 0.5."
}
},
"description": "Provide exactly one of int64Value or doubleValue."
}
}
},
"numericFilter": {
"type": "object",
"required": [
"operation",
"value"
],
"properties": {
"value": {
"type": "object",
"properties": {
"int64Value": {
"type": "string",
"description": "Use for whole-number fields such as sessions, e.g. \"25\"."
},
"doubleValue": {
"type": "number",
"description": "Use for fractional fields such as engagementRate, e.g. 0.5."
}
},
"description": "Provide exactly one of int64Value or doubleValue."
},
"operation": {
"enum": [
"EQUAL",
"LESS_THAN",
"LESS_THAN_OR_EQUAL",
"GREATER_THAN",
"GREATER_THAN_OR_EQUAL"
],
"type": "string",
"description": "How the field's number compares with value."
}
}
}
},
"description": "One condition: fieldName plus exactly one of stringFilter, inListFilter, numericFilter, or betweenFilter."
}
},
"description": "The condition must NOT match."
}
},
"description": "GA4 Data API FilterExpression scoped to metrics: exactly one of filter (fieldName + numericFilter/betweenFilter), andGroup, orGroup, or notExpression. Forwarded to Google unchanged."
},
"dimension_filter": {
"type": "object",
"properties": {
"filter": {
"type": "object",
"required": [
"fieldName"
],
"properties": {
"fieldName": {
"type": "string",
"pattern": "^[A-Za-z0-9_:.]+$",
"minLength": 1,
"description": "The GA4 dimension or metric API name to filter on."
},
"inListFilter": {
"type": "object",
"required": [
"values"
],
"properties": {
"values": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "Match when the field equals any of these values."
},
"caseSensitive": {
"type": "boolean",
"description": "Match upper and lower case exactly when true. Defaults to false."
}
}
},
"stringFilter": {
"type": "object",
"required": [
"matchType",
"value"
],
"properties": {
"value": {
"type": "string",
"description": "The text compared with the field's value, e.g. /blog/ with CONTAINS or ^/products/ with PARTIAL_REGEXP."
},
"matchType": {
"enum": [
"EXACT",
"BEGINS_WITH",
"ENDS_WITH",
"CONTAINS",
"FULL_REGEXP",
"PARTIAL_REGEXP"
],
"type": "string",
"description": "How value is matched against the field."
},
"caseSensitive": {
"type": "boolean",
"description": "Match upper and lower case exactly when true. Defaults to false."
}
}
},
"betweenFilter": {
"type": "object",
"required": [
"fromValue",
"toValue"
],
"properties": {
"toValue": {
"type": "object",
"properties": {
"int64Value": {
"type": "string",
"description": "Use for whole-number fields such as sessions, e.g. \"25\"."
},
"doubleValue": {
"type": "number",
"description": "Use for fractional fields such as engagementRate, e.g. 0.5."
}
},
"description": "Provide exactly one of int64Value or doubleValue."
},
"fromValue": {
"type": "object",
"properties": {
"int64Value": {
"type": "string",
"description": "Use for whole-number fields such as sessions, e.g. \"25\"."
},
"doubleValue": {
"type": "number",
"description": "Use for fractional fields such as engagementRate, e.g. 0.5."
}
},
"description": "Provide exactly one of int64Value or doubleValue."
}
}
},
"numericFilter": {
"type": "object",
"required": [
"operation",
"value"
],
"properties": {
"value": {
"type": "object",
"properties": {
"int64Value": {
"type": "string",
"description": "Use for whole-number fields such as sessions, e.g. \"25\"."
},
"doubleValue": {
"type": "number",
"description": "Use for fractional fields such as engagementRate, e.g. 0.5."
}
},
"description": "Provide exactly one of int64Value or doubleValue."
},
"operation": {
"enum": [
"EQUAL",
"LESS_THAN",
"LESS_THAN_OR_EQUAL",
"GREATER_THAN",
"GREATER_THAN_OR_EQUAL"
],
"type": "string",
"description": "How the field's number compares with value."
}
}
}
},
"description": "A single condition."
},
"orGroup": {
"type": "object",
"required": [
"expressions"
],
"properties": {
"expressions": {
"type": "array",
"items": {
"type": "object",
"required": [
"filter"
],
"properties": {
"filter": {
"type": "object",
"required": [
"fieldName"
],
"properties": {
"fieldName": {
"type": "string",
"pattern": "^[A-Za-z0-9_:.]+$",
"minLength": 1,
"description": "The GA4 dimension or metric API name to filter on."
},
"inListFilter": {
"type": "object",
"required": [
"values"
],
"properties": {
"values": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "Match when the field equals any of these values."
},
"caseSensitive": {
"type": "boolean",
"description": "Match upper and lower case exactly when true. Defaults to false."
}
}
},
"stringFilter": {
"type": "object",
"required": [
"matchType",
"value"
],
"properties": {
"value": {
"type": "string",
"description": "The text compared with the field's value, e.g. /blog/ with CONTAINS or ^/products/ with PARTIAL_REGEXP."
},
"matchType": {
"enum": [
"EXACT",
"BEGINS_WITH",
"ENDS_WITH",
"CONTAINS",
"FULL_REGEXP",
"PARTIAL_REGEXP"
],
"type": "string",
"description": "How value is matched against the field."
},
"caseSensitive": {
"type": "boolean",
"description": "Match upper and lower case exactly when true. Defaults to false."
}
}
},
"betweenFilter": {
"type": "object",
"required": [
"fromValue",
"toValue"
],
"properties": {
"toValue": {
"type": "object",
"properties": {
"int64Value": {
"type": "string",
"description": "Use for whole-number fields such as sessions, e.g. \"25\"."
},
"doubleValue": {
"type": "number",
"description": "Use for fractional fields such as engagementRate, e.g. 0.5."
}
},
"description": "Provide exactly one of int64Value or doubleValue."
},
"fromValue": {
"type": "object",
"properties": {
"int64Value": {
"type": "string",
"description": "Use for whole-number fields such as sessions, e.g. \"25\"."
},
"doubleValue": {
"type": "number",
"description": "Use for fractional fields such as engagementRate, e.g. 0.5."
}
},
"description": "Provide exactly one of int64Value or doubleValue."
}
}
},
"numericFilter": {
"type": "object",
"required": [
"operation",
"value"
],
"properties": {
"value": {
"type": "object",
"properties": {
"int64Value": {
"type": "string",
"description": "Use for whole-number fields such as sessions, e.g. \"25\"."
},
"doubleValue": {
"type": "number",
"description": "Use for fractional fields such as engagementRate, e.g. 0.5."
}
},
"description": "Provide exactly one of int64Value or doubleValue."
},
"operation": {
"enum": [
"EQUAL",
"LESS_THAN",
"LESS_THAN_OR_EQUAL",
"GREATER_THAN",
"GREATER_THAN_OR_EQUAL"
],
"type": "string",
"description": "How the field's number compares with value."
}
}
}
},
"description": "One condition: fieldName plus exactly one of stringFilter, inListFilter, numericFilter, or betweenFilter."
}
}
},
"minItems": 1,
"description": "The conditions to combine."
}
},
"description": "ANY of these conditions may match."
},
"andGroup": {
"type": "object",
"required": [
"expressions"
],
"properties": {
"expressions": {
"type": "array",
"items": {
"type": "object",
"required": [
"filter"
],
"properties": {
"filter": {
"type": "object",
"required": [
"fieldName"
],
"properties": {
"fieldName": {
"type": "string",
"pattern": "^[A-Za-z0-9_:.]+$",
"minLength": 1,
"description": "The GA4 dimension or metric API name to filter on."
},
"inListFilter": {
"type": "object",
"required": [
"values"
],
"properties": {
"values": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "Match when the field equals any of these values."
},
"caseSensitive": {
"type": "boolean",
"description": "Match upper and lower case exactly when true. Defaults to false."
}
}
},
"stringFilter": {
"type": "object",
"required": [
"matchType",
"value"
],
"properties": {
"value": {
"type": "string",
"description": "The text compared with the field's value, e.g. /blog/ with CONTAINS or ^/products/ with PARTIAL_REGEXP."
},
"matchType": {
"enum": [
"EXACT",
"BEGINS_WITH",
"ENDS_WITH",
"CONTAINS",
"FULL_REGEXP",
"PARTIAL_REGEXP"
],
"type": "string",
"description": "How value is matched against the field."
},
"caseSensitive": {
"type": "boolean",
"description": "Match upper and lower case exactly when true. Defaults to false."
}
}
},
"betweenFilter": {
"type": "object",
"required": [
"fromValue",
"toValue"
],
"properties": {
"toValue": {
"type": "object",
"properties": {
"int64Value": {
"type": "string",
"description": "Use for whole-number fields such as sessions, e.g. \"25\"."
},
"doubleValue": {
"type": "number",
"description": "Use for fractional fields such as engagementRate, e.g. 0.5."
}
},
"description": "Provide exactly one of int64Value or doubleValue."
},
"fromValue": {
"type": "object",
"properties": {
"int64Value": {
"type": "string",
"description": "Use for whole-number fields such as sessions, e.g. \"25\"."
},
"doubleValue": {
"type": "number",
"description": "Use for fractional fields such as engagementRate, e.g. 0.5."
}
},
"description": "Provide exactly one of int64Value or doubleValue."
}
}
},
"numericFilter": {
"type": "object",
"required": [
"operation",
"value"
],
"properties": {
"value": {
"type": "object",
"properties": {
"int64Value": {
"type": "string",
"description": "Use for whole-number fields such as sessions, e.g. \"25\"."
},
"doubleValue": {
"type": "number",
"description": "Use for fractional fields such as engagementRate, e.g. 0.5."
}
},
"description": "Provide exactly one of int64Value or doubleValue."
},
"operation": {
"enum": [
"EQUAL",
"LESS_THAN",
"LESS_THAN_OR_EQUAL",
"GREATER_THAN",
"GREATER_THAN_OR_EQUAL"
],
"type": "string",
"description": "How the field's number compares with value."
}
}
}
},
"description": "One condition: fieldName plus exactly one of stringFilter, inListFilter, numericFilter, or betweenFilter."
}
}
},
"minItems": 1,
"description": "The conditions to combine."
}
},
"description": "ALL of these conditions must match."
},
"notExpression": {
"type": "object",
"required": [
"filter"
],
"properties": {
"filter": {
"type": "object",
"required": [
"fieldName"
],
"properties": {
"fieldName": {
"type": "string",
"pattern": "^[A-Za-z0-9_:.]+$",
"minLength": 1,
"description": "The GA4 dimension or metric API name to filter on."
},
"inListFilter": {
"type": "object",
"required": [
"values"
],
"properties": {
"values": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "Match when the field equals any of these values."
},
"caseSensitive": {
"type": "boolean",
"description": "Match upper and lower case exactly when true. Defaults to false."
}
}
},
"stringFilter": {
"type": "object",
"required": [
"matchType",
"value"
],
"properties": {
"value": {
"type": "string",
"description": "The text compared with the field's value, e.g. /blog/ with CONTAINS or ^/products/ with PARTIAL_REGEXP."
},
"matchType": {
"enum": [
"EXACT",
"BEGINS_WITH",
"ENDS_WITH",
"CONTAINS",
"FULL_REGEXP",
"PARTIAL_REGEXP"
],
"type": "string",
"description": "How value is matched against the field."
},
"caseSensitive": {
"type": "boolean",
"description": "Match upper and lower case exactly when true. Defaults to false."
}
}
},
"betweenFilter": {
"type": "object",
"required": [
"fromValue",
"toValue"
],
"properties": {
"toValue": {
"type": "object",
"properties": {
"int64Value": {
"type": "string",
"description": "Use for whole-number fields such as sessions, e.g. \"25\"."
},
"doubleValue": {
"type": "number",
"description": "Use for fractional fields such as engagementRate, e.g. 0.5."
}
},
"description": "Provide exactly one of int64Value or doubleValue."
},
"fromValue": {
"type": "object",
"properties": {
"int64Value": {
"type": "string",
"description": "Use for whole-number fields such as sessions, e.g. \"25\"."
},
"doubleValue": {
"type": "number",
"description": "Use for fractional fields such as engagementRate, e.g. 0.5."
}
},
"description": "Provide exactly one of int64Value or doubleValue."
}
}
},
"numericFilter": {
"type": "object",
"required": [
"operation",
"value"
],
"properties": {
"value": {
"type": "object",
"properties": {
"int64Value": {
"type": "string",
"description": "Use for whole-number fields such as sessions, e.g. \"25\"."
},
"doubleValue": {
"type": "number",
"description": "Use for fractional fields such as engagementRate, e.g. 0.5."
}
},
"description": "Provide exactly one of int64Value or doubleValue."
},
"operation": {
"enum": [
"EQUAL",
"LESS_THAN",
"LESS_THAN_OR_EQUAL",
"GREATER_THAN",
"GREATER_THAN_OR_EQUAL"
],
"type": "string",
"description": "How the field's number compares with value."
}
}
}
},
"description": "One condition: fieldName plus exactly one of stringFilter, inListFilter, numericFilter, or betweenFilter."
}
},
"description": "The condition must NOT match."
}
},
"description": "GA4 Data API FilterExpression scoped to dimensions: exactly one of filter (fieldName + stringFilter/inListFilter), andGroup, orGroup, or notExpression. Forwarded to Google unchanged."
},
"compatibility_filter": {
"enum": [
"COMPATIBLE",
"INCOMPATIBLE"
],
"type": "string",
"description": "Restrict the response to one verdict."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"object": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"description": "Google's explanation when compatible is false."
},
"compatible": {
"type": "boolean",
"const": false,
"description": "false when Google rejected the combination as a whole."
},
"metricCompatibilities": {
"type": "array",
"items": {
"type": "object",
"properties": {
"compatibility": {
"type": "string",
"description": "COMPATIBLE or INCOMPATIBLE with the rest of the request."
},
"metricMetadata": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "The value type, e.g. TYPE_INTEGER or TYPE_CURRENCY."
},
"uiName": {
"type": "string",
"description": "The name the GA4 interface shows."
},
"apiName": {
"type": "string",
"description": "The name report requests use, e.g. sessionSource."
},
"category": {
"type": "string",
"description": "The group the GA4 interface files it under."
},
"expression": {
"type": "string",
"description": "The formula of a calculated metric."
},
"description": {
"type": "string",
"description": "What the field means."
},
"blockedReasons": {
"type": "array",
"items": {
"type": "string"
},
"description": "Why the user can't see it, e.g. NO_COST_METRICS."
},
"customDefinition": {
"type": "boolean",
"description": "true for a custom dimension or metric."
},
"deprecatedApiNames": {
"type": "array",
"items": {
"type": "string"
},
"description": "Older names that still work."
}
},
"description": "One metric.",
"additionalProperties": {}
}
},
"additionalProperties": {}
},
"description": "A verdict for each metric."
},
"dimensionCompatibilities": {
"type": "array",
"items": {
"type": "object",
"properties": {
"compatibility": {
"type": "string",
"description": "COMPATIBLE or INCOMPATIBLE with the rest of the request."
},
"dimensionMetadata": {
"type": "object",
"properties": {
"uiName": {
"type": "string",
"description": "The name the GA4 interface shows."
},
"apiName": {
"type": "string",
"description": "The name report requests use, e.g. sessionSource."
},
"category": {
"type": "string",
"description": "The group the GA4 interface files it under."
},
"description": {
"type": "string",
"description": "What the field means."
},
"customDefinition": {
"type": "boolean",
"description": "true for a custom dimension or metric."
},
"deprecatedApiNames": {
"type": "array",
"items": {
"type": "string"
},
"description": "Older names that still work."
}
},
"description": "One dimension.",
"additionalProperties": {}
}
},
"additionalProperties": {}
},
"description": "A verdict for each dimension."
}
},
"description": "Which requested fields can share one report.",
"additionalProperties": {}
},
"guidance": {
"type": "string",
"description": "What to tell the user when nothing is connected."
},
"connected": {
"type": "boolean",
"const": false,
"description": "false when no Google Analytics connection exists — follow `guidance`; the data fields are absent."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Check report field compatibility",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description98/100
Runs a one-row GA4 report request and returns its unpaged row_count and property_quota, without returning report rows. This preflight consumes Data API quota. Use it to size a high-cardinality report (e.g. pagePath by date) before fetching the full report.
The description explains the capability, when to use it, and what to expect.
Inputs85/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
property_id
The GA4 property, EXACTLY as a ga4_list_account_summaries row names it. Never invent or reformat one.
Clear enough to supply this argument.
date_ranges › items › start_date
First day of the range, in the property's time zone.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
date_ranges › items › end_date
Last day of the range, included, in the property's time zone.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
date_ranges › items › name
Optional label echoed on the range's rows.
Clear enough to supply this argument.
metrics
GA4 metric API names, e.g. sessions, totalUsers, conversions, totalRevenue — verify names with ga4_get_metadata.
Clear enough to supply this argument.
dimensions
GA4 dimension API names, e.g. date, sessionDefaultChannelGroup, pagePath — verify names with ga4_get_metadata.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
dimension_filter › filter › fieldName
The GA4 dimension or metric API name to filter on.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description97/100
The general GA4 report: any dimensions and metrics over 1-4 date ranges, with Google's filter, ordering, and pagination objects passed through verbatim. The workhorse for custom questions — reach for the preset ga4_get_* tools first when one fits. Returns snake_case top-level report fields: rows are records keyed by GA4 dimension and metric API names, with values returned as strings; row_count is the unpaged total, and totals is populated only when Google returns aggregates.
The description explains the capability, when to use it, and what to expect.
Inputs86/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
property_id
The GA4 property, EXACTLY as a ga4_list_account_summaries row names it. Never invent or reformat one.
Clear enough to supply this argument.
date_ranges › items › start_date
First day of the range, in the property's time zone.
Clear enough to supply this argument.
date_ranges › items › end_date
Last day of the range, included, in the property's time zone.
Clear enough to supply this argument.
date_ranges › items › name
Optional label echoed on the range's rows.
Clear enough to supply this argument.
metrics
GA4 metric API names, e.g. sessions, totalUsers, conversions, totalRevenue — verify names with ga4_get_metadata.
Clear enough to supply this argument.
dimensions
GA4 dimension API names, e.g. date, sessionDefaultChannelGroup, pagePath — verify names with ga4_get_metadata.
Clear enough to supply this argument.
dimension_filter › filter › fieldName
The GA4 dimension or metric API name to filter on.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description93/100
Recent property activity: active users and events over the last 30 minutes by default, or the supplied minute_ranges. Realtime accepts its own smaller set of dimensions and metrics, at most 4 dimensions and no date ranges. Standard report metrics such as sessions and totalRevenue are not valid here. Returns snake_case top-level report fields: rows are records keyed by GA4 dimension and metric API names, with values returned as strings; row_count is the unpaged total, and totals is populated only when Google returns aggregates.
The description explains the capability, when to use it, and what to expect.
Inputs85/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
property_id
The GA4 property, EXACTLY as a ga4_list_account_summaries row names it. Never invent or reformat one.
Clear enough to supply this argument.
metrics
Realtime-capable GA4 metric API names, e.g. activeUsers, screenPageViews, eventCount, keyEvents. The realtime field set differs from standard reports.
Clear enough to supply this argument.
dimensions
Realtime-capable GA4 dimension API names, e.g. unifiedScreenName, country, deviceCategory.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
minute_ranges › items › startMinutesAgo
Range start, minutes before now (0 = now).
Clear enough to supply this argument.
minute_ranges › items › endMinutesAgo
Where the range ends, in minutes before now. 0, Google's default, ends at the current minute.
Clear enough to supply this argument.
minute_ranges › items › name
Optional label echoed on the range's rows.
Clear enough to supply this argument.
dimension_filter › filter › fieldName
The GA4 dimension or metric API name to filter on.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description88/100
Step-by-step funnel analysis: how many users complete and abandon each step of a journey you define (e.g. view item → add to cart → purchase). Takes the GA4 Data API's Funnel object; returns Google's funnel table and visualization objects.
The description explains the capability, when to use it, and what to expect.
Inputs91/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
property_id
The GA4 property, EXACTLY as a ga4_list_account_summaries row names it. Never invent or reformat one.
Clear enough to supply this argument.
date_ranges › items › start_date
First day of the range, in the property's time zone.
Clear enough to supply this argument.
date_ranges › items › end_date
Last day of the range, included, in the property's time zone.
Clear enough to supply this argument.
date_ranges › items › name
Optional label echoed on the range's rows.
Clear enough to supply this argument.
funnel › steps › items › name
Step label shown in the report.
Clear enough to supply this argument.
funnel › steps › items › isDirectlyFollowedBy
When true, this step must directly follow the previous one.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description97/100
Preset acquisition report: sessions, totalUsers, conversions, totalRevenue, and averageSessionDuration grouped by sessionCampaignName and sessionSourceMedium, ordered by sessions descending. Use for campaign acquisition outcomes, with a dimension_filter to focus on paid traffic. Ad spend, ROAS and a Google Ads campaign-record join are not included. Returns snake_case top-level report fields: rows are records keyed by GA4 dimension and metric API names, with values returned as strings; row_count is the unpaged total, and totals is populated only when Google returns aggregates.
The description explains the capability, when to use it, and what to expect.
Inputs89/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
property_id
The GA4 property, EXACTLY as a ga4_list_account_summaries row names it. Never invent or reformat one.
Clear enough to supply this argument.
date_ranges › items › start_date
First day of the range, in the property's time zone.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
date_ranges › items › end_date
Last day of the range, included, in the property's time zone.
Clear enough to supply this argument.
date_ranges › items › name
Optional label echoed on the range's rows.
Clear enough to supply this argument.
dimension_filter › filter › fieldName
The GA4 dimension or metric API name to filter on.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description97/100
Preset landing-page report: sessions, totalUsers, engagementRate, averageSessionDuration, conversions, and totalRevenue grouped by landingPagePlusQueryString, ordered by sessions descending. Use to compare entry-page engagement and conversion outcomes; query strings are part of the page grouping. Returns snake_case top-level report fields: rows are records keyed by GA4 dimension and metric API names, with values returned as strings; row_count is the unpaged total, and totals is populated only when Google returns aggregates.
The description explains the capability, when to use it, and what to expect.
Inputs89/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
property_id
The GA4 property, EXACTLY as a ga4_list_account_summaries row names it. Never invent or reformat one.
Clear enough to supply this argument.
date_ranges › items › start_date
First day of the range, in the property's time zone.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
date_ranges › items › end_date
Last day of the range, included, in the property's time zone.
Clear enough to supply this argument.
date_ranges › items › name
Optional label echoed on the range's rows.
Clear enough to supply this argument.
dimension_filter › filter › fieldName
The GA4 dimension or metric API name to filter on.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description97/100
Preset e-commerce report: itemsViewed, itemsAddedToCart, itemsPurchased, and itemRevenue grouped by itemName, ordered by itemRevenue descending. Use to compare product engagement and sales; source/campaign breakdowns and transaction counts are not included. Returns snake_case top-level report fields: rows are records keyed by GA4 dimension and metric API names, with values returned as strings; row_count is the unpaged total, and totals is populated only when Google returns aggregates.
The description explains the capability, when to use it, and what to expect.
Inputs91/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
property_id
The GA4 property, EXACTLY as a ga4_list_account_summaries row names it. Never invent or reformat one.
Clear enough to supply this argument.
date_ranges › items › start_date
First day of the range, in the property's time zone.
Clear enough to supply this argument.
date_ranges › items › end_date
Last day of the range, included, in the property's time zone.
Clear enough to supply this argument.
date_ranges › items › name
Optional label echoed on the range's rows.
Clear enough to supply this argument.
dimension_filter › filter › fieldName
The GA4 dimension or metric API name to filter on.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description98/100
Preset acquisition-scope report: conversions, totalRevenue, and sessions grouped jointly by firstUserDefaultChannelGroup and sessionDefaultChannelGroup, ordered by conversions descending. Use to examine first-user and session acquisition channel combinations. It does not compare attribution models or calculate changes in conversion credit. Returns snake_case top-level report fields: rows are records keyed by GA4 dimension and metric API names, with values returned as strings; row_count is the unpaged total, and totals is populated only when Google returns aggregates.
The description explains the capability, when to use it, and what to expect.
Inputs89/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
property_id
The GA4 property, EXACTLY as a ga4_list_account_summaries row names it. Never invent or reformat one.
Clear enough to supply this argument.
date_ranges › items › start_date
First day of the range, in the property's time zone.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
date_ranges › items › end_date
Last day of the range, included, in the property's time zone.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
date_ranges › items › name
Optional label echoed on the range's rows.
Clear enough to supply this argument.
dimension_filter › filter › fieldName
The GA4 dimension or metric API name to filter on.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description97/100
Preset channel/campaign report: conversions, totalRevenue, and sessions grouped by sessionDefaultChannelGroup and sessionCampaignName, ordered by conversions descending. Use to compare session channel and campaign conversion outcomes. Aggregate rows only, not multi-step conversion paths or assisted-conversion credit. Returns snake_case top-level report fields: rows are records keyed by GA4 dimension and metric API names, with values returned as strings; row_count is the unpaged total, and totals is populated only when Google returns aggregates.
The description explains the capability, when to use it, and what to expect.
Inputs91/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
property_id
The GA4 property, EXACTLY as a ga4_list_account_summaries row names it. Never invent or reformat one.
Clear enough to supply this argument.
date_ranges › items › start_date
First day of the range, in the property's time zone.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
date_ranges › items › end_date
Last day of the range, included, in the property's time zone.
Clear enough to supply this argument.
date_ranges › items › name
Optional label echoed on the range's rows.
Clear enough to supply this argument.
dimension_filter › filter › fieldName
The GA4 dimension or metric API name to filter on.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description95/100
Searches HYPD's help center for articles that answer a question about HYPD itself: connecting or reconnecting ad accounts, plans, billing and credits, privacy and data access, what HYPD can do, and setting HYPD up in Claude, ChatGPT or other AI clients. Returns the matching articles' text and links; answer from them and cite them. Not for advertising advice or the user's account data; use the platform tools for those.
The description explains the capability, when to use it, and what to expect.
Inputs75/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
question
The user's question about HYPD, in their words, e.g. 'How do I connect my Google Ads account?'
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Annotations100/100
All four behavior hints are declared.
{
"title": "Search the HYPD help center",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
Output schema75/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status",
"articles",
"help_center_url",
"note"
],
"properties": {
"note": {
"type": "string",
"description": "How these results relate to the question."
},
"status": {
"enum": [
"ok",
"no_results"
],
"type": "string",
"description": "no_results when no article matched."
},
"articles": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"url",
"description",
"content",
"updated_at"
],
"properties": {
"url": {
"type": "string",
"description": "The article's public link."
},
"title": {
"type": "string",
"description": "The article's title."
},
"content": {
"type": "string",
"description": "The article text to answer from."
},
"updated_at": {
"type": "string",
"description": "When the article last changed."
},
"description": {
"type": "string",
"description": "A one-line summary."
}
},
"additionalProperties": false
},
"description": "The matching articles."
},
"help_center_url": {
"type": "string",
"description": "The help center, for questions no article answers."
}
},
"additionalProperties": false
}
Original tool metadata
{
"name": "hypd_search_help",
"title": "Search the HYPD help center",
"description": "Searches HYPD's help center for articles that answer a question about HYPD itself: connecting or reconnecting ad accounts, plans, billing and credits, privacy and data access, what HYPD can do, and setting HYPD up in Claude, ChatGPT or other AI clients. Returns the matching articles' text and links; answer from them and cite them. Not for advertising advice or the user's account data; use the platform tools for those.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"question"
],
"properties": {
"question": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "The user's question about HYPD, in their words, e.g. 'How do I connect my Google Ads account?'"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"status",
"articles",
"help_center_url",
"note"
],
"properties": {
"note": {
"type": "string",
"description": "How these results relate to the question."
},
"status": {
"enum": [
"ok",
"no_results"
],
"type": "string",
"description": "no_results when no article matched."
},
"articles": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"url",
"description",
"content",
"updated_at"
],
"properties": {
"url": {
"type": "string",
"description": "The article's public link."
},
"title": {
"type": "string",
"description": "The article's title."
},
"content": {
"type": "string",
"description": "The article text to answer from."
},
"updated_at": {
"type": "string",
"description": "When the article last changed."
},
"description": {
"type": "string",
"description": "A one-line summary."
}
},
"additionalProperties": false
},
"description": "The matching articles."
},
"help_center_url": {
"type": "string",
"description": "The help center, for questions no article answers."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search the HYPD help center",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}
Loading score analytics…
Put your MCP to the test
A few tasks worth trying with this server, chosen from its reviewed tools. These have not been run.
01Search the HYPD help centerSearches HYPD's help center for articles that answer a question about HYPD itself: connecting or reconnecting ad accounts, plans, billing and credits, privac…
02Load the GA4 reporting guideReturns the GA4 guide for this server — call it first in a new conversation.
03List GA4 accounts and propertiesThe user's connected GA4 accounts with their properties — each property row carries the exact property_id ('properties/<digits>') every other ga4_* tool takes.
04Run a GA4 reportThe general GA4 report: any dimensions and metrics over 1-4 date ranges, with Google's filter, ordering, and pagination objects passed through verbatim.
05Get landing page performancePreset landing-page report: sessions, totalUsers, engagementRate, averageSessionDuration, conversions, and totalRevenue grouped by landingPagePlusQueryString…
Want to run these tasks against your MCP server with us?
HYPD AI for Google Analytics setup, tools, quality score, publishing readiness, and alternatives.
How do I add HYPD AI for Google Analytics to Claude, ChatGPT, or Cursor?
Add HYPD AI for Google Analytics to Claude, ChatGPT, or Cursor by connecting its remote MCP URL in each client's MCP settings. In Claude, add a custom connector. In ChatGPT, add an MCP app. In Cursor, add an MCP server under Settings. The MCP URL is https://googleanalytics.hypd.ai/mcp.
Is HYPD AI for Google Analytics MCP ready for ChatGPT and Claude?
As of November 15, 2026, HYPD AI for Google Analytics scores 100/100 on Manufact's MCP publishing checklist. The scan meets ChatGPT publishing checks and meets Claude publishing checks. Passing these checks does not guarantee marketplace approval.
How clear is HYPD AI for Google Analytics's MCP tool documentation?
As of November 15, 2026, HYPD AI for Google Analytics scores 91/100 in Manufact's review of tool titles, descriptions, input and output schemas, and behavior annotations. The review covers 17 of 17 discovered tools. The quality score measures documentation clarity; runtime behavior and marketplace readiness require separate checks.
What are the best alternatives to HYPD AI for Google Analytics?
As of November 16, 2026, alternatives to HYPD AI for Google Analytics in data-analytics on the Manufact MCP leaderboard include Neon, Polygraph, ClickHouse Cloud MCP Server, Crash Round Lab, and Databuddy.
Not your MCP?
Review any public or OAuth MCP server for protocol compatibility, tool documentation, and ChatGPT and Claude publishing readiness. No account required.