modelbrain-search-console
OfficialProvides read-only access to Google Search Console data, enabling users to list properties, query search performance by query, page, country, device, date, or search appearance, inspect URL index status and coverage, list submitted sitemaps, and compare two date ranges.
ModelBrain free connectors
Hosted, read-only MCP connectors from ModelBrain. Free for every account and every property.
First connector: ModelBrain Search Console at https://gsc.modelbrain.net/mcp.
Tools (Search Console)
Tool | What it returns |
| Every property the Google account can see, with permission level |
| Clicks, impressions, CTR, position by query, page, country, device, date or search appearance, with filters and paging (up to 25,000 rows a call, 16 months) |
| Index status, coverage, last crawl, canonical, robots and rich results for one URL |
| Submitted sitemaps with last read, errors, warnings and URL counts |
| Two date ranges side by side, plus the biggest risers and fallers |
Every tool is marked readOnlyHint: true. The only Google scope requested is webmasters.readonly.
Related MCP server: search-console-mcp
How sign-in works
The AI app registers itself (
/register, RFC 7591) and sends the person to/authorizewith a PKCE S256 challenge.We send them to Google, asking for
openidand the one read-only scope, with offline access.Google returns to
/oauth/google/callback. We read the account ID from the ID token, seal the Google refresh token with ChaCha20-Poly1305 and store it.The app swaps a one-time code at
/tokenfor our own access token (1 hour) and refresh token (90 days, rotated on use).
What is stored
Google account ID and the sealed Google refresh token.
SHA-256 hashes of our own codes and tokens.
Registered app names and redirect addresses.
Search data passes straight through and is never stored. Logs hold method, tool name, outcome and duration only. No email addresses are kept.
Configuration
Variable | Meaning |
|
|
| Public address, for example |
| Listen address, default |
| SQLite file, default |
| Path to the client JSON downloaded from Google Cloud (or set |
| 32 random bytes, base64 ( |
| Comma-separated extra https hosts allowed as app callbacks |
| Per-account tool call limit, default 60 |
| Log filter, default |
Local run
export BASE_URL=http://localhost:8787
export GOOGLE_OAUTH_JSON_FILE=$HOME/path/to/client_secret.json
export TOKEN_KEY=$(openssl rand -base64 32)
cargo run --releaseThen add http://localhost:8787/mcp as a connector in an MCP client that allows localhost, or test with the MCP Inspector.
Tests
cargo test
cargo clippy --all-targets -- -D warningsSecurity
The code that handles your Google access is all here: sign-in in
src/oauth.rs, token sealing insrc/crypto.rs, storage insrc/store.rs.The connector asks Google only for
webmasters.readonly. It cannot change anything in Search Console.You can remove its access at any time at https://myaccount.google.com/permissions. The connector then drops every token it issued for your account.
Report a security problem privately to security@modelbrain.net rather than in a public issue.
License
MIT. See LICENSE. "ModelBrain" is a trademark of Matthew Firth; the license covers the code, not the name or logo.
Available Tools
5 toolscompare_periodsCompare two periodsARead-onlyIdempotentInspect
Totals for two date ranges side by side, plus the queries or pages that gained and lost the most clicks. Defaults to the last 28 days of final data against the 28 days before.
Inputs: site_url (required), limit, dimension, current_end, +4 more.
inspect_urlInspect a URLARead-onlyIdempotentInspect
Google's index status for one URL in a property: whether it is indexed, coverage state, last crawl time, Google's chosen canonical, robots.txt state and rich result checks.
Inputs: url (required), site_url (required), language_code.
list_sitemapsList sitemapsBRead-onlyIdempotentInspect
Sitemaps submitted for a property, with when Google last read them, errors, warnings and how many URLs each holds.
Inputs: site_url (required).
list_sitesList Search Console propertiesARead-onlyIdempotentInspect
List every Search Console property this Google account can see, with its permission level. Call this first to get exact property names.
Inputs: no named parameters.
search_performanceSearch performance reportARead-onlyIdempotentInspect
Clicks, impressions, CTR and average position from Google Search, grouped by any of query, page, country, device, date or searchAppearance, with optional filters. Covers up to 16 months. Defaults to the last 28 days of final data (ending 3 days ago) and 100 rows.
Inputs: site_url (required), filters, end_date, row_limit, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a clearly distinct resource or operation: property enumeration (list_sites), per-URL status (inspect_url), sitemap listing (list_sitemaps), raw performance querying (search_performance), and period-over-period comparison (compare_periods). The only mild adjacency is search_performance vs compare_periods, but one is a granular grouped query and the other a fixed two-period diff with gain/loss highlights, so boundaries are clear.
All five names follow a consistent snake_case verb_noun convention (inspect_url, list_sitemaps, list_sites, search_performance, compare_periods). Verbs are distinct and meaningfully matched to each action.
Five tools is well-scoped for a focused Search Console surface, covering properties, sitemaps, URL inspection, analytics, and comparison without redundancy. Each tool earns its place.
Core read workflows (properties, sitemaps, URL inspection, search analytics, period comparison) are well covered. However, the surface is entirely read-only: there is no way to submit or delete a sitemap or request reindexing, which are natural Search Console operations and could cause dead ends.
Maintenance
Related MCP Connectors
Google Search Console, GA4 and PageSpeed MCP server for Claude, ChatGPT and Cursor. Free, hosted.
Google Search Console for AI assistants: traffic, rankings, indexing and page checks. Read-only.
Hosted, read-only Google Search Console MCP: performance, comparisons, URL inspection, sitemaps.
Free Search Console & GA4 MCP, plus SERP, keywords, rank charts, GEO, AEO and AI visibility.
Related MCP Servers
- AlicenseBqualityDmaintenanceProfessional Google Search Console MCP server providing 40+ SEO tools for performance analysis, content decay, CTR opportunities, and more, enabling real search data in clients like Cursor and Claude.4021 npm6MIT
- AlicenseAqualityBmaintenanceGoogle Search Console for Claude, Cursor & any MCP client — one sign-in, 30 seconds, no Google Cloud project. Six read-only tools (search analytics incl. Google Discover, period comparison with computed deltas, batch URL inspection, sitemaps) plus five built-in SEO analyses as slash-commands. Tokens stay on your machine. MIT.6370 npm8MIT
- AlicenseBqualityCmaintenanceA production-oriented, read-only Google Search Console MCP server and TypeScript SDK for Claude, Cursor, VS Code, and other MCP clients. Query real Search Console data, inspect indexed URLs, review sitemaps, compare periods, and surface transparent SEO opportunities without handing private data to a third-party SaaS.20MIT
- AlicenseNot gradedqualityCmaintenanceSelf-hosted Google Search Console MCP server that lets ChatGPT, Claude, or other MCP clients query GSC data in natural language. It exposes tools to list sites, query Search Analytics, inspect URLs, and list sitemaps.MIT