yandex-tools-mcp
Five MCP servers for Wordstat, Search, Webmaster, Metrica and Direct, plus a Claude Code plugin with keyword and competitor skills
- 0 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- In Direct live mode it creates campaigns and changes budgets and bids, spending real money
- Holds OAuth tokens and a Yandex Cloud key
Install
- Works in
- Services
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/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.
- In Direct live mode it creates campaigns and changes budgets and bids, spending real money
- Holds OAuth tokens and a Yandex Cloud key
This is third-party code. Review the repository files before installing.
What it does
A set of five separate npm packages gives the agent Yandex APIs. Wordstat shows popular queries, trends and regional distribution, Search returns results, Webmaster provides site indexing and query data, and Metrica gives traffic statistics. The Direct server reads campaigns, ad groups, ads, keywords, bids and reports, and also creates and changes campaigns, ads, keywords and bids. All packages can be installed as one Claude Code plugin that includes skills for keyword research and competitor SERP analysis.
Who it is for. For SEO and PPC specialists working with Yandex.
Good fit when
- You need Wordstat queries and volumes right in an agent chat
- You want to see which sites rank in Yandex for given queries
- You need a Direct campaign report or Metrica traffic data
Not a fit when
- You are not ready to give the agent a Direct OAuth token for a live account
- You need Audiences or other Yandex services not in the set
Example request
Use Wordstat to pull top queries for apartment renovation in Saint Petersburg and show whether demand grew over the past yearMCP
- Transport
- stdio
- Authentication
- OAuth
Environment variables
YANDEX_SEARCH_API_KEYsecret- Yandex Cloud API key for Search and Wordstat
YANDEX_FOLDER_ID- Yandex Cloud folder ID
YANDEX_WEBMASTER_TOKENsecret- Webmaster OAuth token
YANDEX_METRIKA_TOKENsecret- Metrica OAuth token
YANDEX_DIRECT_TOKENsecret- OAuth token with Direct API access
YANDEX_DIRECT_LIVE- Set to 1 to switch Direct from sandbox to the live account
YANDEX_DIRECT_LOGIN- Client login for agency accounts
Limitations
Wordstat and Search need an API key and folder ID in Yandex Cloud, where these APIs are paid. Webmaster, Metrica and Direct use OAuth tokens, and Direct needs your own app with API access. The Direct server defaults to the sandbox and changes real campaigns only with YANDEX_DIRECT_LIVE=1.
How to disable. Remove the yandex-* blocks from the client MCP config or stop launching Claude Code with --plugin-dir, then revoke the OAuth tokens in Yandex ID settings.
FAQ
Can the agent spend money in Direct?
Yes, if live mode is enabled with YANDEX_DIRECT_LIVE=1: tools create campaigns and change budgets and bids. Without it all changes go to the sandbox.
Can I install only Wordstat?
Yes, each server is a separate npm package with its own config block.
Discussion
No questions or reviews yet.
Related
All Yandex Wordstat toolsYandex 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 Yandex Search, Wordstat, Webmaster, Metrika and Direct, bundled as a Claude Code plugin with two skills
Monorepo of Yandex MCP servers: Direct, Metrica, Webmaster, Wordstat, Tracker, 360, Maps, SpeechKit, YandexGPT and AppMetrica
A ZAI.ONE MCP server bringing Direct, Metrika, search, Wordstat and Webmaster into one agent, with a setup wizard and opt-in write operations
An MCP server for Yandex Direct, Metrika, Wordstat and Webmaster: campaigns, ads, bids, reports and keyword research from chat
An MCP server for Yandex Wordstat via the official Yandex Cloud Search API: frequency, related queries, dynamics and regions
README in short
The English and Russian README lists five packages with ready npx config blocks and required variables. It separately covers running all servers as a Claude Code plugin with two built-in skills. The Direct package README warns about real spending, explains getting an OAuth token and lists tools marked read or write. MIT licensed.