Server data from the Official MCP Registry
Multi-account Google Search Console MCP: analytics, URL inspection, sitemaps across named accounts.
About
Multi-account Google Search Console MCP: analytics, URL inspection, sitemaps across named accounts.
Security Report
This is a well-structured MCP server for Google Search Console with proper authentication, appropriate permission scoping, and solid error handling. OAuth and service account credentials are handled securely using Google's official libraries, tokens are stored in user-controlled locations (not hardcoded), and destructive operations are protected by an environment flag. Minor code quality observations noted, but no security vulnerabilities detected. Supply chain analysis found 5 known vulnerabilities in dependencies (1 critical, 3 high severity). Package verification found 1 issue.
7 files analyzed · 11 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: GSC_ACCOUNTS_CONFIG
Environment variable: GSC_ALLOW_DESTRUCTIVE
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-ayo-fam-mcp-search-console": {
"env": {
"GSC_ACCOUNTS_CONFIG": "your-gsc-accounts-config-here",
"GSC_ALLOW_DESTRUCTIVE": "your-gsc-allow-destructive-here"
},
"args": [
"mcp-search-console-multi"
],
"command": "uvx"
}
}
}Documentation
View on GitHubFrom the project's GitHub 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 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 |
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
- Install the package.
python -m pip install mcp-search-console-multi
- Create the accounts config.
mkdir -p ~/.config/mcp-search-console
cp accounts.example.json ~/.config/mcp-search-console/accounts.json
- 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
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.