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 | Returns search-demand for a phrase over the last 30 days: the most popular queries that CONTAIN the phrase (results) and semantically RELATED queries that may not contain it (associations), plus totalCount. Use it to discover keywords and gauge demand. Counts can arrive as strings (int64). Optional regionIds and devices narrow the result; numPhrases sets how many to return (1..2000). |
| dynamicsA | Returns how demand for a phrase changed over time — a series of {date, count, share}, where share is the fraction of all Yandex searches. Use it for seasonality and trend. period sets the granularity (daily/weekly/monthly). fromDate/toDate bound the range as RFC3339 timestamps, and toDate must align to the period boundary. |
| regionsA | Returns how demand for a phrase is distributed across regions over the last 30 days. Each row has the region id, count, share and affinityIndex (>100% = above-average interest in that region, <100% = below). regionMode chooses the grouping: all, cities (only cities) or regions (only oblasts/subjects). Map region ids to names with list_regions. |
| list_regionsA | Returns the reference tree of regions Wordstat supports — region ids and their names (label). The ids feed the regionIds/regionMode of the other tools, and the names decode region ids in their responses. The tree is large and stable; fetch it once and cache it. |
| raw_requestA | Escape hatch to call any Yandex Cloud Search API Wordstat path directly, for endpoints without a dedicated tool, e.g. "v2/wordstat/topRequests". Every Wordstat endpoint is 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
top_requests, dynamics, regions, and list_regions each map to a distinct analytical dimension: current keyword demand, trend over time, geographic distribution, and the region reference. raw_request is clearly labeled as an escape hatch, so it is unlikely to be confused with the domain tools. No two tools appear to do the same thing.
Tool names are all lower_snake_case and readable, but the convention is mixed: top_requests, dynamics, and regions are noun-style, list_regions uses verb_noun, and raw_request is an adjective_noun escape hatch. This is not chaotic, but it lacks a uniform verb_noun or consistent action-noun pattern.
Five tools is well-scoped for a focused Wordstat analytics server. It provides the essential analytical operations plus a generic passthrough, with no redundancy or obvious bloat.
The server covers the core Wordstat surfaces: query popularity, time dynamics, geographic breakdown, and the region reference needed to interpret results. The raw_request passthrough also allows direct calls to any additional Wordstat endpoint, so there are no dead ends.