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
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
Install
- Works in
- Services
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/mutagen-ru-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended 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 firstMCP
- Transport
- stdio, http
- Authentication
- API key
Environment variables
MUTAGEN_API_KEYrequired, secret- API key from the Mutagen console
MUTAGEN_BUDGET_RUB- Spending cap in rubles per server process, 50 by default
MUTAGEN_MCP_HTTP_TOKENsecret- 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.
Related
All Yandex Wordstat toolsAn MCP server for the Just-Magic.org platform: query clustering, LSI text analysis and Wordstat frequency in one session
Wordstat MCP by Marketscore
Wordstat MCP
A connector to the hosted Marketscore service: Yandex Wordstat frequency and seasonality in Claude and ChatGPT, with noise filtering
Yandex Wordstat MCP
Яндекс Вордстат MCP
Wordstat MCP server via Yandex Cloud Search API: query volume and related queries, seasonality, demand by region and device
Five MCP servers for Wordstat, Search, Webmaster, Metrica and Direct, plus a Claude Code plugin with keyword and competitor skills
Yandex Wordstat MCP Server by khanton
Yandex Wordstat MCP Server
A compact TypeScript MCP server for Yandex Wordstat via the Yandex Search API: top queries, dynamics and regions
Yandex Search and Wordstat MCP: web_search and phrase stats
mcp-yandex-search
An MCP server on a single AI Studio key: four Wordstat methods, search over the Yandex index and a raw request to the Wordstat API
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.