# Search Console

> Every Search Console tool the MCP server exposes, with its parameters. 18 tools, 4 metrics and 6 dimensions, on a dedicated endpoint.

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources)

Search Analytics, cannibalisation, query clustering, indexation watchlists, sitemaps.

Connection

|  |  |
| --- | --- |
| Platform id | `search_console` |
| Tool prefix | `gsc_` |
| Account parameter | `siteUrl` |
| Dedicated endpoint | https://mcp.getmcpads.com/search-console/mcp |
| Tools | 18, 0 of which write |
| Metrics | 4 |
| Dimensions | 6 |

## Scope requested

| Scope | Grants | Allows writes |
| --- | --- | --- |
| `https://www.googleapis.com/auth/webmasters.readonly` | Read Search Console performance, index coverage and sitemaps. Cannot modify anything. | No |

> **Note** This source is read only. The gateway exposes no write tool for it.

## Catalogues

- [Metrics](https://www.getmcpads.com/docs/sources/search-console/metrics): 4 metrics, with the field name each one maps to.
- [Dimensions](https://www.getmcpads.com/docs/sources/search-console/dimensions): 6 dimensions, with their constraints.

## Read tools (18)

Tools marked *Announced* appear in your client's tool list. The rest are reachable through `search_tools` and `run_tool`, which run the same checks.

| Tool | What it does | Kind | Discovery |
| --- | --- | --- | --- |
| [`gsc_analyze_search_appearance_trends`](https://www.getmcpads.com/docs/sources/search-console/tools/gsc_analyze_search_appearance_trends) | Analyze structured data and rich-result trend signals via the Search Analytics searchAppearance dimension when GSC exposes it. | Read | On demand |
| [`gsc_bulk_inspect_urls`](https://www.getmcpads.com/docs/sources/search-console/tools/gsc_bulk_inspect_urls) | Inspect multiple URLs with a conservative sequential limit and normalized URL Inspection results. | Read | On demand |
| [`gsc_cluster_queries`](https://www.getmcpads.com/docs/sources/search-console/tools/gsc_cluster_queries) | Cluster Search Console queries by simple tokens and intent signals: brand/non-brand, question, category, and topic tokens. | Read | On demand |
| [`gsc_compare_search_types`](https://www.getmcpads.com/docs/sources/search-console/tools/gsc_compare_search_types) | Compare performance across Search Console search types: web, image, video, news, discover, and Google News. | Read | On demand |
| [`gsc_detect_cannibalization`](https://www.getmcpads.com/docs/sources/search-console/tools/gsc_detect_cannibalization) | Detect queries where multiple pages compete for clicks/impressions in Search Analytics query-page rows. | Read | On demand |
| [`gsc_find_losses_gains`](https://www.getmcpads.com/docs/sources/search-console/tools/gsc_find_losses_gains) | Compare two periods for query or page performance and return click/impression/CTR/position deltas. | Read | Announced |
| [`gsc_get_data_freshness`](https://www.getmcpads.com/docs/sources/search-console/tools/gsc_get_data_freshness) | Detect the most recent date with Search Analytics data by querying recent daily rows. | Read | On demand |
| [`gsc_get_sitemap_health`](https://www.getmcpads.com/docs/sources/search-console/tools/gsc_get_sitemap_health) | Return an enriched read-only sitemap health summary with status totals, submitted/indexed content counts, warnings, and errors. | Read | On demand |
| [`gsc_health_check`](https://www.getmcpads.com/docs/sources/search-console/tools/gsc_health_check) | Verify Google Search Console read-only authentication, visible properties, configured default site, and permission levels without exposing tokens. | Read | Announced |
| [`gsc_indexation_watchlist`](https://www.getmcpads.com/docs/sources/search-console/tools/gsc_indexation_watchlist) | Read-only URL Inspection watchlist for critical URLs. | Read | On demand |
| [`gsc_inspect_url`](https://www.getmcpads.com/docs/sources/search-console/tools/gsc_inspect_url) | Inspect a URL for Google indexing status, crawl info, mobile usability, AMP, and rich results. | Read | Announced |
| [`gsc_list_sitemaps`](https://www.getmcpads.com/docs/sources/search-console/tools/gsc_list_sitemaps) | List sitemaps submitted for a Search Console property, including processing status and submitted/indexed counts. | Read | On demand |
| [`gsc_list_sites`](https://www.getmcpads.com/docs/sources/search-console/tools/gsc_list_sites) | List all Google Search Console properties accessible with the current credentials. | Read | Announced |
| [`gsc_monitor_indexation_freshness`](https://www.getmcpads.com/docs/sources/search-console/tools/gsc_monitor_indexation_freshness) | Read-only monitoring snapshot for Search Analytics freshness, sitemap indexation totals, and an optional small URL Inspection sample. | Read | On demand |
| [`gsc_plan_large_site_sampling`](https://www.getmcpads.com/docs/sources/search-console/tools/gsc_plan_large_site_sampling) | Build a read-only URL Inspection sampling plan for large sites from sitemap risk signals and Search Analytics page performance. | Read | On demand |
| [`gsc_query_search_analytics`](https://www.getmcpads.com/docs/sources/search-console/tools/gsc_query_search_analytics) | Query Google Search Console Search Analytics. | Read | Announced |
| [`gsc_track_sitemap_deltas`](https://www.getmcpads.com/docs/sources/search-console/tools/gsc_track_sitemap_deltas) | Read-only sitemap delta tracker. | Read | On demand |
| [`gsc_validate_query`](https://www.getmcpads.com/docs/sources/search-console/tools/gsc_validate_query) | Validate a Search Console metric/dimension/search type combination before executing it. | Read | On demand |

## MCP resources

Read these with `resources/read` for machine readable metadata about the source.

| Name | URI |
| --- | --- |
| gsc-manifest | `gsc://manifest` |
| gsc-recipes | `gsc://recipes` |
| gsc-metrics | `gsc://metrics` |
| gsc-dimensions | `gsc://dimensions` |
| gsc-filters | `gsc://filters` |
| gsc-compatibility | `gsc://compatibility` |
| gsc-p2-readonly-playbooks | `gsc://p2-readonly-playbooks` |

---

This page as HTML: https://www.getmcpads.com/docs/sources/search-console
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.