GSC Wizard MCP Server

List Search Console properties connected to the account.

{}

No arguments. Start here to get the siteUrl values the other tools expect.

Profile, connected Google accounts, and subscription state.

{}

No arguments.

Runs the whole analysis suite for a property in one call and returns a complete, self-contained HTML report (overview, top queries/pages, countries & devices, CTR curve, opportunities, ranking changes, decay, cannibalization, sections, coverage, sitemaps). Much faster than calling each tool separately.

{
  "siteUrl": "sc-domain:example.com",
  "days": 28,
  "format": "html"
}

days defaults to 28 (7-180). format: "html" (default, ready-to-open report) or "json" (raw data bundle). includeSitemap defaults to true.

Ad-hoc searchAnalytics.query against a property. The most flexible read tool.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "dimensions": [
    "query",
    "page"
  ],
  "rowLimit": 1000,
  "filters": [
    {
      "dimension": "country",
      "operator": "equals",
      "expression": "usa"
    }
  ]
}

startDate/endDate, dimensions, rowLimit (defaults to 1000, uncapped; the live-API path auto-paginates past 25000), searchType, startRow, and filters are all optional. Omit the dates for the last 28 settled days.

Last-N-days totals plus a prior-period comparison.

{
  "siteUrl": "sc-domain:example.com",
  "days": 28
}

days defaults to 28 (max 180).

Run the URL Inspection API for one URL and persist the result to history.

{
  "siteUrl": "sc-domain:example.com",
  "inspectionUrl": "https://example.com/blog/post"
}

Remaining URL inspections available today for a property.

{
  "siteUrl": "sc-domain:example.com"
}

Saved filter presets, optionally restricted to one property.

{
  "siteUrl": "sc-domain:example.com"
}

siteUrl is optional; omit it to list every saved filter on the account.

Topic clusters defined for a property.

{
  "siteUrl": "sc-domain:example.com"
}

Content groups and their URL-matching rules for a property.

{
  "siteUrl": "sc-domain:example.com"
}

Sitemaps submitted to Search Console for a property.

{
  "siteUrl": "sc-domain:example.com"
}

Persisted URL inspection history (paginated).

{
  "siteUrl": "sc-domain:example.com",
  "urlContains": "/blog/",
  "limit": 100
}

urlContains is optional; limit defaults to 100 (max 500).

Top search queries by clicks for a date range.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "limit": 100
}

limit defaults to 100, uncapped (pull the whole property if you want); searchType defaults to "web". startDate/endDate are optional: omit them for the last 28 settled days.

Top landing pages by clicks for a date range.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "limit": 100
}

limit defaults to 100, uncapped (pull the whole property if you want); searchType defaults to "web". startDate/endDate are optional: omit them for the last 28 settled days.

Per-country clicks/impressions breakdown.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "limit": 100
}

limit defaults to 100, uncapped. startDate/endDate are optional: omit them for the last 28 settled days.

DESKTOP / MOBILE / TABLET split for a date range.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28"
}

startDate/endDate are optional: omit them for the last 28 settled days.

Chart annotations (platform, account, or property scope).

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-01-01",
  "endDate": "2026-05-28"
}

All fields optional; omit siteUrl for account-wide annotations.

Confirmed Google ranking updates from the status feed.

{
  "startDate": "2026-01-01",
  "endDate": "2026-05-28"
}

Both dates optional; omit for the full history.

IndexNow submission history for a property.

{
  "siteUrl": "sc-domain:example.com",
  "limit": 100
}

limit defaults to 100 (max 500).

Daily clicks/impressions/CTR/position for a single URL.

{
  "siteUrl": "sc-domain:example.com",
  "pageUrl": "https://example.com/blog/post",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28"
}

Daily metrics for a single query, optionally on one URL.

{
  "siteUrl": "sc-domain:example.com",
  "query": "seo tools",
  "pageUrl": "https://example.com/blog/post",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28"
}

pageUrl is optional; omit it to measure the query site-wide.

New, lost, improved, and declined queries (or pages) between two periods.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "comparisonStartDate": "2026-04-01",
  "comparisonEndDate": "2026-04-28",
  "dimension": "query",
  "limit": 50
}

dimension is "query" or "page" (default query); limit defaults to 50, uncapped.

Queries or pages losing clicks vs a baseline period, bucketed severe / moderate / mild.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "comparisonStartDate": "2026-02-01",
  "comparisonEndDate": "2026-02-28",
  "dimension": "page",
  "minImpressions": 100
}

start/end is the recent period; comparison* is the earlier baseline. dimension defaults to "page".

