Yandex Wordstat MCP logo

Yandex Wordstat MCP

by @stufently

Research Yandex keywords for Russian and CIS markets through five MCP tools using the Yandex Wordstat Cloud API.

Install Yandex Wordstat MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "stufently-yandex-wordstat-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@stufently/yandex-wordstat-mcp"
      ],
      "env": {
        "WORDSTAT_API_KEY": "YOUR_VALUE_HERE",
        "WORDSTAT_FOLDER_ID": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 5 tools correctly (Today).

Overview

@stufently/yandex-wordstat-mcp exposes Yandex Wordstat keyword-research capabilities to MCP-compatible AI clients. It runs as a Node.js stdio process and authenticates with a Wordstat Cloud API key and folder ID. Use it to investigate search demand and related keyword data for Russian and CIS market analysis. Install it with npx when an agent needs Wordstat access without cloning or building the repository.

Use cases

  • Research Russian search demand
  • Build keyword lists for CIS markets
  • Analyze Yandex Wordstat data with an AI assistant
  • Support keyword planning for market analysis

Key features

  • Five MCP tools for Yandex Wordstat
  • Yandex Cloud Search API v2 access
  • Keyword research for Russian and CIS markets
  • stdio transport for MCP clients
  • npx installation without a build step

Tools5

What Yandex Wordstat MCP lets your agent do. Expand a tool for its parameters.

Verified live~976 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

What it can do

From the 5 tools this server returned when we ran it; 5 declare their own safety hints.

Makes network requests · 5Read-only tools · 5
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age13 days
Maintainers1

Observed 2026-10-28 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 21h ago via OSV.dev · @stufently/yandex-wordstat-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars19Stargazers on the source repository.
npm downloads370Package downloads in the last 30 days.
Last commit2d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed5Callable tools this server registers over MCP.

How Yandex Wordstat MCP works

What @stufently/yandex-wordstat-mcp does

@stufently/yandex-wordstat-mcp connects an MCP-compatible AI assistant to Yandex Wordstat through the Yandex Cloud Search API v2. Its scope is keyword research, with five tools exposed for working with Wordstat data. The package is intended for analysis focused on Russian and CIS markets, where Yandex search behavior is relevant.

The package is separate from the repository’s other Yandex MCP servers. Those cover search, Webmaster, Metrika, and Direct APIs; installing the Wordstat package provides the Wordstat tools only.

How it works

The server communicates with clients over standard input and output. A client starts the package as a Node.js process, and the MCP connection makes its five Wordstat tools available to the assistant. No repository checkout, local build, or Bun installation is needed for the npx installation path.

Authentication uses a Yandex Cloud API key and a Yandex Cloud folder ID. The server reads these values from environment variables when a tool call requires access. It can start without the variables, but the first tool call fails if the required configuration is absent.

Setup and configuration

Node.js 22 or newer is required. The package can be started directly from a shell:

bash
WORDSTAT_API_KEY=your-cloud-api-key WORDSTAT_FOLDER_ID=your-folder-id npx -y @stufently/yandex-wordstat-mcp

MCP clients can use the same command with WORDSTAT_API_KEY and WORDSTAT_FOLDER_ID in the server’s environment configuration. Claude Code has both project configuration and command-line registration examples, while Claude Desktop can launch the package through its MCP configuration. Cursor, Windsurf, and Zed configurations are also documented in the project’s client setup.

Use the scoped package name exactly as shown. The unscoped yandex-wordstat-mcp name belongs to a different publisher, so it should not be substituted when credentials are present in the environment.

To avoid resolving a different package version on every start, append a package version to the scoped npx name. The unversioned command resolves the latest release available under the @stufently scope.

Tools and capabilities

The package exposes five MCP tools for Yandex Wordstat keyword research. Together, they provide the interface an agent needs to query Wordstat data for keyword analysis. The repository identifies the underlying service as Yandex Wordstat through the Cloud Search API v2.

Typical uses include examining search demand, developing keyword sets, and supporting Russian- or CIS-focused market research. The available tools are intended for Wordstat analysis rather than site monitoring, web traffic reporting, or advertising campaign management; those functions belong to the repository’s separate Webmaster, Metrika, and Direct packages.

Limitations and notes

The Wordstat package requires access to the relevant Yandex Cloud credentials and a configured folder ID. Its documented runtime path is stdio, and the package requires Node.js 22 or newer. Client support should be understood separately from verification: Claude Code use is reported as verified on the maintainer’s Ubuntu host, while Codex is configured but not checked separately. Cursor, Windsurf, and Zed are documented configurations rather than end-to-end verified clients.

The package is one component of a larger monorepo. Installing it does not expose the other Yandex API groups or their tools.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Yandex Wordstat MCP

@stufently/yandex-wordstat-mcp is an MCP server that connects AI assistants to Yandex Wordstat through the Yandex Cloud Search API v2. It exposes five keyword-research tools for Russian and CIS market analysis and authenticates with a Wordstat API key plus a Yandex Cloud folder ID.

Install it with npx by running `WORDSTAT_API_KEY=your-cloud-api-key WORDSTAT_FOLDER_ID=your-folder-id npx -y @stufently/yandex-wordstat-mcp`. Node.js 22 or newer is required, and no clone or build step is needed.

Set `WORDSTAT_API_KEY` and `WORDSTAT_FOLDER_ID`. The first is the Yandex Cloud API key, and the second is the Yandex Cloud folder ID used by the Wordstat service.

Yes, it works with Claude Code over stdio. Register the npx command and provide `WORDSTAT_API_KEY` and `WORDSTAT_FOLDER_ID`; Claude Code usage is verified on the maintainer’s Ubuntu host.

Yes, configurations are documented for Cursor, Windsurf, and Zed. These client setups are documented rather than reported as end-to-end verified, and each client should start the scoped npx package with the two Wordstat environment variables.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewYandex Wordstat MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/stufently-yandex-wordstat-mcp?style=directory)](https://allmcps.com/mcp/stufently-yandex-wordstat-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/stufently-yandex-wordstat-mcp"><img src="https://allmcps.com/api/badge/stufently-yandex-wordstat-mcp?style=directory" alt="Yandex Wordstat MCP on AllMCPs" /></a>