yandex-tools-mcp
Five MCP servers for Yandex APIs: Wordstat, Search, Webmaster, Metrika and Direct, plus a Claude Code plugin with skills
- 70 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- The Direct server creates and edits campaigns, ads and bids, so it spends advertising budget.
- The Metrika and Webmaster OAuth tokens expose traffic and indexing data for every site in the account.
Install
- Works in
- Services
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/seyka-ai-yandex-tools-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The Direct server creates and edits campaigns, ads and bids, so it spends advertising budget.
- The Metrika and Webmaster OAuth tokens expose traffic and indexing data for every site in the account.
This is third-party code. Review the repository files before installing.
What it does
The monorepo contains five separate npm packages, each connecting to an agent as its own MCP server. yandex-wordstat-mcp researches keywords and trends through Wordstat v2 in Yandex Cloud. yandex-search-mcp runs web search through the Yandex Search API. yandex-webmaster-mcp reads indexing and SEO data for a site. yandex-metrika-mcp returns traffic statistics. yandex-direct-mcp manages campaigns, ad groups, ads, keywords and bids and builds reports. Direct works against the API sandbox by default: to touch a real account you set `YANDEX_DIRECT_LIVE=1`. For Claude Code there is a plugin that connects all five servers at once and adds two skills, `yandex-keyword-research` and `yandex-competitive-analysis`.
Who it is for. Marketers and SEO specialists who run advertising and analytics in Yandex services and want to drive them from an agent
Good fit when
- You want Wordstat frequencies and query trends right inside an agent conversation.
- You check a site's indexing from Webmaster data and pull traffic from Metrika without manual exports.
- Direct campaigns need review: keywords, bids, ads and a spend report.
- You analyze competitors in search results through the Yandex Search API and the `yandex-competitive-analysis` skill.
Not a fit when
- You work only with Google Ads and Google Analytics: those services are not in the packages.
- You need a single service and five servers are too many: install just the package you need.
- The Direct account is live and the token's permissions have not been checked yet.
Example request
Find the Wordstat frequency for queries about "buy a sofa" over recent months and show seasonalityMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
YANDEX_SEARCH_API_KEYrequired, secret- Yandex Cloud key for Search and Wordstat
YANDEX_FOLDER_IDrequired- Yandex Cloud folder id
YANDEX_WEBMASTER_TOKENsecret- Yandex Webmaster OAuth token
YANDEX_METRIKA_TOKENsecret- Yandex Metrika OAuth token
YANDEX_DIRECT_TOKENsecret- Yandex Direct OAuth token
YANDEX_DIRECT_LIVE- Set to 1 to use the live Direct account instead of the sandbox
Limitations
Each server asks for its own credentials. Wordstat and Search use a Yandex Cloud key and a folder id (`YANDEX_SEARCH_API_KEY`, `YANDEX_FOLDER_ID`), while Webmaster, Metrika and Direct use OAuth tokens. Yandex tokens are issued through the developer console, and Direct needs API access enabled. Without `YANDEX_DIRECT_LIVE=1` Direct runs against the sandbox, so checking results on a live account is a separate step. One author maintains the repository, and the plugin launch command depends on a local path to a clone.
How to disable. Remove the server from the MCP client config or drop the plugin from `--plugin-dir`. Revoke the tokens in your Yandex account.
FAQ
How do I connect Wordstat to Claude Code?
Add an MCP server with the command `npx -y yandex-wordstat-mcp` and the `YANDEX_SEARCH_API_KEY` and `YANDEX_FOLDER_ID` variables. Wordstat here goes through the new v2 API in Yandex Cloud, and the same key works for Search.
Does Direct change real campaigns by default?
No, by default the server talks to the Direct sandbox. A live account is switched on with `YANDEX_DIRECT_LIVE=1`.
What does the Claude Code plugin add?
The plugin starts all five servers with one `claude --plugin-dir` command and adds skills for keyword research and competitor analysis.
Which variables do Webmaster and Metrika need?
`YANDEX_WEBMASTER_TOKEN` for Webmaster and `YANDEX_METRIKA_TOKEN` for Metrika. Both are Yandex OAuth tokens.
Can I install just one package?
Yes, each server installs separately through `npx -y` with its package name, for example `yandex-metrika-mcp`.
Discussion
No questions or reviews yet.
Related
All Yandex Wordstat toolsFive MCP servers for Wordstat, Search, Webmaster, Metrica and Direct, plus a Claude Code plugin with keyword and competitor skills
Five MCP servers for Yandex Search, Wordstat, Webmaster, Metrika and Direct, bundled as a Claude Code plugin with two skills
A ZAI.ONE MCP server bringing Direct, Metrika, search, Wordstat and Webmaster into one agent, with a setup wizard and opt-in write operations
Monorepo of Yandex MCP servers: Direct, Metrica, Webmaster, Wordstat, Tracker, 360, Maps, SpeechKit, YandexGPT and AppMetrica
An MCP server for Yandex Direct, Metrika, Wordstat and Webmaster: campaigns, ads, bids, reports and keyword research from chat
A 155-tool MCP server for Yandex Direct, Metrika, Wordstat and Webmaster, with self-setup OAuth and read-only and confirm modes
README in short
The bilingual README lists the five packages with a config example for each and links to hosted versions on seyka.ru. A separate section describes the Claude Code plugin with its environment variables and two skills.