Per-query or per-page matrix of clicks/impressions/position broken down by month or week (the app's Query Decay / Content Decay heatmap).

{
  "siteUrl": "sc-domain:example.com",
  "dimension": "query",
  "granularity": "month",
  "metric": "clicks",
  "months": 16,
  "limit": 50
}

Defaults to the last 16 complete months. granularity "month" or "week"; metric clicks/impressions/position/ctr. Each row has a `values` array aligned to `periods`. Pass startDate/endDate to override the window.

Queries where two or more pages compete, scored by impression-split entropy.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "minImpressions": 10
}

minImpressions defaults to 10; limit defaults to 100, uncapped.

Actual CTR by position bucket (1-20) vs industry benchmarks (AWR, First Page Sage, Sistrix, Backlinko).

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "minImpressions": 10,
  "benchmarkSource": "all"
}

benchmarkSource: awr | firstPageSage | sistrix | backlinko | all (default all). CTR values are percentages (0-100) and deltas are percentage points; a negative delta means the bucket underperforms that benchmark.

Queries ranking just outside the top, with estimated click upside if pushed to a target position.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "minPosition": 4,
  "maxPosition": 20,
  "targetPosition": 3,
  "fallbackBenchmark": "awr"
}

Click upside uses the property's OWN CTR curve at targetPosition; fallbackBenchmark (awr | firstPageSage | sistrix | backlinko, default awr) is used only where the site has no data. Response reports targetCtr and ctrSource ("own" or the benchmark key). Position band and target are tunable; limit defaults to 100, uncapped.

Impression-weighted opportunity score favoring high-impression queries near the top of page two.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "minImpressions": 10
}

Considers positions 3-30; limit defaults to 100, uncapped.

Aggregates page performance by host + first folder segment(s).

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "depth": 1
}

depth (1-4) controls how many path segments form each group; limit defaults to 100, uncapped.

Estimates the share of clicks/impressions GSC hides via anonymization (query and page dimensions).

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28"
}

Only the live-API path reveals true sampling; the warehouse is unsampled (see the response note).

Fetches a sitemap, extracts its URLs, and joins each with GSC clicks/impressions/position.

{
  "siteUrl": "sc-domain:example.com",
  "sitemapUrl": "https://example.com/sitemap.xml",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "maxUrls": 500
}

The sitemap host must belong to the property. One level of sitemap-index expansion; maxUrls caps the join (defaults to 500, uncapped).

Last-N-days clicks/impressions across all your properties (optionally one tag), with per-site totals.

{
  "days": 28,
  "tag": "client-a"
}

tag is optional; days defaults to 28 (max 180); maxSites is optional with no hard cap: omit it to include ALL matched properties, or pass a number to cap how many are processed.

Every tag on the account (global + property tags) with the number of properties carrying each.

{
  "includeSites": false
}

includeSites defaults to false; set true to also list the property URLs under each tag.

Aggregated cross-site report for all properties carrying a tag (the /group/tag dashboard): totals + comparison, daily trend, per-site totals, and merged top queries/pages/countries/devices.

{
  "tag": "client-a",
  "days": 28,
  "dimensions": [
    "query",
    "page",
    "country",
    "device"
  ],
  "limit": 100
}

days defaults to 28 (max 180); searchType defaults to "web"; dimensions defaults to all four; limit defaults to 100 (max 1000); maxSites is optional with no hard cap: omit it to include ALL tagged properties, or pass a number to cap.

Indexing Tracker config and a status summary (indexed / not-indexed / pending / errors / warnings).

{
  "siteUrl": "sc-domain:example.com"
}

Returns tracker: null when no tracker is configured for the property.

Paginated list of tracked URLs with their latest indexing status, filterable and searchable.

{
  "siteUrl": "sc-domain:example.com",
  "filter": "warnings",
  "search": "/blog/",
  "page": 1,
  "pageSize": 50
}

filter: all | indexed | not_indexed | pending | errors | warnings. pageSize max 1000 (default 50); page is one-based.

Indexing health report: score, coverage breakdown, crawl freshness, lost and newly-indexed pages.

{
  "siteUrl": "sc-domain:example.com",
  "days": 30
}

days defaults to 30 (max 90).

Every Google Analytics 4 property your connected Google accounts can read, and which GSC Wizard sites each is linked to.

{}

No arguments. connected: false means the Google Analytics consent has not been granted in the GSC Wizard app yet. linkedSiteUrls covers only the sites of the GSC Wizard account the connection is authenticated as (returned as account), so a property linked from another account of yours shows an empty list.

GA4 traffic summary (sessions, users, engagement rate, key events, and more) for the GA4 property linked to a site, always with a previous-period comparison.

