The tools that read your own numbers need Google authorization, but audit_live_site, crawl_site_seo, analyze_page_seo and inspect_robots_txt work from a URL alone, so a site you have no Search Console access to is still auditable. Everything that changes state — properties, sitemaps, Indexing API submissions — is off until you set SEO_AUDIT_ENABLE_WRITE_TOOLS, which is the one decision worth making before you install.
An SEO audit server built on Google Search Console, with 30 tools spanning search analytics and period comparison, URL inspection, the Indexing API, sitemaps, Core Web Vitals, PageSpeed Insights and local Lighthouse, robots.txt and on-page checks, site crawls and keyword analysis. Forked from AminForou/mcp-gsc and extended.
- get_search_analytics and get_advanced_search_analytics query clicks, impressions, CTR and position with filtering and dimensions; get_performance_overview and get_search_by_page_query narrow that down, and compare_search_periods puts two periods side by side
- inspect_url and batch_inspect_urls return indexing status, crawl info, canonical and robots for one URL or for many
- request_indexing, batch_request_indexing, request_removal and check_indexing_notification submit and remove URLs through Google's Indexing API
- get_sitemaps, submit_sitemap and delete_sitemap manage the sitemaps registered in Search Console; analyze_sitemap validates a sitemap document and inspect_robots_txt reads robots.txt
- get_core_web_vitals returns LCP, FID, CLS, INP and TTFB from the Chrome UX Report
- get_pagespeed_insights and run_lighthouse_audit return category scores and failing-audit summaries, with Lighthouse taking over automatically when PageSpeed Insights errors or its quota fails
- analyze_page_seo extracts on-page signals and ranks findings by severity, crawl_site_seo crawls internal pages, and audit_live_site runs a live SEO audit without Search Console access
- find_striking_distance_keywords surfaces queries at positions 5-20, detect_cannibalization names pages competing for the same query, and split_branded_queries separates branded from non-branded traffic
- site_audit is the all-in-one report: sitemap health, indexing status, canonical mismatches and a performance summary
- list_properties, add_site and delete_site manage the Search Console properties, and reauthenticate clears the cached OAuth credentials so you can switch Google accounts
A Google account with Search Console access, authorized either through an OAuth client secrets file (GSC_OAUTH_CLIENT_SECRETS_FILE) or a service account key (GSC_CREDENTIALS_PATH). Core Web Vitals and PageSpeed need a Google API key in CRUX_API_KEY and PAGESPEED_API_KEY. Every tool that changes something — adding or removing properties, submitting or deleting sitemaps, Indexing API calls — stays off until you set SEO_AUDIT_ENABLE_WRITE_TOOLS to true.
One command plus a key — uvx mcp-seo-audit, then supply credentials