Yandex Wordstat MCP: Documentation

Updated: 24 July 2026

Connection

npx -y yandex-wordstat-mcp (stdio, Node.js). The package is part of the github.com/altrr2/yandex-tools-mcp monorepo (52+ stars, MIT), directory packages/yandex-wordstat-mcp. Auth: YANDEX_SEARCH_API_KEY + YANDEX_FOLDER_ID, a Yandex Cloud service-account key with the search-api.webSearch.user role — the same one yandex-search-mcp uses (not to be confused with the legacy Wordstat v1 OAuth token).

Capabilities

5 tools: top-requests — popular queries near a phrase over 30 days plus related queries, dynamics — frequency trends by day/week/month, regions — a query's distribution across regions with an affinity index, get-regions-tree — the top 3 levels of Wordstat's region hierarchy, get-region-children — child regions for a hierarchy node.

Agent flow

"What queries are popular alongside "buy a laptop"?", "show the demand trend for "winter tires" over the last six months", "which regions search for "English courses" most?".

Note

A community project (altrr2 / Alternex), not affiliated with Yandex. Release 2.0.1 on 03.07.2026, ~949 npm installs/month; Wordstat v2 calls through the Yandex Cloud API are billed separately from the MCP server itself.