Skip to main content
Glama
mcp-search-console

mcp-search-console

by apexradius

mcp-search-console

Multi-account Google Search Console MCP server for operators who need one MCP surface across multiple sites or clients without restarting the server.

Release posture: beta package, version 0.1.3 from pyproject.toml.

Choose your path

You are...

Start here

Then

Connecting the server to Claude/Codex/Cursor

docs/start-here.md

Quick start below

Auditing account routing or destructive guards

docs/architecture.md

gsc/server.py

Reviewing packaging or registry metadata

pyproject.toml

server.json

Related MCP server: searchconsole-mcp

Architecture

flowchart TD
  U[AI operator] --> C[MCP client]
  C --> S[FastMCP server]
  S --> M[Account manager]
  M --> F[Accounts config]
  M --> A[OAuth or service-account auth]
  S --> R[Retry wrapper]
  R --> G[Google Search Console API]
  G --> R --> S

Request flow

flowchart TD
  P[Operator asks for analytics or indexing data] --> T[Selected MCP tool]
  T --> A[Resolve named or default account]
  A --> B[Build authenticated GSC client]
  B --> C[Call Search Console endpoint]
  C --> D{API call succeeds?}
  D -- yes --> E[Return normalized JSON]
  D -- retryable --> F[Backoff and retry]
  F --> D
  D -- no --> G[Return error payload]

Quick start

  1. Install the package.

python -m pip install mcp-search-console-multi
  1. Create the accounts config.

mkdir -p ~/.config/mcp-search-console
cp accounts.example.json ~/.config/mcp-search-console/accounts.json
  1. Register it in your MCP client.

{
  "mcpServers": {
    "search-console": {
      "command": "uvx",
      "args": ["mcp-search-console-multi"],
      "env": {
        "GSC_ACCOUNTS_CONFIG": "/Users/you/.config/mcp-search-console/accounts.json"
      }
    }
  }
}

Available tools

Tool group

Tools

Purpose

Account routing

list_accounts, set_default_account, reauthenticate

Inspect accounts, switch defaults, refresh auth

Property inventory

list_properties, get_site_details

Discover accessible properties and permissions

Search analytics

get_search_analytics, get_performance_overview, compare_periods, get_advanced_search_analytics, get_search_by_page

Query search-performance data

Inspection and sitemaps

inspect_url, batch_inspect_urls, check_indexing_issues, list_sitemaps, get_sitemap, submit_sitemap, delete_sitemap

Inspect indexing and manage sitemap submissions

submit_sitemap and delete_sitemap stay behind the destructive flag documented in docs/start-here.md.

Runtime proof

Claim

Proof

Package entry point is stable

mcp-search-console-multi = "gsc.server:main" in pyproject.toml

Multi-account routing is first-class

AccountManager() and _get_manager() in gsc/server.py

Search Console calls are retried

with_retry() in gsc/server.py and gsc/retry.py

Auth is file-driven per account

accounts.example.json and gsc/accounts.py

Repo map

Path

Purpose

gsc/server.py

FastMCP tool surface and response normalization

gsc/accounts.py

Account config, auth loading, client construction

gsc/auth/

OAuth and service-account auth implementations

gsc/retry.py

Retry behavior for transient API failures

docs/start-here.md

Setup, env, validation, common failures

docs/architecture.md

Component map and runtime lifecycle

Validation

Check

Command

Import compiles

python -m compileall gsc

Package builds

python -m build

README/docs links stay local

rg '\\]\\(([^)]+\\.md)\\)' README.md docs/

License

MIT

Project context for new tasks

Use INDEX.md to find task-specific contracts; consult prompt.md when product direction is relevant. Historical examples do not select the current task.

Available Tools

17 tools
batch_inspect_urlsA

Inspect multiple URLs at once. Returns one result per URL. Maximum 10 URLs per call (GSC API limit).

Inputs: site_url (required), page_urls (required), account. Returns: result

check_indexing_issuesB

Check a list of URLs for indexing problems. Returns a prioritised summary of issues — more actionable than raw inspect_url output.

