● open-source · MIT · v1.7.0
SEO Tools MCP
Eight universal stdio MCP servers for SEO: SERP from two independent providers, Wordstat, Google Search Console, Google Analytics 4, Yandex.Webmaster, Yandex.Metrica and a bridge to your own A-Parser — right from Claude Code and other MCP clients. Read-only, strict JSON, production-tested on real PBN Workers workloads.
● eight servers
xmlstock API key
Google/Yandex SERP, images, news, video + Wordstat
xmlstock_serpxmlstock_imagesxmlstock_newsxmlstock_videoxmlstock_wordstatxmlstock_wordstat_dynamicsxmlstock_wordstat_regionsxmlstock_wordstat_regions_treexmlstock_balance access: xmlstock.com →
xmlriver API key
Second SERP provider: AI Overview, People Also Ask, Maps
xmlriver_serpxmlriver_imagesxmlriver_newsxmlriver_mapsxmlriver_check_indexxmlriver_suggestxmlriver_related_questionsxmlriver_balance access: xmlriver.com →
wordstat Yandex Cloud API key
Yandex.Wordstat frequency & trends
wordstat_frequencywordstat_dynamicswordstat_regionswordstat_regions_tree access: Yandex Cloud →
gsc OAuth / service account
Google Search Console
gsc_querygsc_inspect_urlgsc_list_sitesgsc_get_sitegsc_list_sitemapsgsc_get_sitemap access: Google Cloud →
ga4 OAuth / service account
Google Analytics 4 — Data API + Admin API
ga4_list_propertiesga4_metadataga4_check_compatibilityga4_reportga4_bytimega4_traffic_sourcesga4_geoga4_devicesga4_top_pagesga4_eventsga4_realtime access: Google Cloud →
ywm OAuth with auto-refresh
Yandex.Webmaster
ywm_hostsywm_summaryywm_search_queriesywm_queries_historyywm_recommended_queriesywm_popularywm_indexing_historyywm_sqi_historyywm_external_linksywm_broken_linksywm_diagnosticsywm_important_urlsywm_sitemaps access: Yandex OAuth →
metrika OAuth with auto-refresh
Yandex.Metrica
metrika_reportmetrika_bytimemetrika_countersmetrika_goalsmetrika_traffic_sourcesmetrika_geometrika_devicesmetrika_landing_behaviormetrika_search_phrasesmetrika_top_landings access: Yandex OAuth →
aparser self-hosted: API URL + password
Bridge to your own A-Parser instance
aparser_pingaparser_statusaparser_proxiesaparser_parsersaparser_parser_fieldsaparser_get_presetaparser_serp_googleaparser_serp_yandexaparser_suggestaparser_requestaparser_bulk_request access: a-parser.com →
● installation
Via npx — no cloning required
Add the server you need to Claude Code with a single command:
claude mcp add xmlstock --scope user -- npx -y seo-tools-mcp-xmlstockOr build from source:
git clone https://github.com/antohins/seo-tools-mcp.git && cd seo-tools-mcp
pnpm install && pnpm buildNeed access from claude.ai (web) or a remote machine? Deploy it on a VPS and connect over an HTTP bridge with supergateway.
● what's inside
Read-only
Every tool only reads data and returns strict JSON. Nothing is ever modified in your accounts.
Interactive authorization
Manage access right in the chat: *_auth_status, *_set_credentials — no file editing required.
Multi-account
Named profiles: multiple Google/Yandex accounts with separate token storage.
Auto token refresh
OAuth tokens are refreshed automatically on expiry.
Not tied to any site
Domains are not hardcoded — defaults are configured on the fly, for any project.
Single config
One env file ~/.config/seo-tools-mcp/.env with 600 permissions.
● changelog
What shipped recently
Since the first public release the toolkit grew from five servers to eight. Full history — CHANGELOG.md.
v1.7.0 8 Aug 2026
GA4 gains ga4_metadata (which fields exist in this property, with blocked ones flagged) and ga4_check_compatibility (is a dimension × metric pair valid — without paying for a heavy report). Plus period comparison, metric-value filters and totals in every report tool.
v1.6.0 7 Aug 2026
New server ga4 — Google Analytics 4 via the Data API and Admin API: reports, traffic sources, geo, devices, top pages, events and realtime. Shares the OAuth app with gsc, so both run side by side.
v1.5.0 — 1.5.1 7 Aug 2026
gsc: arbitrary dimension filters and aggregationType. xmlstock: third engine yandex_xml — the official Yandex XML API, up to 100 results per single paid request. xmlriver: Google Maps search and extra SERP blocks. Fixed an extra paid request in the yandex_xml pagination loop.
v1.4.0 4 Aug 2026
New server aparser — a bridge to your own self-hosted A-Parser: Google/Yandex SERP, suggestions and ~150 parsers through one universal call. xmlriver: Google geo-targeting, full AI Overview text, People Also Ask and suggestions.
v1.3.0 26 Jul 2026
Wordstat inside xmlstock: frequency, trends and regional demand on the same API key — no Yandex Cloud setup required.
v1.2.0 18 Jul 2026
New server xmlriver — a second SERP provider and an indexation check for Google and Yandex.
We build top-ranking infrastructure — and share the tools
We use this tool in our own satellite production. If you need a done-for-you result, see how we work with businesses and agencies, or read the blog.