{
  "siteUrl": "sc-domain:example.com",
  "includeTimeseries": false
}

GA4 must be linked to the site in the GSC Wizard app; otherwise a notConfigured explanation is returned, naming in account which GSC Wizard account it was resolved against (links are per account). Dates and the comparison window are optional; includeTimeseries adds daily points.

One GA4 dimension breakdown per call: channel, sourceMedium, page, landingPage, country, device, or event, each with its own metric set.

{
  "siteUrl": "sc-domain:example.com",
  "dimension": "landingPage",
  "limit": 25
}

GA4 must be linked to the site in the GSC Wizard app. filters and a comparison range are optional; limit defaults to 50 (max 1000).

GA4 ecommerce performance: revenue/transactions summary plus channel, source, page, landing-page, and product breakdowns.

{
  "siteUrl": "sc-domain:example.com",
  "limit": 25
}

GA4 must be linked to the site in the GSC Wizard app. hasEcommerce is false when the property shows no ecommerce activity; revenue is in the property currency (currencyCode).

Sessions, engagement, conversions and revenue referred by ChatGPT, Perplexity, Copilot, Gemini, Claude and other AI assistants, with their share of total traffic.

{
  "siteUrl": "sc-domain:example.com",
  "includeDailySplit": false,
  "limit": 25
}

GA4 must be linked to the site in the GSC Wizard app. Google AI Overviews traffic carries no distinct referrer and is NOT included. includeDailySplit adds a per-assistant daily sessions series.

Segments GA4 on ONE key event (conversion): totals, conversion rates, and per channel/source/landing page/page/country/device breakdowns.

{
  "siteUrl": "sc-domain:example.com",
  "keyEvent": "form_submit",
  "limit": 25
}

GA4 must be linked to the site in the GSC Wizard app. Omit keyEvent to auto-pick the most active one; the response lists every available key event name.

Joins Search Console (clicks, impressions, CTR, position) with GA4 (sessions, bounce rate, key events, revenue) per landing page.

{
  "siteUrl": "sc-domain:example.com",
  "organicOnly": true,
  "limit": 50,
  "dateGranularity": "none"
}

GA4 must be linked to the site in the GSC Wizard app. organicOnly (default true) limits GA4 metrics to google / organic sessions so both sides describe the same traffic. dateGranularity ("day" / "week" / "month") returns a time series instead of one aggregate: every row carries the period start as date, limit applies per period, and the prev* fields compare each period against the one before it (so it cannot be combined with an explicit comparison range).

Estimates GA4 sessions, key events, and revenue per Search Console query via proportional click share over the query→page→landing-page join.

{
  "siteUrl": "sc-domain:example.com",
  "organicOnly": true,
  "limit": 1000,
  "dateGranularity": "none"
}

GA4 must be linked to the site in the GSC Wizard app. Estimates, not measured revenue: page-level click-share attribution; matchedClickShare reports coverage; estRevenue only when the GA4 property records revenue. dateGranularity ("day" / "week" / "month") returns a time series instead of one aggregate — the way to chart estimated revenue from non-branded queries month by month — with every row carrying the period start as date and limit applying per period.

List the sites verified in your linked Bing Webmaster Tools account.

{}

No arguments. Returns notConfigured: true when no Bing Webmaster API key is set up in the GSC Wizard app.

Daily Bing clicks and impressions for a property (roughly the last 6 months).

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28"
}

startDate/endDate optional; omit both for everything Bing has (~6 months).

Top Bing search queries for a property (clicks, impressions, CTR, position).

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "limit": 100
}

Dates optional (omit for ~6 months); limit defaults to 100, uncapped.

Top Bing landing pages for a property (clicks, impressions, CTR, position).

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "limit": 100
}

Dates optional (omit for ~6 months); limit defaults to 100, uncapped.

Bing query + landing-page pairs for a property (which query drives each page).

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "limit": 100
}

Dates optional (omit for ~6 months); limit defaults to 100, uncapped.

Bing's daily crawl stats: pages crawled/indexed, inbound links, and response-code breakdown.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28"
}

startDate/endDate optional; omit both for everything Bing has (~6 months).

URLs where Bing found crawl issues (4xx/5xx, redirects, robots blocks, malware), with decoded labels.

{
  "siteUrl": "sc-domain:example.com",
  "limit": 200
}

limit defaults to 200, uncapped; results are ordered by inbound-link count.

Inbound (backlink) counts per URL recorded by Bing, paginated (~100 rows per page).

{
  "siteUrl": "sc-domain:example.com",
  "page": 0
}

page defaults to 0; the response includes totalPages so you can paginate.

Bing's historical impression volume for a single keyword (weekly), plus broad-match impressions.

