# Yandex MCP

> Five MCP servers, 94 tools: give Claude, Cursor or Codex access to Yandex Search, Wordstat, Webmaster, Metrika and Direct. Run with npx, MIT.

Source code: https://github.com/stufently/yandex-mcp
License: MIT

- 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.

## Documentation

- [Yandex MCP](https://stufently.github.io/yandex-mcp/docs/): A monorepo of MCP (Model Context Protocol) servers for Yandex APIs. Provides AI assistants with access to Yandex Search, Wordstat, Webmaster, Metrika,…
- [yandex-search-mcp](https://stufently.github.io/yandex-mcp/docs/yandex-search-mcp/): MCP server for Yandex Search API v2 (Cloud). Search the web through Yandex and get structured results with titles, snippets, URLs, and metadata.
- [yandex-wordstat-mcp](https://stufently.github.io/yandex-mcp/docs/yandex-wordstat-mcp/): MCP server for Yandex Wordstat via Yandex Cloud Search API v2. Research keywords, analyze search volume trends, and explore regional search distribution…
- [yandex-webmaster-mcp](https://stufently.github.io/yandex-mcp/docs/yandex-webmaster-mcp/): MCP server for Yandex Webmaster API v4. Monitor site health, indexing status, search queries, backlinks, sitemaps, and more.
- [yandex-metrika-mcp](https://stufently.github.io/yandex-mcp/docs/yandex-metrika-mcp/): MCP server for Yandex Metrika API. Access web analytics data -- traffic summaries, audience demographics, traffic sources, popular pages, search phrases,…
- [yandex-direct-mcp](https://stufently.github.io/yandex-mcp/docs/yandex-direct-mcp/): MCP server for Yandex Direct API v5 — campaigns, ad groups, ads, keywords, bids, bid modifiers, sitelinks, vCards, and reports. 43 tools.

### 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.

## Optional

- [Full text of all docs](https://stufently.github.io/yandex-mcp/llms-full.txt)