Mutagen MCP: Wordstat frequencies and a semantic core with a budget

mutagen-ru-mcp

An unofficial MCP server, CLI and Node.js client for Mutagen: frequencies, competition, cores and clusters, with a cost estimate before each paid call

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

Extended access

Why this level

  • Paid calls charge rubles to the Mutagen balance: without the `MUTAGEN_BUDGET_RUB` cap the agent spends up to 50 rubles per process
  • The Mutagen API works only over unencrypted HTTP, so the key can be intercepted on the network
All reasons and checks
Russian stack

svorobiev-ru/mutagen-ru-mcp

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/mutagen-ru-mcp

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

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Paid calls charge rubles to the Mutagen balance: without the `MUTAGEN_BUDGET_RUB` cap the agent spends up to 50 rubles per process
  • The Mutagen API works only over unencrypted HTTP, so the key can be intercepted on the network

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

What it does

The `mutagen-ru-mcp` package connects the agent to Mutagen (mutagen.ru), a Russian service built on Wordstat data. The tools are `mutagen_build_core` (semantic core assembly), `mutagen_expand_core`, `mutagen_wordstat_keywords`, `mutagen_frequency`, `mutagen_competition`, `mutagen_cluster`, `mutagen_content_gap`, `mutagen_domain_report`, `mutagen_keyword_report`, `mutagen_minus_words` and `mutagen_direct_bids`, plus ready scenarios (MCP prompts). Before a paid call the agent shows an estimate in `dry_run` mode, and `MUTAGEN_BUDGET_RUB` sets the spending cap (50 rubles by default). The same package provides the `mutagen-ru` CLI and a Node.js library: the core can be rebuilt on a schedule and exported to CSV, XLSX and JSON. Launch: `npx -y mutagen-ru-mcp`, with an HTTP mode as well.

Who it is for. SEO specialists and site owners who build a semantic core and want an agent that does not overspend on paid requests.

Good fit when

  • You must build a core for a niche and spread phrases over pages with the spend capped in advance
  • Before a paid run you need an estimate in rubles to approve the budget
  • The core rebuild should go into cron or GitHub Actions and arrive as a pull request
  • Direct needs minus words and bids for the same phrases

Not a fit when

  • You need Wordstat data directly from Yandex: the server works through the third-party paid Mutagen service
  • You have no Mutagen account and balance: calls are charged to it and Mega-tool reports need a subscription
  • You need a product from Mutagen itself: the project is unofficial and not affiliated with the service

Example request

Build a semantic core for the "stretch ceilings" section with a budget of 15 rubles and show the estimate first

MCP

Transport
stdio, http
Authentication
API key

Environment variables

MUTAGEN_API_KEY required, secret
API key from the Mutagen console
MUTAGEN_BUDGET_RUB
Spending cap in rubles per server process, 50 by default
MUTAGEN_MCP_HTTP_TOKEN secret
Token for HTTP mode beyond localhost

Limitations

The project is unofficial and unaffiliated with Mutagen, and the data belongs to the service. An API key from the console and a balance are required: frequency costs from 0.02 RUB per phrase, competition 0.30 RUB, and Mega-tool reports are available only with a subscription. The Mutagen API works over HTTP, so the console advises enabling an IP restriction. The `MUTAGEN_BUDGET_RUB` spending cap applies to the whole server process until its restart, and without it 50 rubles applies. The registration link in the README is a partner link. Zero stars, last commit in October 2026, MIT license.

How to disable. Remove the server from the client config with `claude mcp remove mutagen`, revoke the API key in the Mutagen console and clear the `MUTAGEN_API_KEY` and `MUTAGEN_BUDGET_RUB` variables.

FAQ

How much does the server cost to use?

The package is free, while Mutagen calls are charged to the balance: frequency from 0.02 RUB per phrase, competition 0.30 RUB. Mega-tool reports charge no money but require a subscription.

How do I avoid overspending?

The agent first shows an estimate in `dry_run` mode, and `MUTAGEN_BUDGET_RUB` sets a hard cap in rubles; without it 50 rubles applies.

What does `mutagen_build_core` do?

It collects tails of marker phrases, removes duplicates and junk, takes exact frequency and groups phrases into clusters.

Can it run over HTTP?

Yes: `npx -y mutagen-ru-mcp --http --port 3333`. If it listens beyond localhost, the `MUTAGEN_MCP_HTTP_TOKEN` token is required.

Is there a CLI without an agent?

Yes, the same package installs the `mutagen-ru` command and a Node.js library with a shared cache, job log and budget limit.

Discussion

No questions or reviews yet.

Russian stack

An MCP server for the Just-Magic.org platform: query clustering, LSI text analysis and Wordstat frequency in one session

MCP serverExtended access
Russian stack

A connector to the hosted Marketscore service: Yandex Wordstat frequency and seasonality in Claude and ChatGPT, with noise filtering

MCP serverExtended access2Repository stars

Yandex Wordstat MCP

Яндекс Вордстат MCP

Russian stack

Wordstat MCP server via Yandex Cloud Search API: query volume and related queries, seasonality, demand by region and device

MCP serverExtended access9Repository stars
Russian stack

Five MCP servers for Wordstat, Search, Webmaster, Metrica and Direct, plus a Claude Code plugin with keyword and competitor skills

MCP serverBroad access1Repository stars

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 access1Repository stars

README in short

The README in Russian and English covers a quick start with a key and balance check, connection to Claude Code, Claude Desktop, Codex, Cursor, VS Code and Windsurf, the HTTP mode, workflows with estimates (core, clusters, Title and Description, minus words for Direct) and honest notes on price and API limits.

README badge

Report a problem