{
  "keyword": "seo tools",
  "country": "us",
  "language": "en-US"
}

Marketplace demand data, not tied to a property (no siteUrl). country defaults to "us", language to "en-US".

Sitemaps/feeds submitted to Bing for a property, with decoded status, type, dates and URL counts.

{
  "siteUrl": "sc-domain:example.com"
}

Remaining Bing URL-submission quota (daily and monthly) for a property.

{
  "siteUrl": "sc-domain:example.com"
}

Flags statistically anomalous days (spikes/drops) for a metric, scored by severity.

{
  "siteUrl": "sc-domain:example.com",
  "metric": "clicks",
  "days": 90,
  "sensitivity": 3.5
}

metric: clicks | impressions | ctr | position (default clicks). days >= 21 (default 90). Lower sensitivity = more anomalies.

Finds dates where clicks or impressions shifted to a new sustained level (step changes).

{
  "siteUrl": "sc-domain:example.com",
  "metric": "clicks",
  "days": 180,
  "sensitivity": 2
}

metric: clicks | impressions. days >= 14 (default 180). Reports before/after means and % change.

Projects future clicks/impressions via seasonal decomposition + an auto-selected trendline.

{
  "siteUrl": "sc-domain:example.com",
  "metric": "clicks",
  "granularity": "weekly",
  "forecastPeriods": 26
}

Weekly needs >= 13 weeks, monthly >= 6 months. Optional growthRate, cvr + aov (for revenue), trendlineType.

Segments pages into Head / Chunky Middle / Long Tail tiers by elbow detection on cumulative clicks.

{
  "siteUrl": "sc-domain:example.com",
  "preset": "default",
  "pagesPerCluster": 10
}

preset: default | content | ecommerce | small_site | enterprise. Optional sensitivity and includeZeroClicks.

Chrome UX Report field data: weekly Core Web Vitals (LCP, INP, CLS) + FCP/TTFB with ratings and regressions.

{
  "siteUrl": "sc-domain:example.com",
  "formFactor": "ALL"
}

Needs a CrUX API key configured in the app. Pass a `url` to measure a single page; formFactor: ALL | PHONE | DESKTOP | TABLET.

Lists the SEO experiments (split tests) defined for a property, with their URL groups.

{
  "siteUrl": "sc-domain:example.com",
  "includeArchived": false
}

Scores one experiment: control vs variant click growth with a significance test, uplift CI, and winner.

{
  "siteUrl": "sc-domain:example.com",
  "experimentId": "00000000-0000-0000-0000-000000000000",
  "confidenceLevel": 0.95
}

Group 0 is the control. The comparison window defaults to the prior same-length period.

Before/after A-vs-B comparison for a migration: daily trend, per-side totals, query/page winners & losers.

{
  "mode": "cross-property",
  "siteUrl": "sc-domain:old.com",
  "siteUrlB": "sc-domain:new.com",
  "limit": 50
}

mode: cross-property (siteUrl + siteUrlB) | two-urls (urlPrefixA + urlPrefixB) | regex (regexA + regexB). Both sides share one date window.

Crawls pages and runs a technical on-page audit per URL (indexability, titles, canonical, links, structured data, issues).

{
  "siteUrl": "sc-domain:example.com",
  "maxUrls": 10
}

Pass explicit `urls` (must belong to the property) or omit to audit top pages by impressions. Fetches each page live; keep the count modest.

Measures your saved content groups: clicks, impressions, CTR, average position, page count and share of clicks per group, plus an "uncategorized" bucket. Pass groupId to drill into the top pages of one group.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-01-01",
  "endDate": "2026-01-31"
}

Groups are created in the app or with create_content_group. On the warehouse path the totals cover EVERY page of the property, not just the top N. Matching is first-match-wins in the saved order of the groups.

Measures your saved topic clusters over queries: clicks, impressions, CTR, average position, matched query count and share of clicks per cluster, plus an "unclustered" bucket. Pass clusterId to drill into the top queries of one cluster.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-01-01",
  "endDate": "2026-01-31"
}

Clusters may OVERLAP: a query matching two clusters counts fully in both, so cluster totals do not sum to the property total (overlappingQueries reports how many are double-counted).

Splits a property into branded and non-branded search: totals, branded share of clicks, a daily trend for both sides, and the top queries on each side.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-01-01",
  "endDate": "2026-01-31",
  "limit": 25
}

Driven by the branded keywords saved on the property (set them with update_site). A keyword wrapped in slashes, like /acme ?corp/, is a regex; otherwise it is a case-insensitive substring. Returns notConfigured when none are set.

