MCP Search Console

io.github.Ayo-FamPublished by GitHub account Ayo-Famv0.1.3Updated Nov 3, 2026

Multi-account Google Search Console MCP: analytics, URL inspection, sitemaps across named accounts.

VerifiedSTDIODesktop onlyProductivity & WorkflowWeb Search & ScrapingData & Analytics

Overview

AI-generated overview

Multi-account Google Search Console MCP server for search analytics, URL inspection and sitemap management across named accounts.

What you can do
  • List configured accounts, switch the default account and refresh authentication
  • Discover accessible properties and their permissions
  • Query search performance data, including period comparisons, advanced queries and per-page breakdowns
  • Inspect URLs individually or in batches, check indexing issues, and list or fetch sitemaps
  • Submit or delete sitemaps when the destructive flag is enabled
When to use it
Useful when you manage several Search Console properties or client accounts and want one assistant session to query search performance and indexing data without restarting the server. Suited to SEO reporting, indexing troubleshooting and sitemap upkeep.
Requirements
Runs locally as a Python package installed with pip (or launched via uvx). Needs an accounts config file, located by the GSC_ACCOUNTS_CONFIG environment variable and defaulting to ~/.config/mcp-search-console/accounts.json, containing Google OAuth or service-account credentials per account. Network access to the Google Search Console API is required.
Before you install
The accounts config holds Google OAuth or service-account credentials for every configured account, so protect that file. Sitemap submit and delete operations change live Search Console data and are only enabled when GSC_ALLOW_DESTRUCTIVE is set to true. The package is a beta release. Search data is sent to and from Google's API.

Installation

In SourceWeft

  1. Open MCP Search Console in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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 hereThen
Connecting the server to Claude/Codex/Cursordocs/start-here.mdQuick start below
Auditing account routing or destructive guardsdocs/architecture.mdgsc/server.py
Reviewing packaging or registry metadatapyproject.tomlserver.json

Architecture

mermaid
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

mermaid
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.
bash
python -m pip install mcp-search-console-multi
  1. Create the accounts config.
bash
mkdir -p ~/.config/mcp-search-consolecp accounts.example.json ~/.config/mcp-search-console/accounts.json
  1. Register it in your MCP client.
json
{  "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 groupToolsPurpose
Account routinglist_accounts, set_default_account, reauthenticateInspect accounts, switch defaults, refresh auth
Property inventorylist_properties, get_site_detailsDiscover accessible properties and permissions
Search analyticsget_search_analytics, get_performance_overview, compare_periods, get_advanced_search_analytics, get_search_by_pageQuery search-performance data
Inspection and sitemapsinspect_url, batch_inspect_urls, check_indexing_issues, list_sitemaps, get_sitemap, submit_sitemap, delete_sitemapInspect indexing and manage sitemap submissions

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

Runtime proof

ClaimProof
Package entry point is stablemcp-search-console-multi = "gsc.server:main" in pyproject.toml
Multi-account routing is first-classAccountManager() and _get_manager() in gsc/server.py
Search Console calls are retriedwith_retry() in gsc/server.py and gsc/retry.py
Auth is file-driven per accountaccounts.example.json and gsc/accounts.py

Repo map

PathPurpose
gsc/server.pyFastMCP tool surface and response normalization
gsc/accounts.pyAccount config, auth loading, client construction
gsc/auth/OAuth and service-account auth implementations
gsc/retry.pyRetry behavior for transient API failures
docs/start-here.mdSetup, env, validation, common failures
docs/architecture.mdComponent map and runtime lifecycle

Validation

CheckCommand
Import compilespython -m compileall gsc
Package buildspython -m build
README/docs links stay localrg '\\]\\(([^)]+\\.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.

Source: README.md at commit 624bba9

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.3LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts