google-search-console-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOG_LEVEL | No | Log level: debug, info, warn, error | info |
| GSC_SITE_URL | No | Optional default property, e.g. https://example.com/ or sc-domain:example.com | |
| GSC_CLIENT_ID | No | OAuth client ID | |
| GSC_ACCESS_TOKEN | No | Alternative short-lived access token; expires within the hour | |
| GSC_CLIENT_SECRET | No | OAuth client secret | |
| GSC_REFRESH_TOKEN | No | Refresh token obtained from the OAuth consent flow |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| gsc_list_sitesA | List all Google Search Console properties accessible with the current credentials. |
| gsc_get_siteA | Get one Search Console property and its exact permission level (read-only sites.get). |
| gsc_health_checkA | Verify Google Search Console read-only authentication, visible properties, configured default site, and permission levels without exposing tokens. |
| gsc_query_search_analyticsB | Query Google Search Console Search Analytics. Returns clicks, impressions, CTR, and average position for queries, pages, countries, devices, dates, and search appearances. Use gsc://metrics, gsc://dimensions, gsc://filters, and gsc://compatibility for available fields and rules. |
| gsc_inspect_urlB | Inspect a URL for Google indexing status, crawl info, mobile usability, AMP, and rich results. Quota: 2000 requests/day/property. |
| gsc_bulk_inspect_urlsA | Inspect multiple URLs with a conservative sequential limit and normalized URL Inspection results. Quota: 2000 requests/day/property. |
| gsc_list_sitemapsA | List sitemaps submitted for a Search Console property, including processing status and submitted/indexed counts. |
| gsc_get_sitemapA | Get one submitted sitemap by full feed path, including type, fetch state, warnings/errors, and submitted/indexed content totals. |
| gsc_get_sitemap_healthA | Return an enriched read-only sitemap health summary with status totals, submitted/indexed content counts, warnings, and errors. |
| gsc_compare_search_typesB | Compare performance across Search Console search types: web, image, video, news, discover, and Google News. |
| gsc_get_data_freshnessA | Detect the most recent date with Search Analytics data by querying recent daily rows. |
| gsc_monitor_indexation_freshnessB | Read-only monitoring snapshot for Search Analytics freshness, sitemap indexation totals, and an optional small URL Inspection sample. |
| gsc_track_sitemap_deltasA | Read-only sitemap delta tracker. Fetches the current sitemap snapshot and compares it to an agent-provided baseline; no state is written. |
| gsc_analyze_search_appearance_trendsA | Analyze structured data and rich-result trend signals via the Search Analytics searchAppearance dimension when GSC exposes it. |
| gsc_plan_large_site_samplingA | Build a read-only URL Inspection sampling plan for large sites from sitemap risk signals and Search Analytics page performance. |
| gsc_indexation_watchlistA | Read-only URL Inspection watchlist for critical URLs. Inspects up to 10 URLs and returns alert/review/ok assessments without storing state. |
| gsc_find_losses_gainsA | Compare two periods for query or page performance and return click/impression/CTR/position deltas. |
| gsc_cluster_queriesA | Cluster Search Console queries by simple tokens and intent signals: brand/non-brand, question, category, and topic tokens. |
| gsc_detect_cannibalizationA | Detect queries where multiple pages compete for clicks/impressions in Search Analytics query-page rows. |
| gsc_validate_queryA | Validate a Search Console metric/dimension/search type combination before executing it. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| gsc-manifest | |
| gsc-recipes | |
| gsc-metrics | |
| gsc-dimensions | |
| gsc-filters | |
| gsc-compatibility | |
| gsc-p2-readonly-playbooks |
TDQS
Scored across 20 tools
Most tools have distinguishable purposes, but there is notable overlap in the monitoring/health cluster (get_sitemap_health, monitor_indexation_freshness, get_data_freshness, track_sitemap_deltas) and the URL-inspection cluster (inspect_url, bulk_inspect_urls, indexation_watchlist, plan_large_site_sampling). The analytics-derived tools (compare_search_types, find_losses_gains, cluster_queries, detect_cannibalization) also blur together since they all wrap Search Analytics. Descriptions help, but boundaries require careful reading.
Every tool uses a uniform gsc_ prefix with snake_case and a predictable verb_noun pattern (list_sites, get_site, inspect_url, list_sitemaps, query_search_analytics). No convention mixing or vague one-word names.
20 tools is on the heavy side for a read-only Search Console surface. Several tools are thin analytical wrappers or overlapping monitors that could be consolidated, suggesting feature sprawl rather than a tightly scoped set.
Coverage is broad for a read-only server: sites, analytics, URL inspection, sitemaps, and multiple analytical views. Write operations (sitemap submission, site add/remove) are absent, but these are outside the stated read-only scope, leaving only minor gaps.