# Google Search Console MCP Server (npm · @conorbronsdon/gsc-mcp)

Google Search Console for AI agents: search analytics, sitemaps, URL inspection.

- Trust score: 78/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-04

## Components

- npm · `@conorbronsdon/gsc-mcp`: 78/100 (this document), [markdown](https://verifymcp.io/servers/conorbronsdon-gsc-mcp/conorbronsdon-gsc-mcp.md), [page](https://verifymcp.io/servers/conorbronsdon-gsc-mcp/conorbronsdon-gsc-mcp)

## Channel facts

- Registry: `npm`
- Package: `@conorbronsdon/gsc-mcp`
- Version: `1.1.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-04.

- **Supply Chain Security**: 97/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to conorbronsdon/gsc-mcp).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 1 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 72/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1197 tokens (~171/item across 7 items; 7 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add conorbronsdon-gsc-mcp -- npx -y @conorbronsdon/gsc-mcp
```

### Codex

```bash
codex mcp add conorbronsdon-gsc-mcp -- npx -y @conorbronsdon/gsc-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "conorbronsdon-gsc-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@conorbronsdon/gsc-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add conorbronsdon-gsc-mcp --command npx --arg -y --arg @conorbronsdon/gsc-mcp
```

### Hermes

```yaml
mcp_servers:
  conorbronsdon-gsc-mcp:
    command: "npx"
    args: ["-y", "@conorbronsdon/gsc-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "conorbronsdon-gsc-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@conorbronsdon/gsc-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 78, +10)

- [security improvement] Known CVEs: unverified → partial
- [functional improvement] Dependency health: unverified → partial

### 2026-08-02 (score 68)

First indexed and scored.

## MCP tools (7)

### `gsc_list_sites` (~52 tokens)

List Search Console properties

List the Search Console properties (sites) the signed-in Google account can access, with each one's permission level. This is the entry point: every other tool needs a property string in the exact form returned here.

### `gsc_search_analytics` (~289 tokens)

Query search performance

Query Search Console search analytics for a property over a date range: clicks, impressions, CTR, and average position, grouped by the dimensions you pass (query, page, country, device, date). Returns compact rows. Use this for 'what are my top queries / pages' and trend questions. GSC data lags ~2-3 days, so end your range a few days before today.

Input parameters:

- `dimension_filter_groups` (array): Optional filters, e.g. only rows where page contains '/blog/'. Each group's filters are AND-ed.
- `dimensions` (array): How to group rows. Default ['query']. Combine for breakdowns, e.g. ['page','query'].
- `end_date` (string, required): End date, YYYY-MM-DD (Pacific Time, inclusive).
- `row_limit` (number): Max rows to return (default 25, cap 1000). Keep low; rows cost tokens.
- `site_url` (string, required): The Search Console property. Use the exact form shown by gsc_list_sites: a Domain property is 'sc-domain:example.com'; a URL-prefix property is the full origin with a trailing slash, e.g. 'https://ex…
- `start_date` (string, required): Start date, YYYY-MM-DD (Pacific Time, inclusive).
- `type` (string): Search type filter. Defaults to web when omitted.

### `gsc_striking_distance` (~254 tokens)

Striking-distance keywords

The SEO goldmine view: queries ranking just off page one (average position 8-25) with enough impressions to be worth optimizing. These are the keywords where a small content tweak can win real clicks. Computed client-side from search analytics; returns queries sorted by impressions.

Input parameters:

- `end_date` (string, required): End date, YYYY-MM-DD (lag ~2-3 days behind today).
- `limit` (number): Max queries to return, ranked by impressions (default 25).
- `min_impressions` (number): Only include queries with at least this many impressions (default 10).
- `position_max` (number): Upper bound of the striking-distance band (default 25).
- `position_min` (number): Lower bound of the striking-distance band (default 8).
- `site_url` (string, required): The Search Console property. Use the exact form shown by gsc_list_sites: a Domain property is 'sc-domain:example.com'; a URL-prefix property is the full origin with a trailing slash, e.g. 'https://ex…
- `start_date` (string, required): Start date, YYYY-MM-DD (default: 28 days before end_date if omitted in your call).

### `gsc_list_sitemaps` (~108 tokens)

List sitemaps

List the sitemaps submitted for a property, with each one's submit/download times, pending state, and warning/error counts. Use this to check whether a sitemap was processed and is error-free.

Input parameters:

- `site_url` (string, required): The Search Console property. Use the exact form shown by gsc_list_sites: a Domain property is 'sc-domain:example.com'; a URL-prefix property is the full origin with a trailing slash, e.g. 'https://ex…

### `gsc_submit_sitemap` (~178 tokens)

Submit a sitemap

Submit (or re-submit) a sitemap to Google Search Console for a property. This is a WRITE action: it registers the sitemap and pings Google to crawl it. Requires the full webmasters OAuth scope — if the saved credential is read-only, re-mint with scripts/seo-auth-setup.py. Idempotent: re-submitting the same sitemap URL just refreshes it.

Input parameters:

- `feedpath` (string, required): Full URL of the sitemap to submit, e.g. https://example.com/sitemap.xml. Must be within the property.
- `site_url` (string, required): The Search Console property. Use the exact form shown by gsc_list_sites: a Domain property is 'sc-domain:example.com'; a URL-prefix property is the full origin with a trailing slash, e.g. 'https://ex…

### `gsc_delete_sitemap` (~143 tokens)

Delete a sitemap

Remove a sitemap from a property in Search Console. This is a DESTRUCTIVE write action: it deregisters the sitemap (it does not delete the file from your server, but Google stops tracking it). Requires the full webmasters OAuth scope.

Input parameters:

- `feedpath` (string, required): Full URL of the sitemap to remove, e.g. https://example.com/sitemap.xml.
- `site_url` (string, required): The Search Console property. Use the exact form shown by gsc_list_sites: a Domain property is 'sc-domain:example.com'; a URL-prefix property is the full origin with a trailing slash, e.g. 'https://ex…

### `gsc_inspect_url` (~173 tokens)

Inspect a URL's index status

Inspect a single URL with the URL Inspection API: whether Google has it indexed, its coverage state, last crawl time, Google's chosen canonical, and a one-line mobile/rich-results summary. Returns a compact projection, not the full raw blob. Use this to debug 'why isn't this page indexed'.

Input parameters:

- `inspection_url` (string, required): The fully-qualified URL to inspect. Must be within the property.
- `language_code` (string): Optional BCP-47 language code for issue messages, e.g. 'en-US'.
- `site_url` (string, required): The Search Console property. Use the exact form shown by gsc_list_sites: a Domain property is 'sc-domain:example.com'; a URL-prefix property is the full origin with a trailing slash, e.g. 'https://ex…

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/conorbronsdon-gsc-mcp/conorbronsdon-gsc-mcp#diagnostics

## Score history

- 2026-08-04: 78
- 2026-08-03: 78
- 2026-08-02: 68

## Links

- npm package: https://www.npmjs.com/package/@conorbronsdon/gsc-mcp
- Socket report: https://socket.dev/npm/package/@conorbronsdon/gsc-mcp
- Repository: https://github.com/conorbronsdon/gsc-mcp
- Changelog RSS feed: https://verifymcp.io/servers/conorbronsdon-gsc-mcp/conorbronsdon-gsc-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/conorbronsdon-gsc-mcp/conorbronsdon-gsc-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/conorbronsdon-gsc-mcp/conorbronsdon-gsc-mcp