SkillFoxx

Type a name, a task or a service

Yandex Wordstat MCP Server

An MCP server for Yandex Wordstat via the Yandex Cloud Search API: frequency, dynamics, regions and an operator-aware phrase builder

MCP server

Low risk

We rate an entry low when it mostly gives the agent instructions and reference material.

Why this level

  • Only reads public search query statistics, changes nothing in the user's accounts
  • Every Search API call is billed by Yandex Cloud, so balance spend is worth watching
All reasons and checks
Russian stack

baltic-tea/yandex-wordstat-mcpAuthor:baltic_tea

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/yandex-wordstat-mcp-server

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

Assembled automatically, review before installing.

Run in a terminal

claude mcp add --transport stdio --env 'WORDSTAT_FOLDER_ID=<WORDSTAT_FOLDER_ID value>' yandex-wordstat -- uvx --from git+https://github.com/baltic-tea/yandex-wordstat-mcp.git wordstat-mcp

Or add to the file .mcp.json, in the project

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/baltic-tea/yandex-wordstat-mcp.git",
        "wordstat-mcp"
      ],
      "env": {
        "WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

WORDSTAT_FOLDER_IDrequired
Folder ID for each API request
WORDSTAT_API_KEYsecret, optional
API key for authentication
WORDSTAT_IAM_TOKENsecret, optional
IAM token for authentication, used if specified instead of API key

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Install in Cursor

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Add to the file ~/.cursor/mcp.json, for all projects

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/baltic-tea/yandex-wordstat-mcp.git",
        "wordstat-mcp"
      ],
      "env": {
        "WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.

Keys and settings

WORDSTAT_FOLDER_IDrequired
Folder ID for each API request
WORDSTAT_API_KEYsecret, optional
API key for authentication
WORDSTAT_IAM_TOKENsecret, optional
IAM token for authentication, used if specified instead of API key

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Install in VS Code

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Run in a terminal

code --add-mcp '{"name":"yandex-wordstat","type":"stdio","command":"uvx","args":["--from","git+https://github.com/baltic-tea/yandex-wordstat-mcp.git","wordstat-mcp"],"env":{"WORDSTAT_FOLDER_ID":"<WORDSTAT_FOLDER_ID value>"}}'

Or add to the file .vscode/mcp.json, in the project

{
  "servers": {
    "yandex-wordstat": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/baltic-tea/yandex-wordstat-mcp.git",
        "wordstat-mcp"
      ],
      "env": {
        "WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the servers key.

Keys and settings

WORDSTAT_FOLDER_IDrequired
Folder ID for each API request
WORDSTAT_API_KEYsecret, optional
API key for authentication
WORDSTAT_IAM_TOKENsecret, optional
IAM token for authentication, used if specified instead of API key

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

codex mcp add yandex-wordstat --env 'WORDSTAT_FOLDER_ID=<WORDSTAT_FOLDER_ID value>' -- uvx --from git+https://github.com/baltic-tea/yandex-wordstat-mcp.git wordstat-mcp

Or add to the file ~/.codex/config.toml, for all projects

[mcp_servers.yandex-wordstat]
command = "uvx"
args = ["--from", "git+https://github.com/baltic-tea/yandex-wordstat-mcp.git", "wordstat-mcp"]
env = { WORDSTAT_FOLDER_ID = "<WORDSTAT_FOLDER_ID value>" }

If the file already exists, append the block to the end.

Keys and settings

WORDSTAT_FOLDER_IDrequired
Folder ID for each API request
WORDSTAT_API_KEYsecret, optional
API key for authentication
WORDSTAT_IAM_TOKENsecret, optional
IAM token for authentication, used if specified instead of API key

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.gemini/settings.json, for all projects

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/baltic-tea/yandex-wordstat-mcp.git",
        "wordstat-mcp"
      ],
      "env": {
        "WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

WORDSTAT_FOLDER_IDrequired
Folder ID for each API request
WORDSTAT_API_KEYsecret, optional
API key for authentication
WORDSTAT_IAM_TOKENsecret, optional
IAM token for authentication, used if specified instead of API key

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/devin/mcp_config.json, for all projects

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/baltic-tea/yandex-wordstat-mcp.git",
        "wordstat-mcp"
      ],
      "env": {
        "WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.

Keys and settings

WORDSTAT_FOLDER_IDrequired
Folder ID for each API request
WORDSTAT_API_KEYsecret, optional
API key for authentication
WORDSTAT_IAM_TOKENsecret, optional
IAM token for authentication, used if specified instead of API key

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Formerly Windsurf.

Add to the file cline_mcp_settings.json, for all projects

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/baltic-tea/yandex-wordstat-mcp.git",
        "wordstat-mcp"
      ],
      "env": {
        "WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.

Keys and settings

WORDSTAT_FOLDER_IDrequired
Folder ID for each API request
WORDSTAT_API_KEYsecret, optional
API key for authentication
WORDSTAT_IAM_TOKENsecret, optional
IAM token for authentication, used if specified instead of API key

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .roo/mcp.json, in the project

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/baltic-tea/yandex-wordstat-mcp.git",
        "wordstat-mcp"
      ],
      "env": {
        "WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

WORDSTAT_FOLDER_IDrequired
Folder ID for each API request
WORDSTAT_API_KEYsecret, optional
API key for authentication
WORDSTAT_IAM_TOKENsecret, optional
IAM token for authentication, used if specified instead of API key

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

A fork of Roo Code, same .roo folders.

Add to the file opencode.json, in the project

{
  "mcp": {
    "yandex-wordstat": {
      "type": "local",
      "command": [
        "uvx",
        "--from",
        "git+https://github.com/baltic-tea/yandex-wordstat-mcp.git",
        "wordstat-mcp"
      ],
      "environment": {
        "WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcp key.

Keys and settings

WORDSTAT_FOLDER_IDrequired
Folder ID for each API request
WORDSTAT_API_KEYsecret, optional
API key for authentication
WORDSTAT_IAM_TOKENsecret, optional
IAM token for authentication, used if specified instead of API key

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/zed/settings.json, for all projects

{
  "context_servers": {
    "yandex-wordstat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/baltic-tea/yandex-wordstat-mcp.git",
        "wordstat-mcp"
      ],
      "env": {
        "WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the context_servers key.

Keys and settings

WORDSTAT_FOLDER_IDrequired
Folder ID for each API request
WORDSTAT_API_KEYsecret, optional
API key for authentication
WORDSTAT_IAM_TOKENsecret, optional
IAM token for authentication, used if specified instead of API key

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .codeassistant/mcp.json, in the project

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/baltic-tea/yandex-wordstat-mcp.git",
        "wordstat-mcp"
      ],
      "env": {
        "WORDSTAT_FOLDER_ID": "<WORDSTAT_FOLDER_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

WORDSTAT_FOLDER_IDrequired
Folder ID for each API request
WORDSTAT_API_KEYsecret, optional
API key for authentication
WORDSTAT_IAM_TOKENsecret, optional
IAM token for authentication, used if specified instead of API key

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

You will need: uv

Checked against the repository on Sep 26, 2026, commit b8e26a7.

Text for your agent

Install the server with uvx --from git+https://github.com/baltic-tea/yandex-wordstat-mcp.git wordstat-mcp, add it to your MCP client with WORDSTAT_FOLDER_ID and WORDSTAT_API_KEY (or WORDSTAT_IAM_TOKEN), then call getTop to verify.

Other ways from the author
uvx --from git+https://github.com/baltic-tea/yandex-wordstat-mcp.git wordstat-mcp

The main README method: runs the server straight from Git via uvx, no cloning needed.

This is third-party code. Review the repository files before installing.

What it does

A FastMCP server wraps the Wordstat API v2 methods (getTop, getDynamics, getRegionsDistribution, getRegionsTree) and adds tools on top: build_wordstat_phrase turns a plain Russian request into a correct phrase with operators (quotes, plus, stop words), find_regions looks up a region ID by name from a locally cached region tree, and task-oriented aliases (find_keyword_queries, get_query_demand_trends) cover the same calls under clearer names. It retries on network errors and 429/5xx, and ships an MCP resource plus a prompt with a guide to Wordstat operators for the agent.

Who it is for. For marketers and SEO specialists who build keyword lists and check demand through an agent instead of the Wordstat website.

Good fit when

  • You need phrase frequency and related queries
  • You need monthly, weekly or daily demand seasonality
  • You need to compare demand across regions or find a region ID by city name

Not a fit when

  • You have no Yandex Cloud access with Search API enabled
  • You need Yandex Direct data or ready clusters rather than raw frequencies

Example request

Check the frequency of "buy a vacuum cleaner" for Moscow and show the top related queries

Limitations

You need a Yandex Cloud API key or IAM token and a Folder ID; Search API calls are billed per Yandex Cloud pricing. getDynamics supports only the '+' operator and rejects the rest. The region tree is cached locally in a .saved file and refreshed manually via a separate tool.

How to disable. Remove the server from your MCP client config (e.g. claude mcp remove yandex-wordstat) or delete the .saved directory with the local region cache.

MCP

Transport
stdio
Authentication
API key
Environment variables
WORDSTAT_FOLDER_ID
required		Yandex Cloud folder ID, required for every request.
WORDSTAT_API_KEY
secret		Yandex Cloud API key; either this or an IAM token is required.
WORDSTAT_IAM_TOKEN
secret		Yandex Cloud IAM token; takes priority if set alongside the API key.

Security check

  • Only reads public search query statistics, changes nothing in the user's accounts
  • Every Search API call is billed by Yandex Cloud, so balance spend is worth watching

README in short

The bilingual README covers installing via uvx straight from Git, setting up .env with the key and Folder ID, and the tool list: four Wordstat API methods, an operator-aware phrase builder, region lookup with a local cache, and a wordstat_env_health utility. It gives separate setup steps for Claude Desktop, Claude Code and Codex with ready claude mcp add and codex mcp add commands.

FAQ

How does an IAM token differ from an API key?

Both authenticate with Yandex Cloud; if both are set, the server uses the IAM token.

Can it build a phrase with stop words from a plain request?

Yes, build_wordstat_phrase parses a Russian-language request and builds a phrase with the right Wordstat operators.

Official

Official DataLens (Yandex) skills for Claude Code, Codex and OpenCode: SDK, HTML reports and RLS resolution

SkillMedium riskRussian stackNo VPN needed12
Editors’ pick

A Yandex Metrika MCP server generated from the API spec: 108 methods, 10 tools declared by default, transparent filters and response metadata

MCP serverMedium riskRussian stackNo VPN needed2
Official

An open MCP server and agent skill set for SEO: keyword research, competitors, backlinks and site audits powered by DataForSEO

MCP serverMedium risk21.5K

A Claude Code plugin for SEO audits: technical SEO, E-E-A-T, schema, local and AI search via parallel subagents

PluginHigh risk17.9K
Foxx AIYandex Wordstat MCP Server

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.