Skip to main content
Glama
Sign In

SEO GSC Wizard MCP

by com.gscwizard.mcp
OverviewDiscussionsAdmin

Run feed audit

run_feed_audit

Queues a Merchant Center feed audit for a GSC Wizard site: 21 deterministic checks over the synced product catalog (title and description length, duplicate titles / descriptions / images / URLs, GTIN, category, product type and required attributes, image size and ratio) plus a crawl of the product pages on the owner-approved host allowlist (HTTP status, JSON-LD Product schema, price and title consistency, H1 and title-element counts, page images missing from the feed), rolled up into a 0-100 Feed Score. The tool only ENQUEUES: the audit runs in the GSC Wizard app worker (the feed plane within minutes, the page crawl at a politeness-bounded pace over every distinct product URL, so a large catalog can take hours), and enqueued: false with a skipReason means a run is still in progress (run_in_progress, with the run summary in run), a run for today already exists, or one completed inside the 28-day cadence (pass force: true to override the cadence; the one-per-day rule cannot be overridden). Each user may start at most 3 runs per 24 hours (rate_limited beyond that; a call that queues nothing does not count). Poll get_feed_audit_results with the returned runDate for status and the score. Returns a notConfigured result (not an error) when Merchant Center is not connected, is connected on another Google login than the property's Search Console one (reason "gmc_on_other_account": the audit runs through the sync, which reads only through the Search Console account), its credentials were revoked, or no Merchant Center account is linked to the site in the GSC Wizard app. Requires full access on a shared property.

Input Schema

NameRequiredDescriptionDefault
forceNoQueue an audit even when one completed inside the last 28 days (default false). Cannot bypass the one-audit-per-property-per-day rule or a run still in progress.
siteUrlYesThe property URL as returned by list_sites (e.g. "sc-domain:example.com").

Output Schema

