⚡ What's New in v2.0.2
- 📦 MCPB One-Click Bundle Support (
.mcpb): Drag and drop bundle installation for Claude Desktop.
- ⚡ Parallel Fetch Engine (
engine: "all"): Multi-engine queries fetch Google, Bing, and GA4 concurrently with 50%+ lower latency.
- 🔄 100% Backward Compatibility: All ~96 legacy tool names continue to work seamlessly via our fallback router. Read Backward Compatibility Guide →
Why this exists
SEO data lives in three different silos. Answering one question — "did my traffic drop because of a ranking loss or a UX issue?" — usually means logging into three dashboards, exporting three CSVs, and doing VLOOKUPs by hand.
Search Console MCP puts GSC, Bing, and GA4 behind one set of tools your AI agent can call directly, and does the SEO math (cannibalization, anomaly detection, opportunity scoring) before the data ever reaches your context window — so your agent gets insights, not spreadsheets.
| Before | After |
|---|
| Data | 3 dashboards, manual exports | 1 unified context |
| Analysis | Manual VLOOKUPs & pivot tables | Deterministic SEO math, done server-side |
| Accounts | Constant re-login | 20+ accounts, auto-resolved per site |
| Insight | Raw rows, agent guesses | Curated signals (opportunity scores, anomalies) |
⚡ Quick Start
npx search-console-mcp setup
This opens your browser, authorizes your Google account, and stores your credentials securely (see Security). Then add it to your MCP client config (Claude Desktop, Cursor, Antigravity, etc.):
{
"mcpServers": {
"search-console": {
"command": "npx",
"args": ["search-console-mcp"]
}
}
}
Restart your client — and try one of the prompts below.
💬 Try it
Paste these straight into your agent:
"My traffic dropped this week vs. last. Find exactly when it started and which pages are responsible."
"Find keywords for example.com ranking positions 8–15 with 1,000+ impressions — my best quick wins."
"Check for keyword cannibalization — are two of my pages competing for the same query?"
"Run seo_audit on my top pages: which have high search visibility but poor CTR?"
More example prompts
- "Run a full SEO health check (
site_health_check), segmented by Brand vs Non-Brand."
- "Fetch my top 5 pages by impressions and run
pagespeed_analyze — any correlation with declining rankings?"
- "Compare Google vs Bing performance for the last 30 days (
compare_engines) — where is Bing winning?"
- "Submit my latest URLs to Google and IndexNow using
indexing_submit with method: "index_now"."
🔌 Connect your accounts
| Platform | Method | Setup |
|---|
| Google Search Console | OAuth (recommended) | npx search-console-mcp setup |
| Google Search Console | Service Account | Set GOOGLE_APPLICATION_CREDENTIALS — details |
| Bing Webmaster Tools | API Key | export BING_API_KEY="..." — get a key |
| Google Analytics 4 | Service Account | npx search-console-mcp setup --engine=ga4 |
Manage everything from the CLI:
npx search-console-mcp accounts list
npx search-console-mcp accounts add-site --account=you@company.com --site=example.com
npx search-console-mcp accounts remove --account=you@company.com
When your agent queries a site, the server auto-resolves which account owns it — no manual switching. Multi-account docs →
Search Console MCP also exposes registered MCP tools as direct CLI commands. Use the run subcommand to list tools, inspect tool-specific arguments, and print results as JSON, CSV, or an ASCII table:
npx search-console-mcp run --help
npx search-console-mcp run analytics_query --help
npx search-console-mcp run seo_audit --siteUrl=https://example.com --type=quick_wins
npx search-console-mcp run analytics_query --siteUrl=https://example.com --startDate=2026-06-01 --endDate=2026-06-30 --dimensions=date,query --format=csv
npx search-console-mcp run sites_list --engine=all --format=table
Service Account setup (for servers/automation)
- Create a service account in the Google Cloud Console
- Generate a JSON key
- Add the service account email as a user in Search Console with "Full" or "Restricted" access
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/key.json"
🛠 Tools (Fluent Domain Architecture)
Search Console MCP v2.0 features 7 Fluent Domain Tools that handle all SEO, Analytics, Inspection, and Indexing operations cleanly:
| Fluent Tool | Parameters / Actions | Description |
|---|
sites_list | engine: "all" | "google" | "bing" | Lists verified sites across search engines in parallel |
sites_manage | action: "add" | "delete", siteUrl, engine | Adds or removes site properties |
accounts_manage | action: "list" | "add_site" | "remove" | Configures multi-account profiles |
sitemaps_list | siteUrl, feedUrl, engine | Fetches sitemap status and indexing state |
sitemaps_submit | siteUrl, feedUrl, engine | Submits sitemaps to GSC & Bing |
sitemaps_delete | siteUrl, feedUrl, engine | Removes sitemaps |
analytics_query | siteUrl, engine, dimensions, metrics | Multi-engine search & GA4 analytics query |
analytics_compare | mode: "period_over_period" | "trends" | "drop_attribution" | Analyzes period deltas, trend shifts, and drop causes |
analytics_anomalies | siteUrl, threshold | Statistical detection of traffic spikes/drops |
inspection_inspect | siteUrl, urls, engine | Google URL inspection & Bing URL info |
pagespeed_analyze | url, strategy, cwvOnly | Core Web Vitals and PageSpeed Insights audits |
indexing_submit | urls, method: "standard" | "index_now" | "remove" | Instantly indexes URLs via IndexNow or Google/Bing API |
indexing_status | siteUrl, type: "quota" | "status" | Checks remaining indexing quota & URL status |
seo_audit | type: "quick_wins" | "striking_distance" | "cannibalization" | "low_hanging_fruit" | "lost_queries" | "recommendations" | "brand_vs_nonbrand" | Comprehensive automated SEO audits |
seo_keywords_research | keywords, type: "stats" | "related" | "traffic" | Keyword volumes and related keyword stats |
site_health_check | siteUrl, level: "summary" | "full" | "crawl_issues" | One-shot site performance & technical audit |
compare_engines | siteUrl | Side-by-side Google vs Bing performance breakdown |
Backward Compatibility Notice (96+ Legacy Tools)
All legacy tool names (bing_sites_list, seo_quick_wins, sitemaps_get, bing_index_now, indexing_submit_url, opportunity_matrix, etc.) continue to work transparently via our fallback router.
Read our complete Backward Compatibility & Migration Guide →
🔒 Security
- OS keychain first — tokens stored in macOS Keychain, Windows Credential Manager, or Linux Secret Service
- AES-256-GCM fallback — encrypted with a key derived from your machine's hardware ID; a stolen file is useless on another device
- Minimal storage — only
refresh_token and expiry_date are persisted, at mode 600
- Silent refresh — tokens renew automatically in the background
License
MIT · Contributing guide · Backward Compatibility Guide
If this saves you a spreadsheet, consider ⭐ starring the repo.