Slices a property by where it ranks, in 1-3 / 4-10 / 11-20 / 21+ bands: impressions and clicks per band over the range, or the count of distinct queries ranking in each band day by day.

{
  "siteUrl": "sc-domain:example.com",
  "granularity": "period",
  "dimension": "query"
}

granularity: "period" (default, bucket totals) or "daily" (distinct queries per band per day, always keyed on query). Positions are impression-weighted averages, so a row sits in exactly one band.

GA4 error pages for the property linked to a site, broken down by page title AND URL: sessions, page views, active users and bounce rate.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-01-01",
  "endDate": "2026-01-31"
}

GA4 has no native 404 signal, so error pages are matched against the page-title patterns saved for the site in the app. Pass titleFilters (e.g. [{ operator: "contains", value: "404" }]) to override them for one call.

Lists the shareable reports saved on your account, each with its view URL and the clients currently granted access.

{
  "limit": 50
}

Use it to find a reportId for manage_report_access or delete_shared_report, or to audit who can see which report.

Lists the client contacts on your account: the people who can be granted access to a shareable report.

{
  "limit": 100
}

A client is an email address plus an optional name; they sign in with it to view reports shared with them.

Lists the saved redirect mappings (old URL to new URL) behind the Migration Compare workflow, grouped by the A/B property pair and label they belong to.

{
  "summaryOnly": true
}

Filter with label / siteUrlA / siteUrlB. summaryOnly returns just the per-migration counts, which is the right call on a large mapping.

Reports whether an IndexNow API key is configured for a property, masked to its last four characters.

{
  "siteUrl": "sc-domain:example.com"
}

The full key is never returned. submit_indexnow_urls needs a configured key, so check here first when a submission fails.

Classifies queries by shape to surface AI Overviews / AI Mode fingerprints: bare replies, pivot follow-ups, conversational questions, tracker probes, agent harnesses.

{
  "siteUrl": "sc-domain:example.com",
  "examplesPerBucket": 10
}

Heuristic pattern matching in 27 languages; it judges how a query looks, not what the searcher meant. Pass buckets: ["reply_artefact","pivot_follow_up","conversational_question"] for just the AI-conversation shapes.

Monthly (or weekly) clicks + impressions split into AI-shaped vs conventional queries, with the AI-shaped share of each metric.

{
  "siteUrl": "sc-domain:example.com",
  "months": 12,
  "granularity": "month"
}

Answers "are AI Mode / AI Overviews queries growing on this site?". Defaults to the last 12 complete months (max 16, GSC retention).

Search Console performance for one search appearance (default MERCHANT_LISTINGS): the appearance inventory, a daily timeline, and the top product pages behind it.

{
  "siteUrl": "sc-domain:example.com",
  "appearance": "MERCHANT_LISTINGS",
  "limit": 25
}

Always live Search Console API: search appearance is never warehoused and cannot be grouped with another dimension, only filtered on. It counts enriched product results in web Search only, so it does not reconcile with Merchant Center free-listing numbers, which also cover the Shopping tab, Images, Lens, YouTube and Maps. Shopping is in limited release: the tool is enabled for allowlisted accounts only while the feature is staged, and does not appear in tools/list for other accounts.

Every Google Merchant Center account your connected Google accounts can read, and which GSC Wizard sites each is linked to.

{
  "siteUrl": "sc-domain:example.com"
}

siteUrl is optional and only adds the linkedAccountId for that property. connected: false means the Merchant Center consent has not been granted in the GSC Wizard app yet. isAdvanced: true marks a multi-client parent, which cannot be reported on directly: link one of its sub-accounts. Shopping is in limited release: the tool is enabled for allowlisted accounts only while the feature is staged, and does not appear in tools/list for other accounts.

Organic (free listing) product performance from the linked Merchant Center account: daily clicks / impressions / conversions plus the top offers, groupable by brand, category or product type.

{
  "siteUrl": "sc-domain:example.com",
  "groupBy": "offer",
  "limit": 25
}

Covers every free surface (Shopping tab, Search, Images, Lens, YouTube, Maps), so it does not reconcile with the web-Search-only merchant listings numbers from get_merchant_listings_performance. Conversions need a Merchant Center conversion source. Organic excludes YouTube affiliate traffic from 1 July 2026 onward. Shopping is in limited release: the tool is enabled for allowlisted accounts only while the feature is staged, and does not appear in tools/list for other accounts.

Free-listing eligibility and item issues per product, sorted by click potential: which products are invisible in free listings, and why.

{
  "siteUrl": "sc-domain:example.com",
  "onlyProblems": true,
  "limit": 25
}