NameRequiredDescriptionDefault
runNo
hintNo
forceNo
rangeNo
reasonNo
accountNo
runDateNo
siteUrlNo
cachedAtNo
enqueuedNo
dataSourceNo
skipReasonNo
gmcAccountIdNo
notConfiguredNo
truncationReasonNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / properties / run / anyOf
      Previous value: -[
-  {
-    "additionalProperties": true,
-    "properties": {
-      "bySeverity": {
-        "anyOf": [
-          {
-            "additionalProperties": true,
-            "properties": {
-              "critical": {
-                "$ref": "#/properties/range/anyOf/0/properties/days"
-              },
-              "info": {
-                "$ref": "#/properties/range/anyOf/0/properties/days"
-              },
-              "warning": {
-                "$ref": "#/properties/range/anyOf/0/properties/days"
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "completedAt": {
-        "$ref": "#/properties/siteUrl"
-      },
-      "coverage": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      },
-      "crawlBlocked": {
-        "$ref": "#/properties/notConfigured"
-      },
-      "createdAt": {
-        "$ref": "#/properties/siteUrl"
-      },
-      "error": {
-        "$ref": "#/properties/siteUrl"
-      },
-      "offersAudited": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      },
-      "offersTotal": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      },
-      "pageScored": {
-        "$ref": "#/properties/notConfigured"
-      },
-      "pagesFailed": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      },
-      "pagesFetched": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      },
-      "pagesTotal": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      },
-      "perCheck": {
-        "anyOf": [
-          {
-            "additionalProperties": {
-              "additionalProperties": true,
-              "properties": {
-                "applicable": {
-                  "$ref": "#/properties/range/anyOf/0/properties/days"
-                },
-                "failed": {
-                  "$ref": "#/properties/range/anyOf/0/properties/days"
-                }
-              },
-              "type": "object"
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "runDate": {
-        "$ref": "#/properties/siteUrl"
-      },
-      "runId": {
-        "$ref": "#/properties/siteUrl"
-      },
-      "score": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      },
-      "scoreFeed": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      },
-      "scorePage": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      },
-      "scoreVersion": {
-        "$ref": "#/properties/siteUrl"
-      },
-      "startedAt": {
-        "$ref": "#/properties/siteUrl"
-      },
-      "status": {
-        "$ref": "#/properties/siteUrl"
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": true,
+    "properties": {
+      "bySeverity": {
+        "anyOf": [
+          {
+            "additionalProperties": true,
+            "properties": {
+              "critical": {
+                "$ref": "#/properties/range/anyOf/0/properties/days"
+              },
+              "info": {
+                "$ref": "#/properties/range/anyOf/0/properties/days"
+              },
+              "warning": {
+                "$ref": "#/properties/range/anyOf/0/properties/days"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "completedAt": {
+        "$ref": "#/properties/siteUrl"
+      },
+      "coverage": {
+        "$ref": "#/properties/range/anyOf/0/properties/days"
+      },
+      "crawlBlocked": {
+        "$ref": "#/properties/notConfigured"
+      },
+      "createdAt": {
+        "$ref": "#/properties/siteUrl"
+      },
+      "error": {
+        "$ref": "#/properties/siteUrl"
+      },
+      "markets": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": true,
+              "properties": {
+                "contentLanguage": {
+                  "$ref": "#/properties/siteUrl"
+                },
+                "country": {
+                  "$ref": "#/properties/siteUrl"
+                },
+                "currency": {
+                  "$ref": "#/properties/siteUrl"
+                },
+                "feedLabel": {
+                  "$ref": "#/properties/siteUrl"
+                },
+                "home": {
+                  "$ref": "#/properties/notConfigured"
+                },
+                "key": {
+                  "$ref": "#/properties/siteUrl"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "offersAudited": {
+        "$ref": "#/properties/range/anyOf/0/properties/days"
+      },
+      "offersTotal": {
+        "$ref": "#/properties/range/anyOf/0/properties/days"
+      },
+      "pageScored": {
+        "$ref": "#/properties/notConfigured"
+      },
+      "pagesFailed": {
+        "$ref": "#/properties/range/anyOf/0/properties/days"
+      },
+      "pagesFetched": {
+        "$ref": "#/properties/range/anyOf/0/properties/days"
+      },
+      "pagesTotal": {
+        "$ref": "#/properties/range/anyOf/0/properties/days"
+      },
+      "perCheck": {
+        "anyOf": [
+          {
+            "additionalProperties": {
+              "additionalProperties": true,
+              "properties": {
+                "applicable": {
+                  "$ref": "#/properties/range/anyOf/0/properties/days"
+                },
+                "failed": {
+                  "$ref": "#/properties/range/anyOf/0/properties/days"
+                }
+              },
+              "type": "object"
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "perMarket": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": true,
+              "properties": {
+                "bySeverity": {
+                  "$ref": "#/properties/run/anyOf/0/properties/bySeverity"
+                },
+                "home": {
+                  "$ref": "#/properties/notConfigured"
+                },
+                "key": {
+                  "$ref": "#/properties/siteUrl"
+                },
+                "offersAudited": {
+                  "$ref": "#/properties/range/anyOf/0/properties/days"
+                },
+                "perCheck": {
+                  "anyOf": [
+                    {
+                      "additionalProperties": {
+                        "additionalProperties": true,
+                        "properties": {
+                          "applicable": {
+                            "$ref": "#/properties/range/anyOf/0/properties/days"
+                          },
+                          "failed": {
+                            "$ref": "#/properties/range/anyOf/0/properties/days"
+                          }
+                        },
+                        "type": "object"
+                      },
+                      "type": "object"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "score": {
+                  "$ref": "#/properties/range/anyOf/0/properties/days"
+                },
+                "scoreFeed": {
+                  "$ref": "#/properties/range/anyOf/0/properties/days"
+                },
+                "scorePage": {
+                  "$ref": "#/properties/range/anyOf/0/properties/days"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "runDate": {
+        "$ref": "#/properties/siteUrl"
+      },
+      "runId": {
+        "$ref": "#/properties/siteUrl"
+      },
+      "score": {
+        "$ref": "#/properties/range/anyOf/0/properties/days"
+      },
+      "scoreFeed": {
+        "$ref": "#/properties/range/anyOf/0/properties/days"
+      },
+      "scorePage": {
+        "$ref": "#/properties/range/anyOf/0/properties/days"
+      },
+      "scoreVersion": {
+        "$ref": "#/properties/siteUrl"
+      },
+      "startedAt": {
+        "$ref": "#/properties/siteUrl"
+      },
+      "status": {
+        "$ref": "#/properties/siteUrl"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]
  2. Changed3 schema fields changed
    • changedOutput schema / additionalProperties
      Previous value: -falseNew value: +true
    • 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 / run / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "bySeverity": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "critical": {
-                "$ref": "#/properties/range/anyOf/0/properties/days"
-              },
-              "info": {
-                "$ref": "#/properties/range/anyOf/0/properties/days"
-              },
-              "warning": {
-                "$ref": "#/properties/range/anyOf/0/properties/days"
-              }
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "completedAt": {
-        "$ref": "#/properties/siteUrl"
-      },
-      "coverage": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      },
-      "crawlBlocked": {
-        "$ref": "#/properties/notConfigured"
-      },
-      "createdAt": {
-        "$ref": "#/properties/siteUrl"
-      },
-      "error": {
-        "$ref": "#/properties/siteUrl"
-      },
-      "offersAudited": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      },
-      "offersTotal": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      },
-      "pageScored": {
-        "$ref": "#/properties/notConfigured"
-      },
-      "pagesFailed": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      },
-      "pagesFetched": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      },
-      "pagesTotal": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      },
-      "perCheck": {
-        "anyOf": [
-          {
-            "additionalProperties": {
-              "additionalProperties": false,
-              "properties": {
-                "applicable": {
-                  "$ref": "#/properties/range/anyOf/0/properties/days"
-                },
-                "failed": {
-                  "$ref": "#/properties/range/anyOf/0/properties/days"
-                }
-              },
-              "type": "object"
-            },
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "runDate": {
-        "$ref": "#/properties/siteUrl"
-      },
-      "runId": {
-        "$ref": "#/properties/siteUrl"
-      },
-      "score": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      },
-      "scoreFeed": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      },
-      "scorePage": {
-        "$ref": "#/properties/range/anyOf/0/properties/days"
-      },
-      "scoreVersion": {
-        "$ref": "#/properties/siteUrl"
-      },
-      "startedAt": {
-        "$ref": "#/properties/siteUrl"
-      },
-      "status": {
-        "$ref": "#/properties/siteUrl"
-      }
-    },
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": true,
+    "properties": {
+      "bySeverity": {
+        "anyOf": [
+          {
+            "additionalProperties": true,
+            "properties": {
+              "critical": {
+                "$ref": "#/properties/range/anyOf/0/properties/days"
+              },
+              "info": {
+                "$ref": "#/properties/range/anyOf/0/properties/days"
+              },
+              "warning": {
+                "$ref": "#/properties/range/anyOf/0/properties/days"
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "completedAt": {
+        "$ref": "#/properties/siteUrl"
+      },
+      "coverage": {
+        "$ref": "#/properties/range/anyOf/0/properties/days"
+      },
+      "crawlBlocked": {
+        "$ref": "#/properties/notConfigured"
+      },
+      "createdAt": {
+        "$ref": "#/properties/siteUrl"
+      },
+      "error": {
+        "$ref": "#/properties/siteUrl"
+      },
+      "offersAudited": {
+        "$ref": "#/properties/range/anyOf/0/properties/days"
+      },
+      "offersTotal": {
+        "$ref": "#/properties/range/anyOf/0/properties/days"
+      },
+      "pageScored": {
+        "$ref": "#/properties/notConfigured"
+      },
+      "pagesFailed": {
+        "$ref": "#/properties/range/anyOf/0/properties/days"
+      },
+      "pagesFetched": {
+        "$ref": "#/properties/range/anyOf/0/properties/days"
+      },
+      "pagesTotal": {
+        "$ref": "#/properties/range/anyOf/0/properties/days"
+      },
+      "perCheck": {
+        "anyOf": [
+          {
+            "additionalProperties": {
+              "additionalProperties": true,
+              "properties": {
+                "applicable": {
+                  "$ref": "#/properties/range/anyOf/0/properties/days"
+                },
+                "failed": {
+                  "$ref": "#/properties/range/anyOf/0/properties/days"
+                }
+              },
+              "type": "object"
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "runDate": {
+        "$ref": "#/properties/siteUrl"
+      },
+      "runId": {
+        "$ref": "#/properties/siteUrl"
+      },
+      "score": {
+        "$ref": "#/properties/range/anyOf/0/properties/days"
+      },
+      "scoreFeed": {
+        "$ref": "#/properties/range/anyOf/0/properties/days"
+      },
+      "scorePage": {
+        "$ref": "#/properties/range/anyOf/0/properties/days"
+      },
+      "scoreVersion": {
+        "$ref": "#/properties/siteUrl"
+      },
+      "startedAt": {
+        "$ref": "#/properties/siteUrl"
+      },
+      "status": {
+        "$ref": "#/properties/siteUrl"
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]
  3. Changed4 schema fields changed
    • changedInput schema / properties / force / description
      Previous value: -"Queue an audit even when one completed inside the last 28 days (default false). Cannot bypass the one-audit-per-property-per-day rule."New value: +"Queue an audit even when one completed inside the last 28 days (default false). Cannot bypass the one-audit-per-property-per-day rule or a run still in progress."
    • addedOutput schema / properties / cachedAt
      Added value: +{
+  "$ref": "#/properties/siteUrl"
+}
    • addedOutput schema / properties / run
      Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "bySeverity": {
+          "anyOf": [
+            {
+              "additionalProperties": false,
+              "properties": {
+                "critical": {
+                  "$ref": "#/properties/range/anyOf/0/properties/days"
+                },
+                "info": {
+                  "$ref": "#/properties/range/anyOf/0/properties/days"
+                },
+                "warning": {
+                  "$ref": "#/properties/range/anyOf/0/properties/days"
+                }
+              },
+              "type": "object"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "completedAt": {
+          "$ref": "#/properties/siteUrl"
+        },
+        "coverage": {
+          "$ref": "#/properties/range/anyOf/0/properties/days"
+        },
+        "crawlBlocked": {
+          "$ref": "#/properties/notConfigured"
+        },
+        "createdAt": {
+          "$ref": "#/properties/siteUrl"
+        },
+        "error": {
+          "$ref": "#/properties/siteUrl"
+        },
+        "offersAudited": {
+          "$ref": "#/properties/range/anyOf/0/properties/days"
+        },
+        "offersTotal": {
+          "$ref": "#/properties/range/anyOf/0/properties/days"
+        },
+        "pageScored": {
+          "$ref": "#/properties/notConfigured"
+        },
+        "pagesFailed": {
+          "$ref": "#/properties/range/anyOf/0/properties/days"
+        },
+        "pagesFetched": {
+          "$ref": "#/properties/range/anyOf/0/properties/days"
+        },
+        "pagesTotal": {
+          "$ref": "#/properties/range/anyOf/0/properties/days"
+        },
+        "perCheck": {
+          "anyOf": [
+            {
+              "additionalProperties": {
+                "additionalProperties": false,
+                "properties": {
+                  "applicable": {
+                    "$ref": "#/properties/range/anyOf/0/properties/days"
+                  },
+                  "failed": {
+                    "$ref": "#/properties/range/anyOf/0/properties/days"
+                  }
+                },
+                "type": "object"
+              },
+              "type": "object"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "runDate": {
+          "$ref": "#/properties/siteUrl"
+        },
+        "runId": {
+          "$ref": "#/properties/siteUrl"
+        },
+        "score": {
+          "$ref": "#/properties/range/anyOf/0/properties/days"
+        },
+        "scoreFeed": {
+          "$ref": "#/properties/range/anyOf/0/properties/days"
+        },
+        "scorePage": {
+          "$ref": "#/properties/range/anyOf/0/properties/days"
+        },
+        "scoreVersion": {
+          "$ref": "#/properties/siteUrl"
+        },
+        "startedAt": {
+          "$ref": "#/properties/siteUrl"
+        },
+        "status": {
+          "$ref": "#/properties/siteUrl"
+        }
+      },
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
    • addedOutput schema / properties / truncationReason
      Added value: +{
+  "$ref": "#/properties/siteUrl"
+}
  4. First observed

TDQS

A4.6/5.0
Behavior5/5

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

Annotations only give readOnlyHint=false, openWorldHint=true, destructiveHint=false. The description goes far beyond: it is enqueue-only, execution happens in the GSC Wizard worker (minutes for the feed plane, potentially hours for the politeness-bounded crawl), notConfigured is a non-error result with a specific cause ("gmc_on_other_account"), and full access on a shared property is required.

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 core action and check inventory, then failure/rate-limit/return semantics in descending priority. It is dense and includes some very long run-on sentences, but almost every clause carries operational information an agent needs rather than 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, asynchronous, rate-limited tool with an output schema present, the description covers the full lifecycle an agent needs: enqueue behavior, refusal cases, override rules, polling target, and configuration prerequisites. Return-value formatting is correctly left to the output schema.

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?

Schema description coverage is 100%, so the schema already documents both parameters fully. The description's force guidance (override the 28-day cadence, cannot bypass one-per-day) restates what the schema's force description already says. Baseline 3 is appropriate since the description adds little parameter-level meaning beyond the schema.

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 verb ("Queues") and resource ("Merchant Center feed audit") and then enumerates exactly what the audit covers: 21 deterministic catalog checks plus a page crawl rolled into a 0-100 Feed Score. An agent can immediately distinguish this from the sibling get_feed_audit_results, which is explicitly named as the polling counterpart.

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?

Explicit routing: use this to enqueue, then "Poll get_feed_audit_results with the returned runDate for status and the score." It states when a queue attempt is refused (enqueued:false + skipReason), how to override the cadence (force: true), which rule cannot be overridden, and the 3-per-24h rate limit. Nothing is left to inference.

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 toolsInspect
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