gsc-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GSC_USE_ADC | No | Enable Application Default Credentials fallback. Set to 'true' to enable. | |
| GSC_MCP_HOST | No | HTTP bind host. | |
| GSC_MCP_PORT | No | HTTP bind port. | |
| GSC_LOG_LEVEL | No | Log level: debug, info, warn, error, or silent. | info |
| GSC_CONFIG_DIR | No | Override application configuration directory. | |
| GSC_TOKEN_PATH | No | Override saved OAuth token location. | |
| GSC_MAX_RETRIES | No | Transient retry count. | 3 |
| GSC_MCP_TRANSPORT | No | Transport mode: 'stdio' or 'http'. | |
| GSC_HTTP_AUTH_TOKEN | No | Required bearer token for non-loopback HTTP. | |
| GSC_CREDENTIALS_JSON | No | Raw or base64-encoded service account JSON for secret injection. | |
| GSC_CREDENTIALS_PATH | No | Path to the service account JSON file. | |
| GSC_TEXT_PREVIEW_ROWS | No | Number of rows included in model-facing text preview. | 50 |
| GSC_REQUEST_TIMEOUT_MS | No | Google API timeout in milliseconds. | 30000 |
| GSC_EXPOSE_ERROR_DETAILS | No | Set to '1' to expose error details for debugging. | |
| GOOGLE_APPLICATION_CREDENTIALS | No | Standard Google credential path fallback. |
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 |
|---|---|
| gsc_list_sitesA | List Search Console properties available to the authenticated Google account. |
| gsc_get_siteA | Get access level details for one Search Console property. |
| gsc_query_pagesB | Query Search Analytics grouped by page. |
| gsc_query_queriesB | Query Search Analytics grouped by search query. |
| gsc_query_countriesA | Query Search Analytics grouped by country. |
| gsc_query_devicesC | Query Search Analytics grouped by device. |
| gsc_query_search_appearanceB | Query Search Analytics grouped by search appearance. |
| gsc_diagnose_traffic_dropA | Find pages, queries, countries, and devices with the largest period-over-period traffic declines. Results are evidence, not causal attribution. |
| gsc_detect_content_decayC | Find pages with declining clicks and impressions between two periods. |
| gsc_detect_cannibalizationA | Find queries receiving impressions or clicks from multiple pages in the same period; this is a review signal, not proof of cannibalization. |
| gsc_search_analyticsB | Query clicks, impressions, CTR, and average position with optional dimensions and filters. |
| gsc_compare_periodsB | Compare a date range with an explicit previous range or the immediately preceding equal-length period. |
| gsc_find_opportunitiesA | Find high-impression, low-CTR queries or pages within a ranking-position range. |
| gsc_top_pagesB | Return the highest-clicked pages for a date range. |
| gsc_top_queriesB | Return the highest-clicked search queries for a date range. |
| gsc_inspect_urlA | Inspect Google's indexed version of a URL. This is not a live URL test. |
| gsc_bulk_inspect_urlsA | Inspect multiple URLs with bounded concurrency. Partial failures are returned per URL. |
| gsc_list_sitemapsB | List sitemaps submitted for a Search Console property. |
| gsc_get_sitemapA | Get details for one submitted sitemap. |
| gsc_server_infoA | Return local server version, authentication guidance, and safety information without calling Google. |
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 20 tools
The set includes five specialized query tools (gsc_query_pages, gsc_query_queries, etc.) that all overlap with the generic gsc_search_analytics tool, which supports arbitrary dimensions and filters. Additionally, gsc_top_pages and gsc_top_queries are essentially sorted queries that could also be expressed via gsc_search_analytics. This creates significant ambiguity in tool selection.
Most tools follow a `gsc_verb_noun` snake_case pattern (e.g., list_sites, query_pages, inspect_url). However, `gsc_search_analytics` and `gsc_server_info` deviate from the verb-first convention, and there is minor mixing of verb styles (query vs list vs diagnose). Overall, the pattern is still recognizable and consistent enough.
At 20 tools, the set is on the heavy side but not excessive for a Google Search Console integration covering analytics, sitemaps, sites, and URL inspection. The redundancy among query-related tools makes the count feel somewhat inflated; trimming a few would tighten the surface.
The server covers core Search Console workflows: analytics querying with multiple dimensions and comparisons, sitemap listing/detail, site listing/detail, URL inspection, and common SEO analyses. Gaps exist around sitemap submission/removal and site verification, but these are secondary for an analytics-focused tool.