Simple Yandex Wordstat MCP
wordstat-mcp
A compact MCP server on the official SDK for five Yandex Wordstat operations: top requests, dynamics, regions, region tree, account info
Low risk
We rate an entry low when it mostly gives the agent instructions and reference material.
Why this level
- Only reads query statistics, does not change anything in external systems
Install
Manual install
npm install && npm run build && npm startBuild and run from source, the key is passed via WORDSTAT_API_TOKEN.
This is third-party code. Review the repository files before installing.
What it does
The server provides five Wordstat tools: top requests, frequency dynamics, a regional distribution, a region tree, and current API user info. It is built on the official @modelcontextprotocol/sdk with stdio transport, and the key is passed through one WORDSTAT_API_TOKEN environment variable. There is a simple response cache module. The repository has no README, but the code is short and easy to read directly: the src/index.ts entry point registers the five tools and returns a JSON text result or a structured error.
Who it is for. For people who want a minimal Wordstat server without extra logic on top of the official SDK
Good fit when
- You want a simple Wordstat MCP server that is easy to read and adapt
- You only need the basics: top requests, dynamics, regions
- You already have a Yandex Wordstat API key and need a quick local server
Not a fit when
- You need documentation and ready config examples: the repository has none
- You need spending control or budget caps on paid calls
Example request
Show the top requests for "flower delivery" and break them down by regionLimitations
The repository has no README, no stars, and a single author. There is no npm package of its own; you install it from source with a TypeScript build. There is no cache between runs and no cost tracking for paid Wordstat calls.
How to disable. Remove the server from your MCP client config and stop the node dist/index.js process if it runs separately.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| WORDSTAT_API_TOKEN required, secret | Yandex Wordstat API key |
Security check
- Only reads query statistics, does not change anything in external systems
README in short
There is no README. This description is based on the code: package.json declares a wordstat-mcp binary and standard TypeScript build, start and dev scripts, while src/index.ts wires up the MCP SDK, checks for WORDSTAT_API_TOKEN, and registers five Wordstat tools with error handling in the text response.
FAQ
Is there a README?
No, but the code is small: five tools in src/tools and a Wordstat client in src/api, readable directly from source.
Which environment variable is required?
WORDSTAT_API_TOKEN; the server exits with an error on startup if it is not set.
Related
Official DataLens (Yandex) skills for Claude Code, Codex and OpenCode: SDK, HTML reports and RLS resolution
A Yandex Metrika MCP server generated from the API spec: 108 methods, 10 tools declared by default, transparent filters and response metadata
An open MCP server and agent skill set for SEO: keyword research, competitors, backlinks and site audits powered by DataForSEO
A Claude Code plugin for SEO audits: technical SEO, E-E-A-T, schema, local and AI search via parallel subagents