SkillFoxx

Wordstat MCP Server: Yandex frequencies with limits and a cache

wordstat-mcp-server

An unofficial read-only Wordstat MCP server in TypeScript: five tools, local call limits, a region cache and spend counters

  • 0 ★ on the repository
  • Last commit
  • MIT
MCP server

Minimal access

Why this level

  • The server only reads statistics, but Wordstat calls are billed by Yandex and use the paid quota
All reasons and checks
Russian stack

solaix/wordstat-mcp-serverAuthor:solaix

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/wordstat-mcp-server

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Minimal accessThe tool runs nothing and makes no network calls.

  • The server only reads statistics, but Wordstat calls are billed by Yandex and use the paid quota

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

What it does

An unofficial TypeScript MCP server for the Yandex Wordstat API. Five tools, all marked read-only and idempotent: `wordstat_top_requests` (top and related queries over 30 days), `wordstat_dynamics` (dynamics by day, week and month with automatic date selection), `wordstat_regions`, `wordstat_regions_tree` and `wordstat_find_regions` (local lookup of a region id by name). Authorization has one method of your choice: the `YANDEX_WORDSTAT_API_KEY` API key or the `YANDEX_WORDSTAT_IAM_TOKEN` IAM token with `YANDEX_WORDSTAT_FOLDER_ID`. Inside are local limits on requests per second, per hour and on concurrency, retries that respect `Retry-After`, a region tree cache and API call counters. Launch `npx -y wordstat-mcp-server@latest`.

Who it is for. Analysts and SEO specialists who must not exceed the Search API quota: call limits and spend counters live on the server side.

Good fit when

  • The agent reviews many phrases and Wordstat call spend must stay under control
  • You need frequency dynamics without calculating period boundaries by hand
  • You must find a region id for a request from a city or oblast name
  • The server connects to Codex, Claude Code or Hermes Agent with a ready config

Not a fit when

  • You need web search over Yandex results: the server returns only Wordstat data
  • Your Node.js is old: 22.23.4, 24.22.1 or 26.12.1 or newer in its line is required
  • You need non-standard Wordstat API methods: the set has no arbitrary request

Example request

Find the region id for Kazan and show the monthly dynamics of the phrase "apartment renovation" for the last year

MCP

Transport
stdio
Authentication
key is optional

Environment variables

YANDEX_WORDSTAT_API_KEY secret
API key with the yc.search-api.execute scope (or an IAM token)
YANDEX_WORDSTAT_IAM_TOKEN secret
IAM token instead of an API key
YANDEX_WORDSTAT_FOLDER_ID
Yandex Cloud folder for a Yandex account IAM token

Limitations

Node.js 22.23.4, 24.22.1 or 26.12.1 or newer in its line is required, plus one credential: an API key with the `yc.search-api.execute` scope or an IAM token with the `search-api.webSearch.user` role on the folder. Requests are billed by Yandex, and each next page of `wordstat_regions` is paid again. The latest calendar points of dynamics may not be published yet, and a range after the last point sometimes returns HTTP 400. Version status 0.1.1, zero stars, last commit in November 2026. The project is unofficial and not affiliated with Yandex.

How to disable. Remove the server from the Codex, Claude Code or Hermes Agent config and revoke the key or IAM token in Yandex Cloud.

FAQ

Which tools are there?

Five: top queries, dynamics, regional distribution, the region tree and a local region lookup by name.

Which authorization should I choose?

One of two: an API key or an IAM token. Both at once are not allowed; a Yandex account IAM token also requires `YANDEX_WORDSTAT_FOLDER_ID`.

How do I connect it to Hermes Agent?

Add an `mcp_servers` block with `npx -y wordstat-mcp-server@latest` to `~/.hermes/config.yaml`, check with `hermes mcp test yandex_wordstat` and reload MCP.

Are requests paid?

Yes, Yandex may bill Wordstat calls; the server keeps counters so the spend is visible.

What about dynamics dates?

With `auto_dates: true` the server itself takes the last completed periods: 60 days, 52 weeks or 12 months.

Discussion

No questions or reviews yet.

All Yandex Wordstat tools

Yandex Wordstat MCP Server by khanton

Yandex Wordstat MCP Server

Russian stack

A compact TypeScript MCP server for Yandex Wordstat via the Yandex Search API: top queries, dynamics and regions

MCP serverExtended access1
Russian stack

A compact MCP server on the official SDK for five Yandex Wordstat operations: top requests, dynamics, regions, region tree, account info

MCP serverExtended access
Russian stack

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

MCP serverExtended access3
Russian stack

A read-only MCP server for Yandex Wordstat statistics: top phrases, dynamics, regions, with OAuth sign-in for ChatGPT

MCP serverExtended access
Russian stack

A Wordstat MCP server via the Yandex Search API that estimates and tracks request cost before and after each call

MCP serverExtended access
Russian stack

An MCP server for Yandex Wordstat via the official Yandex Cloud Search API: frequency, related queries, dynamics and regions

MCP serverExtended access2

README in short

The README gives status 0.1.1, features (all Wordstat API methods, input and output schemas, retries, limits, cache, counters), requirements, two authorization methods, connection to Codex, Claude Code and Hermes Agent, a tool table and date nuances.

README badge

Report a problem