clickPotentialRank 1 is the product Google expects the most clicks from, so a disapproved product ranked low in number is the most expensive problem. topIssueResolution MERCHANT_ACTION needs a feed or site fix; PENDING_PROCESSING clears on its own. Shopping is in limited release: the tool is enabled for allowlisted accounts only while the feature is staged, and does not appear in tools/list for other accounts.

Merchant Center competitive visibility for one country / category / traffic-source cell: daily competitor rows with a per-domain roll-up, a per-domain window aggregate (top_merchant), or your visibility trend against the category benchmark.

{
  "siteUrl": "sc-domain:example.com",
  "view": "competitor",
  "countryCode": "US",
  "categoryId": "166",
  "trafficSource": "ORGANIC",
  "limit": 50
}

countryCode and categoryId are both required: the Merchant API answers one cell per request. relativeVisibility, adsOrganicRatio, pageOverlapRate, higherPositionRate and both trends are 0-1 fractions (0.12 = 12%), not the 0-100 ctr percentage; the trends are relative to the start of the window. Shopping is in limited release: the tool is enabled for allowlisted accounts only while the feature is staged, and does not appear in tools/list for other accounts.

Merchant Center price competitiveness and sale-price suggestions joined per product: your price against the market benchmark (priceGapFraction) and Google's suggested price with the predicted impressions / clicks / conversions change.

{
  "siteUrl": "sc-domain:example.com",
  "sort": "opportunity",
  "limit": 100
}

Both views are dateless snapshots of the current catalog; snapshotDate is the UTC day of the call. predicted*ChangeFraction, priceGapFraction and suggestedChangeFraction are 0-1 fractions (0.12 = +12%), not the 0-100 ctr percentage. Benchmarks need valid GTINs and suggestions need conversion reporting, so an empty result usually means "not eligible". Shopping is in limited release: the tool is enabled for allowlisted accounts only while the feature is staged, and does not appear in tools/list for other accounts.

Google's best sellers ranking for one country from Merchant Center: top product clusters or brands per category with rank, previous rank, relative demand and, for clusters, a demandGap flag when you do not stock a ranked cluster.

{
  "siteUrl": "sc-domain:example.com",
  "view": "product_cluster",
  "granularity": "WEEKLY",
  "countryCode": "US",
  "limit": 100
}

Omit reportDate for the newest published report (reports lag up to two weeks) and read reportDate back; a WEEKLY date must be a Monday, a MONTHLY one the 1st. inventoryStatus ignores the report country, so demandGap is an account-wide signal. Shopping is in limited release: the tool is enabled for allowlisted accounts only while the feature is staged, and does not appear in tools/list for other accounts.

Results of the Merchant Center feed audit: the latest run (or one runDate) with its status, Feed Score (0-100, split into feed and page planes), failure counts by severity, per-check applicable / failed / passed counts with pass rates, crawl coverage, and the score history of earlier runs.

{
  "siteUrl": "sc-domain:example.com",
  "limit": 100
}

coverage, passRate and failRate are 0-1 fractions (0.12 = 12%), not the 0-100 ctr percentage. checkKey narrows the checks list; the per-offer issue rows behind checkKey or severity live in the ClickHouse warehouse this server cannot read, so those calls answer issuesAvailable: false and point at the Feed Audit report in the app. run: null means no audit has run yet. Shopping is in limited release: the tool is enabled for allowlisted accounts only while the feature is staged, and does not appear in tools/list for other accounts.

Title and description hygiene of the linked Merchant Center catalog: title and description length histograms, missing descriptions, mean and median title length, duplicate-title groups, offers repeating a word, and the most frequent title words with brand tokens flagged.

{
  "siteUrl": "sc-domain:example.com",
  "limit": 2000,
  "topWords": 50
}

A catalog snapshot with no date range, computed over the first `limit` products of the live products list (default 2000, max 5000); truncated: true means the catalog had more and the summary describes a sample. topWords[].share is a 0-1 fraction of the sampled offers, not the 0-100 ctr percentage; lengths are in characters, CJK titles included (cjkNote). The feed-versus-page title diff lives only in the app report. Shopping is in limited release: the tool is enabled for allowlisted accounts only while the feature is staged, and does not appear in tools/list for other accounts.

Register a GSC property in GSC Wizard. The property must already exist in your Search Console account.

{
  "siteUrl": "sc-domain:example.com",
  "tags": [
    "client-a"
  ]
}

tags are optional.

Create new URL-prefix properties in Google Search Console (e.g. folder-level properties) and register them in GSC Wizard. Auto-verified if the parent domain is owned. Use add_site instead for properties that already exist in GSC.

