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.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    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
      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
      -