Open source · MIT · Node.js 22+
MCP servers for Yandex Search, Wordstat, Webmaster, Metrika and Direct
Five MCP servers, 94 tools: give Claude, Cursor or Codex access to Yandex Search, Wordstat, Webmaster, Metrika and Direct. Run with npx, MIT.
What it does
- Yandex Search: run Search API v2 queries and get ranked results with domains.
- Yandex Wordstat: monthly search volume, trends, regional demand and related queries.
- Yandex Webmaster: 33 tools for indexing, search queries, sitemaps, recrawl and site problems.
- Yandex Metrika: traffic summaries, sources, landing pages, geography and custom reports.
- Yandex Direct: 43 tools for campaigns, ads, keywords, bids and reports; irreversible writes need confirm: true.
- Works in Claude Code, Claude Desktop, Cursor, Windsurf, Zed and Codex; also ships as a Claude Code plugin and Docker image.
Install
Paste this into a terminal. It starts the Webmaster server on stdin; the same npx command is what every client block below runs.
YANDEX_WEBMASTER_TOKEN=your-oauth-token npx -y @stufently/yandex-webmaster-mcpNode.js >= 22 is the only prerequisite — no clone, no Bun, no build step. Swap the package and the variables for another server:
| Server | Command | Variables it needs |
|---|---|---|
| Search | npx -y @stufently/yandex-search-mcp | YANDEX_SEARCH_API_KEY, YANDEX_FOLDER_ID |
| Wordstat | npx -y @stufently/yandex-wordstat-mcp | WORDSTAT_API_KEY, WORDSTAT_FOLDER_ID |
| Webmaster | npx -y @stufently/yandex-webmaster-mcp | YANDEX_WEBMASTER_TOKEN |
| Metrika | npx -y @stufently/yandex-metrika-mcp | YANDEX_METRIKA_TOKEN |
| Direct | npx -y @stufently/yandex-direct-mcp | YANDEX_DIRECT_TOKEN (+ optional YANDEX_DIRECT_CLIENT_LOGIN, YANDEX_DIRECT_SANDBOX) |
All five servers start without their variables and fail only on the first tool call, with an error that names the missing variable.
Append a version (@stufently/yandex-webmaster-mcp@2.2.1) to pin it instead of taking the
latest release on every start. The OAuth helper runs the same way:
npx -y @stufently/yandex-webmaster-mcp auth (and @stufently/yandex-metrika-mcp auth).
Do not npx the unscoped names — they belong to a different publisher (see the note
above).
Example prompts
- Why did my site lose clicks last week?
- Which search phrases send the most visits to example.com?
- How many people search for this phrase on Yandex each month, and is that demand growing?
- Pause the Direct campaign that spent the most yesterday, then show me its new state.
FAQ
How do I install Yandex MCP?
No clone or build is needed. With Node.js 22 or newer, run a server with npx, for example YANDEX_WEBMASTER_TOKEN=your-oauth-token npx -y @stufently/yandex-webmaster-mcp, and register the same command in your MCP client.
Which Yandex APIs are covered?
Five servers: Yandex Search API v2, Wordstat (Cloud Search API v2), Webmaster API v4, Metrika API and Direct API v5 — 94 tools in total.
Which AI clients does it work with?
Any MCP client over stdio. The README has ready configs for Claude Code, Claude Desktop, Cursor, Windsurf, Zed and Codex; Claude Code is verified in daily use.
Why must I use the @stufently/ package names?
The unscoped names such as yandex-webmaster-mcp on npm belong to a different publisher. Running them with your Yandex tokens in the environment hands those tokens to unrelated code, so always type the @stufently/ prefix.
Can the Direct server change my live ad account?
Yes. Every Direct write hits the production account. The fourteen irreversible tools refuse unless the call passes confirm: true, and YANDEX_DIRECT_SANDBOX=true points the server at the Direct sandbox for experiments.
Which tokens do I need?
Only the ones for the servers you enable: an API key and folder ID from Yandex Cloud for Search and Wordstat, and OAuth tokens for Webmaster, Metrika and Direct. Each server starts without them and names the missing variable on the first tool call.
Documentation pages
- Yandex MCPA monorepo of MCP (Model Context Protocol) servers for Yandex APIs. Provides AI assistants with access to Yandex Search, Wordstat, Webmaster, Metrika,…
- yandex-search-mcpMCP server for Yandex Search API v2 (Cloud). Search the web through Yandex and get structured results with titles, snippets, URLs, and metadata.
- yandex-wordstat-mcpMCP server for Yandex Wordstat via Yandex Cloud Search API v2. Research keywords, analyze search volume trends, and explore regional search distribution…
- yandex-webmaster-mcpMCP server for Yandex Webmaster API v4. Monitor site health, indexing status, search queries, backlinks, sitemaps, and more.
- yandex-metrika-mcpMCP server for Yandex Metrika API. Access web analytics data -- traffic summaries, audience demographics, traffic sources, popular pages, search phrases,…
- yandex-direct-mcpMCP server for Yandex Direct API v5 — campaigns, ad groups, ads, keywords, bids, bid modifiers, sitelinks, vCards, and reports. 43 tools.