SEO GSC Wizard MCP

Analyze GSC sampling / anonymization impact

analyze_sampling_impact

Read-only

Use this when the user asks how much of a property's traffic is hidden from query or page rows. Compares the per-day totals with the summed query rows and page rows; the gap is traffic no row carries. Per dimension, gap says why: anonymisedShare is traffic that belongs to no row at all (privacy-threshold anonymisation; the warehouse stores what the API returned, so it lacks those queries too) and truncatedShare is traffic in rows past the read cap (0 unless the cap was hit, null when the path cannot split the two). Shares are 0-1 fractions; missingClicksPercent is 0-100. note is written from these fields. Not for the totals themselves: use get_site_summary. The response dataSource says which path served the request. Date range is optional: omit startDate/endDate to analyze the last 28 settled days (data lags ~2-3 days).

Input Schema

Name	Required	Description	Default
`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".
`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".
`searchType`	No	Search type: web (default), image, video, news (the News tab), discover, googleNews (news.google.com), or all (web + image + video + news + discover combined, position impression-weighted, like the app's "All" filter). Discover and googleNews carry no query dimension, so query-level results for them are empty, and no position: it reads null, not 0.	web

Output Schema

Name	Required	Description	Default
`note`	No
`range`	No
`totals`	No
`siteUrl`	No
`warning`	No
`dataSource`	No
`partialDays`	No
`dataMaturity`	No
`pageSampling`	No
`querySampling`	No
`settledThrough`	No
`warehouseLatestDate`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 25, 2026

changedInput schema / properties / searchType / description

Previous value: -"Search type: web (default), image, video, news (the News tab), discover, googleNews (news.google.com), or all (web + image + video + news + discover combined, position impression-weighted, like the app's \"All\" filter). Discover and googleNews carry no query dimension, so query-level results for them are empty."New value: +"Search type: web (default), image, video, news (the News tab), discover, googleNews (news.google.com), or all (web + image + video + news + discover combined, position impression-weighted, like the app's \"All\" filter). Discover and googleNews carry no query dimension, so query-level results for them are empty, and no position: it reads null, not 0."

Changed2 schema fields changedOct 25, 2026

addedInput schema / properties / searchType / description

Added value: +"Search type: web (default), image, video, news (the News tab), discover, googleNews (news.google.com), or all (web + image + video + news + discover combined, position impression-weighted, like the app's \"All\" filter). Discover and googleNews carry no query dimension, so query-level results for them are empty."

changedInput schema / properties / searchType / enum

Previous value: -[
-  "web",
-  "image",
-  "video",
-  "news"
-]New value: +[
+  "web",
+  "image",
+  "video",
+  "news",
+  "discover",
+  "googleNews",
+  "all"
+]

Changed9 schema fields changedOct 18, 2026

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

changedOutput schema / properties / dataMaturity / anyOf

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

addedOutput schema / properties / pageSampling / $ref
```
Added value: +"#/properties/querySampling"
```

removedOutput schema / properties / pageSampling / anyOf

Removed value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "missingClicksPercent": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      },
-      "missingImpressionsPercent": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      },
-      "rowCount": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / partialDays

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

