Google Search Console MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GSC_DEBUG | No | Set to true for verbose debug logging | |
| GSC_DATA_STATE | No | Default data freshness: final, all, or hourly_all (default: all) | |
| GSC_DEFAULT_SITE_URL | No | Default site URL to use when not specified | |
| GSC_OAUTH_TOKEN_PATH | No | Path to store OAuth tokens (default: ~/.gsc-mcp-token.json) | |
| GSC_SERVICE_ACCOUNT_PATH | No | Path to service account JSON file | |
| GSC_OAUTH_CREDENTIALS_PATH | No | Path to OAuth credentials JSON file |
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
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_analyticsB | Query Google Search Console performance data. Supports all dimensions (query, page, country, device, searchAppearance, date), all search types (web, discover, googleNews, news, image, video), regex filters, hourly data, and up to 25K rows per request. IMPORTANT: Base your analysis only on the data returned by this tool. Report exact numbers from the response. Do not speculate about causes the data does not support. If the data is insufficient to answer, say so rather than guessing. |
| compare_periodsA | Compare search performance between two date ranges. Returns delta calculations for clicks, impressions, CTR, and position. Useful for tracking impact of SEO changes, algorithm updates, or seasonal trends. IMPORTANT: Base your analysis only on the data returned by this tool. Report exact numbers from the response. Do not speculate about causes the data does not support. If the data is insufficient to answer, say so rather than guessing. |
| find_opportunitiesA | Automatically identify SEO opportunities: quick wins (position 5-20 with high impressions but low CTR), declining content (pages losing traffic), and emerging queries (new or rapidly growing). Compares recent 7-day window to 28 days prior. IMPORTANT: Base your analysis only on the data returned by this tool. Report exact numbers from the response. Do not speculate about causes the data does not support. If the data is insufficient to answer, say so rather than guessing. |
| inspect_urlA | Inspect a single URL in Google Search Console. Returns index status, mobile usability, rich results, AMP status, canonical information, and last crawl time. Daily quota: 2,000 inspections. IMPORTANT: Base your analysis only on the data returned by this tool. Report exact numbers from the response. Do not speculate about causes the data does not support. If the data is insufficient to answer, say so rather than guessing. |
| batch_inspect_urlsA | Inspect multiple URLs at once. Returns a summary of index status across all URLs with issues highlighted. Rate-limited to respect the 2,000/day quota. Max 100 URLs per call. IMPORTANT: Base your analysis only on the data returned by this tool. Report exact numbers from the response. Do not speculate about causes the data does not support. If the data is insufficient to answer, say so rather than guessing. |
| list_sitemapsA | List all sitemaps submitted for a site in Search Console. Shows status, submission date, error/warning counts, and content type details (URLs submitted vs indexed). IMPORTANT: Base your analysis only on the data returned by this tool. Report exact numbers from the response. Do not speculate about causes the data does not support. If the data is insufficient to answer, say so rather than guessing. |
| submit_sitemapA | Submit a new sitemap to Google Search Console. The sitemap URL must be accessible and return valid XML. |
| delete_sitemapA | Remove a sitemap from Search Console tracking. This does not prevent Google from crawling URLs discovered from this sitemap. |
| list_propertiesA | List all Google Search Console properties accessible to the authenticated account. Shows property type (domain vs URL prefix) and permission level. |
| notify_url_updateA | Submit a URL update or deletion notification to Google via the Indexing API. Note: Officially supported only for pages with JobPosting or BroadcastEvent structured data. Daily quota: 200 notifications. |
| get_indexing_statusA | Check the status of Indexing API notifications for a URL. Shows the most recent update and removal notifications. |
| verify_claimA | Self-check a claim about search performance data before presenting it. Re-queries the Google Search Console API to verify that a specific metric matches the expected value. Use this tool to confirm numbers before stating them in your analysis, especially for claims from earlier in the conversation. IMPORTANT: Base your analysis only on the data returned by this tool. Report exact numbers from the response. Do not speculate about causes the data does not support. If the data is insufficient to answer, say so rather than guessing. |
| diagnose_traffic_dropsA | Find pages that lost traffic and diagnose why. Categorizes each drop as: ranking loss (position got worse), CTR collapse (position held but CTR dropped — possible SERP feature changes), or demand decline (search impressions dropped — seasonality or trend shift). Compares recent 7-day window to 28 days prior. IMPORTANT: Base your analysis only on the data returned by this tool. Report exact numbers from the response. Do not speculate about causes the data does not support. If the data is insufficient to answer, say so rather than guessing. |
| cannibalizationA | Detect keyword cannibalization — queries where multiple pages from the same site compete against each other, splitting ranking potential. Shows which pages rank for the same keywords so you can consolidate or differentiate. IMPORTANT: Base your analysis only on the data returned by this tool. Report exact numbers from the response. Do not speculate about causes the data does not support. If the data is insufficient to answer, say so rather than guessing. |
| content_decayA | Detect content decay — pages with 3 or more consecutive months of traffic decline. One bad month is noise; sustained decline is a pattern that needs attention. Surfaces pages that should be refreshed before they disappear from search results. IMPORTANT: Base your analysis only on the data returned by this tool. Report exact numbers from the response. Do not speculate about causes the data does not support. If the data is insufficient to answer, say so rather than guessing. |
| ctr_benchmarksA | Compare your actual click-through rates against industry-average benchmarks by position. Identifies pages or queries with CTR below expected levels — candidates for title tag and meta description optimization. Benchmarks are aggregated from multiple studies and should be used as directional guidance. IMPORTANT: Base your analysis only on the data returned by this tool. Report exact numbers from the response. Do not speculate about causes the data does not support. If the data is insufficient to answer, say so rather than guessing. |
| topic_clustersA | Analyze performance of all pages under a URL path prefix (e.g., "/blog/", "/docs/seo/", "/products/"). Shows aggregate and per-page metrics plus the top queries driving traffic to the cluster. Useful for understanding how entire content sections perform. IMPORTANT: Base your analysis only on the data returned by this tool. Report exact numbers from the response. Do not speculate about causes the data does not support. If the data is insufficient to answer, say so rather than guessing. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 17 tools
Most tools have clearly distinct purposes: sitemap management, URL inspection, analytics queries, and specific diagnostics are all separated cleanly. The only real ambiguity is among the analytics-analysis tools like find_opportunities, diagnose_traffic_drops, and content_decay, though their descriptions give enough differentiation.
Snake_case is consistent, and clusters like submit_sitemap/list_sitemaps/delete_sitemap follow a clear verb_noun pattern. However, several diagnostic tools use bare nouns (cannibalization, content_decay, ctr_benchmarks, topic_clusters) and search_analytics/verify_claim break the action-oriented naming convention.
At 17 tools, the server is slightly above the ideal 3-15 range, but the breadth is justified by covering four distinct GSC areas: sitemaps, indexing, raw analytics, and SEO diagnostics. Each tool addresses a specific use case and there is little obvious filler.
Core GSC workflows are covered well: sitemap CRUD, single and batch URL inspection, indexing notification status, and search analytics with period comparison and diagnostic helpers. Minor gaps exist, such as no property create/delete and no broader GSC reports like links or Core Web Vitals, but common SEO tasks can be completed without dead ends.