{
  "parentSiteUrl": "sc-domain:example.com",
  "propertyUrls": [
    "https://example.com/blog/",
    "https://example.com/docs/"
  ]
}

parentSiteUrl must be an existing registered property whose Google account owns the domain. register defaults to true; up to 50 URLs.

Edit tags, branded keywords, or sitemap URLs on a registered property.

{
  "siteUrl": "sc-domain:example.com",
  "tags": [
    "client-a",
    "priority"
  ],
  "brandedKeywords": [
    "example",
    "example brand"
  ],
  "sitemapUrls": [
    "https://example.com/sitemap.xml"
  ]
}

Pass only the fields you want to change.

Create, assign, unassign, rename, or delete property tags across the account (the tag side of the /group/tag dashboard).

{
  "action": "assign",
  "tag": "client-a",
  "siteUrls": [
    "sc-domain:example.com",
    "https://example.org/"
  ]
}

action: create | assign | unassign | rename | delete. siteUrls is required for assign/unassign; newName is required for rename. rename and delete apply across every property and the global tag list.

Unregister a property. Cascades to its clusters, groups, filters, inspections, and annotations.

{
  "siteUrl": "sc-domain:example.com",
  "confirm": true
}

confirm must be true; this is irreversible.

Create a topic cluster of keywords on a property.

{
  "siteUrl": "sc-domain:example.com",
  "name": "Pricing",
  "keywords": [
    "pricing",
    "cost",
    "plans"
  ]
}

Idempotent: an existing name returns that cluster with alreadyExisted: true, not an error.

Delete a topic cluster by id.

{
  "clusterId": "00000000-0000-0000-0000-000000000000"
}

Create a content group partition. Rules match URLs by prefix / contains / regex / equals.

{
  "siteUrl": "sc-domain:example.com",
  "name": "Blog",
  "rules": [
    {
      "type": "prefix",
      "value": "https://example.com/blog/"
    }
  ]
}

color and description are optional; up to 50 rules.

Delete a content group by id.

{
  "groupId": "00000000-0000-0000-0000-000000000000"
}

Save a reusable filter preset for a property.

{
  "siteUrl": "sc-domain:example.com",
  "name": "Non-branded, mobile",
  "filters": {
    "device": "MOBILE",
    "excludeBranded": true
  }
}

filters is a free-form object matching the dashboard filter shape.

Delete a saved filter by id.

{
  "filterId": "00000000-0000-0000-0000-000000000000"
}

Add a chart annotation on a date (e.g. a release or campaign marker).

{
  "siteUrl": "sc-domain:example.com",
  "eventDate": "2026-05-15",
  "label": "Site redesign launched",
  "description": "New template rolled out across the blog.",
  "color": "#2563eb"
}

Omit siteUrl for an account-wide annotation; description, category, color optional.

Delete a chart annotation by id.

{
  "annotationId": "00000000-0000-0000-0000-000000000000"
}

Submit up to 100 URLs to IndexNow for the property.

{
  "siteUrl": "sc-domain:example.com",
  "urls": [
    "https://example.com/new-page",
    "https://example.com/updated-page"
  ]
}

The usual 202 response means "accepted, key validation pending", not delivered: participating engines fetch your {key}.txt afterwards and discard the batch without further notice if it is unreachable. Each submission carries a status and an accepted flag, and submitted counts only what IndexNow accepted.

Inspect a list of URLs sequentially and persist each result.

{
  "siteUrl": "sc-domain:example.com",
  "urls": [
    "https://example.com/a",
    "https://example.com/b"
  ]
}

Counts against the daily 2,000-inspection/property quota (shared with the UI); stops and reports skipped URLs once the cap is hit. Pass up to 2,000 URLs.

Add URLs to the Indexing Tracker (creates the tracker if needed). Up to 1,800 URLs per property.

{
  "siteUrl": "sc-domain:example.com",
  "urls": [
    "https://example.com/page-1",
    "https://example.com/page-2"
  ]
}

URLs must belong to the property. New URLs start as "pending"; the hourly cron or check_tracked_url_now inspects them.

Remove URLs from the Indexing Tracker.

{
  "siteUrl": "sc-domain:example.com",
  "urls": [
    "https://example.com/page-1"
  ]
}

Run an immediate URL Inspection for up to 10 tracked URLs and update their status and history.

{
  "siteUrl": "sc-domain:example.com",
  "urls": [
    "https://example.com/page-1"
  ]
}

Counts against the daily 2,000-inspection/property quota; returns a quota message when exhausted.

Edit an existing content group: its name, description, colour, or matching rules.

{
  "groupId": "00000000-0000-0000-0000-000000000000",
  "name": "Blog"
}

