SEO GSC Wizard MCP

GA4 traffic overview

get_ga4_overview

Read-only

Use this when the user asks how much GA4 traffic a site had, or how it changed against the previous period. GA4 summary for the property linked to a GSC Wizard site: sessions, active/total/new users, page views, engagement rate, session duration, bounce rate, event count, and key events, with an automatic previous-period comparison (prevSummary). Not for Search Console clicks: use get_site_summary; for a split by channel or page use query_ga4_report. When the comparison period has no GA4 data at all (e.g. before the data stream existed), comparisonHasData is false and prevSummary is null instead of all zeros. Set includeTimeseries for daily points (timeseries, oldest day first). engagementRate and bounceRate are fractions 0-1, not percentages; averageSessionDuration is in seconds. Returns notConfigured (with a reason and hint) instead of data when Google Analytics is not connected or no GA4 property is linked to the site in GSC Wizard. Date range is optional: omit startDate/endDate to analyze the last 28 settled days (data lags ~2-3 days).

Input Schema

Name	Required	Description
`endDate`	No	Optional. Window end as YYYY-MM-DD (e.g. 2026-05-31). You do NOT need to know today's date or the latest available date: omit this and the server uses the latest settled Search Console date (data lags ~2-3 days behind today). Never pass null or the string "null".
`filters`	No	Optional GA4 dimension filters applied to every report in the call. Within a list field the values OR together; different fields AND together. Omit entirely for unfiltered data.
`siteUrl`	Yes
`startDate`	No	Optional. Window start as YYYY-MM-DD (e.g. 2026-05-03). You do NOT need to know today's date. Omit BOTH startDate and endDate to analyze the last 28 settled days automatically (Search Console data lags ~2-3 days). Never pass null or the string "null".
`comparisonEndDate`	No	Optional. End of the baseline / comparison period as YYYY-MM-DD. Omit both comparison dates to use the same-length period immediately before the current window; give only this one to end a baseline of the same length here.
`includeTimeseries`	No
`comparisonStartDate`	No	Optional. Start of the baseline / comparison period as YYYY-MM-DD. Omit both comparison dates to use the same-length period immediately before the current window; give only this one to start a baseline of the same length here.

Output Schema

Name	Required	Description
`hint`	No
`kind`	No	Widget variant: "kpis", "table", or "sections".
`kpis`	No	KPI cards (kind="kpis").
`note`	No	Caveat about the result, when the tool returned one.
`rows`	No	Data rows (kind="table").
`notes`	No	Caveats about the result, when the tool returned several.
`scope`	No	The brand, content group or topic cluster filter these numbers are narrowed to; absent when the call was unscoped and the numbers cover the whole property.
`title`	No
`blocks`	No	Stacked sub-blocks (kind="sections").
`reason`	No
`source`	No
`thenBy`	No	Secondary sort field, when the tool states one.
`account`	No
`columns`	No	Column defs (kind="table").
`warning`	No	A caveat that changes how the numbers read.
`coverage`	No	How much of the property total the returned rows cover, with the property totals inline. Quote totals from here; do not sum the rows.
`nextStep`	No
`ordering`	No	Sort order per list, when the result holds several lists.
`sortedBy`	No	Row field the rows are sorted by.
`timeZone`	No	GA4 property's IANA reporting time zone.
`emptyText`	No
`siteScope`	No	Set when GA4 numbers were narrowed to this site's hostnames because the property is shared with other sites.
`sortOrder`	No	"asc" or "desc".
`thenOrder`	No	The tie-break's direction, present only when it differs from sortOrder.
`partialDays`	No	Requested days after settledThrough; their numbers are still incomplete.
`dataMaturity`	No
`emptyBecause`	No
`methodLimits`	No
`notConfigured`	No
`reauthRequired`	No
`settledThrough`	No	Last day the data is complete through.
`comparisonHasData`	No	false when the comparison period has no data at all, so there is no comparison.
`coverageUnavailable`	No	Why coverage is null, when it is.

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedOct 27, 2026

