Yandex Wordstat MCP · askads — Claude Code MCP server: setup guide
Brings Yandex search demand metrics into AI coding assistants. Helps analyze query volume, seasonal trends, and regional popularity.
claude mcp add --env WORDSTAT_API_KEY=<WORDSTAT_API_KEY> --env WORDSTAT_FOLDER_ID=<WORDSTAT_FOLDER_ID> --env WORDSTAT_LANG=<WORDSTAT_LANG> --env WORDSTAT_API_BASE=<WORDSTAT_API_BASE> --env WORDSTAT_TIMEOUT_MS=<WORDSTAT_TIMEOUT_MS> --transport stdio askads-yandex-wordstat-mcp -- npx -y mcp-yandex-wordstatWhat Yandex Wordstat MCP does
The server links AI clients to Yandex search demand metrics via the Yandex Cloud Search API. It provides five tools that fetch related queries, track demand curves, inspect regional popularity indexes, and navigate location identifiers. All endpoints operate strictly in read-only mode, meaning the integration cannot edit advertising campaigns or keyword lists.
Query and territory reports cover the preceding 30 days. You can narrow data down by device type to compare phone, tablet, and desktop traffic. Each call handles only one search phrase. Without an active Yandex Cloud API key and folder ID, the server will not answer queries.
What it helps with
- check monthly search volumes and related phrases on Yandex
- track search interest shifts across days, weeks, or months
- compare keyword popularity across different regional markets
- inspect query distribution between mobile devices and desktop computers
Example prompts for the agent
- Check monthly search volume and related queries for 'bike rental'
- Show monthly search dynamics for 'winter boots' over the past year
- Which cities show above-average interest in home renovation services?
How to install Yandex Wordstat MCP
Platform CLI
claude mcp add --env WORDSTAT_API_KEY=<WORDSTAT_API_KEY> --env WORDSTAT_FOLDER_ID=<WORDSTAT_FOLDER_ID> --env WORDSTAT_LANG=<WORDSTAT_LANG> --env WORDSTAT_API_BASE=<WORDSTAT_API_BASE> --env WORDSTAT_TIMEOUT_MS=<WORDSTAT_TIMEOUT_MS> --transport stdio askads-yandex-wordstat-mcp -- npx -y mcp-yandex-wordstatReplace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
codex mcp add askads-yandex-wordstat-mcp --env WORDSTAT_API_KEY=<WORDSTAT_API_KEY> --env WORDSTAT_FOLDER_ID=<WORDSTAT_FOLDER_ID> --env WORDSTAT_LANG=<WORDSTAT_LANG> --env WORDSTAT_API_BASE=<WORDSTAT_API_BASE> --env WORDSTAT_TIMEOUT_MS=<WORDSTAT_TIMEOUT_MS> -- npx -y mcp-yandex-wordstatReplace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"mcpServers": {
"askads-yandex-wordstat-mcp": {
"command": "npx",
"args": [
"-y",
"mcp-yandex-wordstat"
],
"env": {
"WORDSTAT_API_KEY": "<WORDSTAT_API_KEY>",
"WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID>",
"WORDSTAT_LANG": "<WORDSTAT_LANG>",
"WORDSTAT_API_BASE": "<WORDSTAT_API_BASE>",
"WORDSTAT_TIMEOUT_MS": "<WORDSTAT_TIMEOUT_MS>"
}
}
}
}Replace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"servers": {
"askads-yandex-wordstat-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-yandex-wordstat"
],
"env": {
"WORDSTAT_API_KEY": "<WORDSTAT_API_KEY>",
"WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID>",
"WORDSTAT_LANG": "<WORDSTAT_LANG>",
"WORDSTAT_API_BASE": "<WORDSTAT_API_BASE>",
"WORDSTAT_TIMEOUT_MS": "<WORDSTAT_TIMEOUT_MS>"
}
}
}
}Replace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
gemini mcp add -e WORDSTAT_API_KEY=<WORDSTAT_API_KEY> -e WORDSTAT_FOLDER_ID=<WORDSTAT_FOLDER_ID> -e WORDSTAT_LANG=<WORDSTAT_LANG> -e WORDSTAT_API_BASE=<WORDSTAT_API_BASE> -e WORDSTAT_TIMEOUT_MS=<WORDSTAT_TIMEOUT_MS> askads-yandex-wordstat-mcp npx -y mcp-yandex-wordstatReplace <…> with your own values. 1 more environment variable is in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Yandex Wordstat MCP
How do I install Yandex Wordstat MCP in Claude Code?
Run claude mcp add mcp-yandex-wordstat -e WORDSTAT_API_KEY=<WORDSTAT_API_KEY> -e WORDSTAT_FOLDER_ID=<WORDSTAT_FOLDER_ID> -- npx -y mcp-yandex-wordstat in your terminal. Replace the placeholder values with your Yandex Cloud credentials.
Does this require access to a Yandex Direct advertising account?
Direct ad account access is unnecessary. The server queries search statistics through the Yandex Cloud Search API.
Can it process multiple search terms in a single call?
Every request handles only one search phrase. Pre-filter keyword batches to avoid consuming your cloud quota too quickly.
Similar MCP servers
Everything for SEO and GEO →Yandex Wordstat MCP by other authors comes first.