Inputs: site_url (required), page_urls (required), account. Returns: result

compare_periodsB

Compare search performance between two date ranges. Returns rows for both periods side-by-side with delta calculations.

Inputs: site_url (required), period1_end (required), period2_end (required), period1_start (required), +4 more. Returns: object

delete_sitemapB

Delete a sitemap from Google Search Console. Requires GSC_ALLOW_DESTRUCTIVE=true.

Inputs: site_url (required), sitemap_url (required), account. Returns: object

get_advanced_search_analyticsC

Advanced search analytics with dimension filters.

filters format: [{"dimension": "country", "operator": "equals", "expression": "usa"}] operators: equals, notEquals, contains, notContains, includingRegex, excludingRegex

Inputs: end_date (required), site_url (required), start_date (required), account, +3 more. Returns: object

get_performance_overviewA

Get a high-level performance summary: total clicks, impressions, CTR, average position. No dimension breakdown — use get_search_analytics for that.

Inputs: end_date (required), site_url (required), start_date (required), account. Returns: object

get_search_analyticsB

Fetch search analytics data (clicks, impressions, CTR, position).

Inputs: end_date (required), site_url (required), start_date (required), account, +2 more. Returns: object

get_search_by_pageC

Get search queries driving traffic to a specific page URL.

Inputs: end_date (required), page_url (required), site_url (required), start_date (required), +2 more. Returns: object

get_site_detailsB

Get verification and permission details for a specific GSC property.

Inputs: site_url (required), account. Returns: object

get_sitemapC

Get details and status of a specific sitemap.

Inputs: site_url (required), sitemap_url (required), account. Returns: object

inspect_urlB

Inspect a URL's indexing status, last crawl date, mobile usability, and rich result eligibility.

Inputs: page_url (required), site_url (required), account. Returns: object

list_accountsA

List all configured GSC accounts and which is the current default.

Inputs: no named parameters. Returns: result

list_propertiesB

List all Google Search Console properties for the specified account.

Inputs: account. Returns: result

list_sitemapsB

List all sitemaps submitted to GSC for this property.

Inputs: site_url (required), account. Returns: result

reauthenticateA

Force re-authentication for an account. Clears the cached token and re-runs the OAuth flow (or reloads service account credentials). Useful when a token has been revoked or you need to switch Google accounts.

Inputs: account. Returns: object

set_default_accountA

Set the default account used when no account is specified in other tools.

Inputs: account (required). Returns: object

submit_sitemapB

Submit a sitemap to Google Search Console. Requires GSC_ALLOW_DESTRUCTIVE=true.

Inputs: site_url (required), sitemap_url (required), account. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 17 tools

    Disambiguation5/5

    Each tool targets a specific operation with clear boundaries. Search analytics tools are differentiated by scope and features (overview, compare, advanced, per-page). URL inspection tools distinguish single, batch, and actionable issue-checking.

    Naming Consistency5/5

    All tool names use lowercase with underscores following a consistent verb_noun pattern (e.g., list_accounts, submit_sitemap, inspect_url). No mixing of styles.

    Tool Count4/5

    17 tools is slightly above the typical 3-15 range, but each tool serves a distinct purpose within the Google Search Console domain. The count is justified by the breadth of functionality covered.

    Completeness5/5

    The tool set covers the full lifecycle: account management, property details, sitemap operations, multiple search analytics views, and URL inspection (single, batch, issue analysis). No obvious gaps for common GSC workflows.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Self-hosted MCP server that exposes Google Search Console tools (list sites, query analytics, inspect URL, list sitemaps) via natural language to AI assistants like ChatGPT and Claude.
      2
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A lightweight, fast MCP server for Google Search Console. Query search analytics, manage sitemaps, and inspect URLs directly from your AI assistant.
      7
      13 PyPI
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      A unified MCP server that gives AI assistants direct access to Google Analytics 4, Google Search Console, Google Ads and Google Merchant Center data using OAuth2 user credentials.
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      MCP server integrating Google Search Console, Google Analytics 4, and GitHub, enabling AI clients to query search analytics, traffic data, and repository information.
      1
      -