addedInput schema / properties / filters / properties / firstUserChannel

Added value: +{
+  "description": "GA4 firstUserDefaultChannelGroup names, matched exactly (any of): the channel that first acquired the user, as in GA4's User acquisition report, rather than the session's own channel. E.g. [\"Organic Search\"].",
+  "items": {
+    "maxLength": 256,
+    "minLength": 1,
+    "type": "string"
+  },
+  "maxItems": 300,
+  "type": "array"
+}

addedInput schema / properties / filters / properties / firstUserSourceMedium

Added value: +{
+  "description": "GA4 firstUserSourceMedium values, matched exactly (any of): the source / medium that first acquired the user (User acquisition report), e.g. [\"google / organic\"].",
+  "items": {
+    "maxLength": 256,
+    "minLength": 1,
+    "type": "string"
+  },
+  "maxItems": 300,
+  "type": "array"
+}

Changed21 schema fields changedOct 18, 2026

changedOutput schema / additionalProperties
```
Previous value: -falseNew value: +true
```

addedOutput schema / properties / account

Added value: +{
+  "$ref": "#/properties/title"
+}

addedOutput schema / properties / coverage

Added value: +{
+  "description": "How much of the property total the returned rows cover, with the property totals inline. Quote totals from here; do not sum the rows."
+}

addedOutput schema / properties / coverageUnavailable

Added value: +{
+  "$ref": "#/properties/kind",
+  "description": "Why coverage is null, when it is."
+}