Only the fields you pass change. Passing rules REPLACES the whole rule list, so read the current rules with list_content_groups first if you mean to add one.

Edit the name or keyword list of a topic cluster.

{
  "clusterId": "00000000-0000-0000-0000-000000000000",
  "keywords": [
    "seo audit"
  ],
  "mode": "add"
}

mode: "replace" (default, swaps the list), "add" (merges in, deduplicated case-insensitively) or "remove" (deletes the listed keywords).

Rename a saved filter preset and/or replace its filter payload.

{
  "filterId": "00000000-0000-0000-0000-000000000000",
  "name": "Blog, non-branded"
}

The filters payload is replaced wholesale, not merged; read the current value with list_saved_filters first.

Edit a chart annotation you own: its date, label, description, category or colour.

{
  "annotationId": "00000000-0000-0000-0000-000000000000",
  "label": "Redesign launched"
}

Scope cannot be changed (an account-wide annotation cannot be moved onto a property); delete it and create a new one instead.

Save a table of rows as a shareable report and get its URL. Pass the rows from another tool plus the columns describing which fields to show.

{
  "title": "Top queries - January",
  "rows": [
    {
      "query": "seo tools",
      "clicks": 120,
      "impressions": 3400
    }
  ],
  "columns": [
    {
      "key": "query",
      "label": "Query",
      "type": "text"
    },
    {
      "key": "clicks",
      "label": "Clicks",
      "type": "number"
    }
  ]
}

STEP 1 OF 3: the URL opens for nobody (not even you) until access is granted. Then create_report_client, then manage_report_access. Up to 50 reports per account.

Permanently delete a saved shareable report and every client grant on it.

{
  "reportId": "00000000-0000-0000-0000-000000000000"
}

Breaks the shared link for anyone who still has it. Find the id with list_shared_reports.

Add a client contact (an email address plus an optional name) that shareable reports can then be granted to.

{
  "email": "client@example.com",
  "name": "Example Ltd"
}

Sends no email and grants no access on its own. Adding an address that already exists returns the existing client rather than failing.

Grant or revoke client access to a saved shareable report. This is what makes a report openable at all.

{
  "reportId": "00000000-0000-0000-0000-000000000000",
  "action": "grant",
  "clientIds": [
    "00000000-0000-0000-0000-000000000000"
  ]
}

Does NOT send a notification email. Pass the client the report URL (they sign in with their email and the app mails them a login link), or send it from Account > Shared Reports in the app, which has a per-client Resend button.

Show or hide registered properties on your GSC Wizard dashboard. Visibility is also what makes a property usable by the other MCP tools.

{
  "siteUrls": [
    "sc-domain:example.com"
  ],
  "visible": true
}

Showing a property consumes a dashboard slot from your plan and is refused when the limit is reached. Hiding one deletes no data. ClickHouse-synced properties are always shown and consume no slot.

Save redirect mappings (old URL to new URL) for a site migration, tied to the source property A and target property B.

{
  "siteUrlA": "sc-domain:old.com",
  "siteUrlB": "sc-domain:new.com",
  "redirects": [
    {
      "fromUrl": "https://old.com/a",
      "toUrl": "https://new.com/a"
    }
  ],
  "label": "2026-replatform"
}

Rows are APPENDED, never deduplicated against what is already stored, so re-sending the same list stores it twice. Up to 10,000 rows per call.

Delete saved redirect mappings, narrowed by label and/or the A/B property pair.

{
  "label": "2026-replatform"
}

Deleting EVERY mapping on the account requires confirmDeleteAll: true. Preview what would go with list_migration_redirects using the same filters first.

Set, rotate or clear the IndexNow API key for a property.

{
  "siteUrl": "sc-domain:example.com",
  "indexnowApiKey": "a1b2c3d4e5f6a7b8c9d0"
}

The key must be 8-128 characters of letters, digits and hyphens, AND published at https://your-domain/<key>.txt, or submissions are rejected. Pass clear: true to remove it.

Queue a Merchant Center feed audit for a property: 21 deterministic checks over the synced catalog plus a crawl of the product pages on the owner-approved hosts, scored 0-100. Returns a job handle (runDate), never the results.

{
  "siteUrl": "sc-domain:example.com",
  "force": false
}

Enqueues only; the audit runs in the GSC Wizard app worker and a large catalog can take hours to crawl. enqueued: false with a skipReason means a run for today already exists or one completed inside the 28-day cadence (force: true overrides the cadence, never the one-per-day rule). Follow it with get_feed_audit_results. Shopping is in limited release: the tool is enabled for allowlisted accounts only while the feature is staged, and does not appear in tools/list for other accounts.