Yandex Wordstat MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| WORDSTAT_LANG | No | Accept-Language header. | ru |
| WORDSTAT_TOKEN | No | OAuth token for api.wordstat.yandex.net (required for oauth flavor). | |
| WORDSTAT_FLAVOR | No | Backend flavor: cloud or oauth. | cloud |
| WORDSTAT_API_KEY | No | API key for Yandex Cloud (required for cloud flavor). | |
| WORDSTAT_API_BASE | No | Override API base URL. | |
| WORDSTAT_FOLDER_ID | No | Folder ID for Yandex Cloud (required for cloud flavor). | |
| WORDSTAT_TIMEOUT_MS | No | Request timeout in milliseconds. | 60000 |
| WORDSTAT_MAX_RETRIES | No | Number of retries on 429/5xx. | 3 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| top_requestsA | Возвращает поисковый спрос по фразе за последние 30 дней: самые популярные запросы, которые СОДЕРЖАТ фразу (results), и семантически ПОХОЖИЕ запросы, которые могут её не содержать (associations), плюс totalCount. Подходит для подбора ключевых фраз и оценки спроса. Значения счётчиков могут приходить строками (int64). Необязательные regionIds и devices сужают выборку; numPhrases задаёт, сколько фраз вернуть (1..2000). |
| dynamicsA | Возвращает, как менялся спрос на фразу во времени, — ряд {date, count, share}, где share — доля от всех поисковых запросов Яндекса. Подходит для оценки сезонности и тренда. period задаёт шаг ряда (daily/weekly/monthly). fromDate/toDate ограничивают диапазон метками времени RFC3339, при этом toDate должен попадать на границу периода. |
| regionsA | Возвращает, как спрос на фразу распределён по регионам за последние 30 дней. В каждой строке — id региона, count, share и affinityIndex (>100% — интерес в регионе выше среднего, <100% — ниже). regionMode выбирает группировку: all, cities (только города) или regions (только области и субъекты). Сопоставить id регионов с названиями помогает list_regions. |
| list_regionsA | Возвращает справочное дерево регионов, которые поддерживает Вордстат, — id регионов и их названия (label). Эти id подставляются в regionIds/regionMode остальных инструментов, а названия расшифровывают id регионов в их ответах. Дерево большое и стабильное: достаточно запросить его один раз и закешировать. |
| raw_requestA | Универсальный запрос: обращается напрямую к любому пути Wordstat в Yandex Cloud Search API — для эндпоинтов, у которых нет отдельного инструмента, например "v2/wordstat/topRequests". Все эндпоинты Вордстата работают методом POST; |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Each tool targets a distinct analytical dimension: top queries/associations, time dynamics, regional distribution, region reference data, and a generic fallback. The only potential overlap is raw_request, which could replicate other tools, but its description explicitly scopes it to endpoints lacking a dedicated tool.
All names use snake_case, but the patterns are mixed: some are nouns (dynamics, regions), one is verb_noun (top_requests, list_regions), and one is adjective_noun (raw_request). The set is readable but lacks a consistent verb_noun convention.
Five tools cover Wordstat's main endpoints (top requests, dynamics, regions, list regions) plus a generic escape hatch. Each tool is justified and the count is well-scoped for the domain.
The surface covers demand analysis (top_requests), trend/seasonality (dynamics), regional breakdown (regions), reference data (list_regions), and any other endpoint via raw_request. No obvious gaps for typical Wordstat workflows.