changedOutput schema / properties / querySampling / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "missingClicksPercent": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      },
-      "missingImpressionsPercent": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      },
-      "rowCount": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": true,
+    "properties": {
+      "gap": {
+        "anyOf": [
+          {
+            "additionalProperties": true,
+            "properties": {
+              "anonymisedImpressionsShare": {
+                "$ref": "#/properties/range/anyOf/0/properties/days"
+              },
+              "anonymisedShare": {
+                "$ref": "#/properties/range/anyOf/0/properties/days",
+                "description": "hiddenClicks / totalClicks, a 0-1 fraction."
+              },
+              "capHit": {
+                "type": [
+                  "boolean",
+                  "null"
+                ]
+              },
+              "hiddenClicks": {
+                "$ref": "#/properties/range/anyOf/0/properties/days",
+                "description": "Clicks no row of the dimension carries."
+              },
+              "hiddenImpressions": {
+                "$ref": "#/properties/range/anyOf/0/properties/days"
+              },
+              "rowCap": {
+                "$ref": "#/properties/range/anyOf/0/properties/days"
+              },
+              "rowClicks": {
+                "$ref": "#/properties/range/anyOf/0/properties/days",
+                "description": "Clicks over every row of the dimension; null when unknown."
+              },
+              "rowImpressions": {
+                "$ref": "#/properties/range/anyOf/0/properties/days"
+              },
+              "rowsTotal": {
+                "$ref": "#/properties/range/anyOf/0/properties/days",
+                "description": "Rows of the dimension; null when unknown."
+              },
+              "totalClicks": {
+                "$ref": "#/properties/range/anyOf/0/properties/days"
+              },
+              "totalImpressions": {
+                "$ref": "#/properties/range/anyOf/0/properties/days"
+              },
+              "truncatedImpressionsShare": {
+                "$ref": "#/properties/range/anyOf/0/properties/days"
+              },
+              "truncatedShare": {
+                "$ref": "#/properties/range/anyOf/0/properties/days",
+                "description": "0-1 share of clicks in rows past rowCap: 0 when the cap was not hit, null when the path cannot split it."
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "missingClicksPercent": {
+        "$ref": "#/properties/range/anyOf/0/properties/days"
+      },
+      "missingImpressionsPercent": {
+        "$ref": "#/properties/range/anyOf/0/properties/days"
+      },
+      "rowCount": {
+        "$ref": "#/properties/range/anyOf/0/properties/days"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / range / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "days": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "endDate": {
-        "$ref": "#/properties/siteUrl"
-      },
-      "startDate": {
-        "$ref": "#/properties/siteUrl"
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": true,
+    "properties": {
+      "days": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "endDate": {
+        "$ref": "#/properties/siteUrl"
+      },
+      "startDate": {
+        "$ref": "#/properties/siteUrl"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / totals / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "clicks": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      },
-      "impressions": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": true,
+    "properties": {
+      "clicks": {
+        "$ref": "#/properties/range/anyOf/0/properties/days"
+      },
+      "impressions": {
+        "$ref": "#/properties/range/anyOf/0/properties/days"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / warning

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

Changed1 schema field changedOct 10, 2026
- addedOutput schema / properties / warehouseLatestDate
```
Added value: +{
+  "$ref": "#/properties/siteUrl"
+}
```
First observedOct 7, 2026

TDQS

A4.4/5.0

Behavior4/5

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

Annotations already cover the safety profile (readOnly, non-destructive), but the description adds real behavioral context: data lags ~2-3 days, the warehouse mirrors what the API returned, shares are 0-1 vs missingClicksPercent 0-100, and null signals an inseparable path. Slightly dense but genuinely beyond annotations.

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

Conciseness4/5

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

Front-loaded with the 'use this when' trigger, then mechanism, then field interpretation, then exclusions. Dense but each sentence carries signal; the output-field unpacking borders on verbose for a description when an output schema exists.

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?

Even though an output schema exists, the description makes the return values interpretable (what gap/anonymisedShare/truncatedShare mean, unit scales, dataSource path). Nothing needed to call or interpret the tool is missing.

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

Parameters3/5

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

With 75% schema coverage the schema documents siteUrl, startDate, endDate, and the searchType enum in detail; the description mostly restates the date-lag/omit-default rule the schema already covers. Its richer text describes output fields (gap, anonymisedShare, truncatedShare) rather than clarifying input parameters.

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?

States a specific analytical purpose (quantify hidden traffic) with a precise mechanism: compares per-day totals against summed query and page rows, gap being rowless traffic. It explicitly distinguishes itself from the sibling get_site_summary, so an agent can route correctly.

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?

Opens with the triggering user question ('how much of a property's traffic is hidden'), and states the negative case: 'Not for the totals themselves: use get_site_summary.' It also gives default behavior for the optional date range (omit to get last 28 settled days).

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?