changedOutput schema / properties / dataMaturity / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "dateBasis": {
-        "$ref": "#/properties/title"
-      },
-      "firstIncompleteDate": {
-        "$ref": "#/properties/title"
-      },
-      "note": {
-        "$ref": "#/properties/title"
-      },
-      "probe": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "dataState": {
-                "$ref": "#/properties/title"
-              },
-              "endDate": {
-                "$ref": "#/properties/title"
-              },
-              "searchType": {
-                "$ref": "#/properties/title"
-              },
-              "startDate": {
-                "$ref": "#/properties/title"
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "settledThrough": {
-        "$ref": "#/properties/title"
-      },
-      "source": {
-        "$ref": "#/properties/title"
-      },
-      "warehouseCutoff": {
-        "$ref": "#/properties/title"
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": true,
+    "properties": {
+      "dateBasis": {
+        "$ref": "#/properties/title"
+      },
+      "firstIncompleteDate": {
+        "$ref": "#/properties/title"
+      },
+      "note": {
+        "$ref": "#/properties/title"
+      },
+      "probe": {
+        "anyOf": [
+          {
+            "additionalProperties": true,
+            "properties": {
+              "dataState": {
+                "$ref": "#/properties/title"
+              },
+              "endDate": {
+                "$ref": "#/properties/title"
+              },
+              "searchType": {
+                "$ref": "#/properties/title"
+              },
+              "startDate": {
+                "$ref": "#/properties/title"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "settledThrough": {
+        "$ref": "#/properties/title"
+      },
+      "source": {
+        "$ref": "#/properties/title"
+      },
+      "warehouseCutoff": {
+        "$ref": "#/properties/title"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / emptyBecause

Added value: +{
+  "$ref": "#/properties/title"
+}

addedOutput schema / properties / hint

Added value: +{
+  "$ref": "#/properties/title"
+}

addedOutput schema / properties / methodLimits

Added value: +{
+  "$ref": "#/properties/title"
+}

addedOutput schema / properties / nextStep

Added value: +{
+  "$ref": "#/properties/title"
+}

addedOutput schema / properties / notConfigured

Added value: +{
+  "$ref": "#/properties/comparisonHasData"
+}

addedOutput schema / properties / ordering

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": {
+        "additionalProperties": true,
+        "properties": {
+          "sortOrder": {
+            "$ref": "#/properties/title"
+          },
+          "sortedBy": {
+            "$ref": "#/properties/title"
+          },
+          "thenBy": {
+            "$ref": "#/properties/title"
+          },
+          "thenOrder": {
+            "$ref": "#/properties/title"
+          }
+        },
+        "type": "object"
+      },
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Sort order per list, when the result holds several lists."
+}

addedOutput schema / properties / partialDays

Added value: +{
+  "$ref": "#/properties/siteScope/anyOf/0/properties/hostnames",
+  "description": "Requested days after settledThrough; their numbers are still incomplete."
+}

addedOutput schema / properties / reason

Added value: +{
+  "$ref": "#/properties/title"
+}

addedOutput schema / properties / reauthRequired

Added value: +{
+  "$ref": "#/properties/notConfigured"
+}

addedOutput schema / properties / scope

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": true,
+      "properties": {
+        "brand": {
+          "$ref": "#/properties/kind",
+          "description": "\"branded\" or \"non_branded\"."
+        },
+        "brandKeywordsSkipped": {
+          "$ref": "#/properties/siteScope/anyOf/0/properties/hostnames",
+          "description": "Branded keywords that could not be compiled and were left out of the filter."
+        },
+        "contentGroup": {
+          "anyOf": [
+            {
+              "additionalProperties": true,
+              "properties": {
+                "id": {
+                  "$ref": "#/properties/title"
+                },
+                "name": {
+                  "$ref": "#/properties/title"
+                }
+              },
+              "type": "object"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "topicCluster": {
+          "anyOf": [
+            {
+              "additionalProperties": true,
+              "properties": {
+                "id": {
+                  "$ref": "#/properties/title"
+                },
+                "name": {
+                  "$ref": "#/properties/title"
+                }
+              },
+              "type": "object"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      },
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "The brand, content group or topic cluster filter these numbers are narrowed to; absent when the call was unscoped and the numbers cover the whole property."
+}

changedOutput schema / properties / siteScope / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "hostnames": {
-        "anyOf": [
-          {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "includesSubdomainsOf": {
-        "$ref": "#/properties/title"
-      },
-      "note": {
-        "$ref": "#/properties/title"
-      },
-      "sharedWithSites": {
-        "$ref": "#/properties/siteScope/anyOf/0/properties/hostnames"
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": true,
+    "properties": {
+      "hostnames": {
+        "anyOf": [
+          {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "includesSubdomainsOf": {
+        "$ref": "#/properties/title"
+      },
+      "note": {
+        "$ref": "#/properties/title"
+      },
+      "sharedWithSites": {
+        "$ref": "#/properties/siteScope/anyOf/0/properties/hostnames"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / sortOrder

Added value: +{
+  "$ref": "#/properties/kind",
+  "description": "\"asc\" or \"desc\"."
+}

addedOutput schema / properties / sortedBy

Added value: +{
+  "$ref": "#/properties/kind",
+  "description": "Row field the rows are sorted by."
+}

addedOutput schema / properties / thenBy

Added value: +{
+  "$ref": "#/properties/kind",
+  "description": "Secondary sort field, when the tool states one."
+}

addedOutput schema / properties / thenOrder

Added value: +{
+  "$ref": "#/properties/kind",
+  "description": "The tie-break's direction, present only when it differs from sortOrder."
+}

addedOutput schema / properties / warning

Added value: +{
+  "$ref": "#/properties/kind",
+  "description": "A caveat that changes how the numbers read."
+}

Changed3 schema fields changedOct 10, 2026

changedInput schema / properties / comparisonEndDate / description

Previous value: -"Optional. End of the baseline / comparison period as YYYY-MM-DD. Omit both comparison dates to use the same-length period immediately before the current window."New value: +"Optional. End of the baseline / comparison period as YYYY-MM-DD. Omit both comparison dates to use the same-length period immediately before the current window; give only this one to end a baseline of the same length here."

changedInput schema / properties / comparisonStartDate / description

Previous value: -"Optional. Start of the baseline / comparison period as YYYY-MM-DD. Omit both comparison dates to use the same-length period immediately before the current window."New value: +"Optional. Start of the baseline / comparison period as YYYY-MM-DD. Omit both comparison dates to use the same-length period immediately before the current window; give only this one to start a baseline of the same length here."

changedInput schema / properties / filters / properties / hostName / description

Previous value: -"GA4 hostName values, matched exactly (any of), e.g. [\"www.example.com\"]. When the linked GA4 property is shared with other sites, results are already limited to this site's hostnames (see `siteScope` in the response); setting hostName replaces that automatic scope, e.g. to read another stream or several hosts at once."New value: +"GA4 hostName values, matched exactly (any of), e.g. [\"www.example.com\"]. When the linked GA4 property is shared with other sites, results are already limited to this site's hostnames (see `siteScope` in the response). For the property owner, setting hostName replaces that automatic scope, e.g. to read another stream or several hosts at once; on a property shared with you it only narrows within the scope."

Changed4 schema fields changedOct 7, 2026

addedOutput schema / properties / comparisonHasData

Added value: +{
+  "description": "false when the comparison period has no data at all, so there is no comparison.",
+  "type": [
+    "boolean",
+    "null"
+  ]
+}

addedOutput schema / properties / note

Added value: +{
+  "$ref": "#/properties/kind",
+  "description": "Caveat about the result, when the tool returned one."
+}

addedOutput schema / properties / notes

Added value: +{
+  "$ref": "#/properties/siteScope/anyOf/0/properties/hostnames",
+  "description": "Caveats about the result, when the tool returned several."
+}

addedOutput schema / properties / siteScope

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "hostnames": {
+          "anyOf": [
+            {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "includesSubdomainsOf": {
+          "$ref": "#/properties/title"
+        },
+        "note": {
+          "$ref": "#/properties/title"
+        },
+        "sharedWithSites": {
+          "$ref": "#/properties/siteScope/anyOf/0/properties/hostnames"
+        }
+      },
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Set when GA4 numbers were narrowed to this site's hostnames because the property is shared with other sites."
+}

Changed1 schema field changedOct 7, 2026

addedInput schema / properties / filters / properties / hostName

Added value: +{
+  "description": "GA4 hostName values, matched exactly (any of), e.g. [\"www.example.com\"]. When the linked GA4 property is shared with other sites, results are already limited to this site's hostnames (see `siteScope` in the response); setting hostName replaces that automatic scope, e.g. to read another stream or several hosts at once.",
+  "items": {
+    "maxLength": 256,
+    "minLength": 1,
+    "type": "string"
+  },
+  "maxItems": 300,
+  "type": "array"
+}

First observedOct 7, 2026

TDQS

A4.9/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the readOnly/openWorld annotations, the description discloses important behavior: comparisonHasData is false and prevSummary is null when baseline data is missing, includeTimeseries returns daily points oldest first, rates are fractions from 0 to 1, durations are in seconds, and notConfigured is returned when Analytics is unavailable. It also documents the default date window and data lag, which are not fully covered by annotations alone.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is dense but front-loaded: it starts with the use case, then exclusions, behavioral caveats, output semantics, and date defaults. Every sentence carries actionable information, with no apparent filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a complex GA4 overview tool with an output schema and nested filters, the description covers purpose, alternatives, default behavior, key response caveats, and the notConfigured state. An agent has enough context to select and invoke the tool correctly without needing return-value details beyond the schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema already documents most parameters in detail, including the nested filters. The description adds useful meaning for includeTimeseries (daily points, oldest first) and the date range default, but it does not explain the filters object or the siteUrl format, so it does not fully compensate beyond the 71% schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: a GA4 traffic overview for a site, listing the exact metrics returned and the automatic previous-period comparison. It also explicitly distinguishes itself from get_site_summary for Search Console clicks and query_ga4_report for channel or page splits.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives explicit triggering conditions: use when the user asks how much GA4 traffic a site had or how it changed against the previous period. It also names when not to use it and which sibling tool to use instead, with clear alternative routing.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All SEO GSC Wizard MCP tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?