SkillFoxx

Yandex Webmaster, Direct and Metrika MCP server

yandex-mcp

An MCP server with 125 tools for Yandex Webmaster, Direct and Metrika, multiple projects and tokens in one process

  • 0 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • Write tools change campaigns, bids, ads and goals in Direct and Metrika
  • It can upload offline conversions and CRM orders that affect the client's statistics
  • Start with a read-only token or the Direct Sandbox until you have verified the server's behavior
All reasons and checks
Russian stack

webkoth/yandex-mcpAuthor:Minas Sarkisyan

Install

Manual install

npm install && npm run build

Build from source after cloning; set the token in .env as YANDEX_OAUTH_TOKEN.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • Write tools change campaigns, bids, ads and goals in Direct and Metrika
  • It can upload offline conversions and CRM orders that affect the client's statistics
  • Start with a read-only token or the Direct Sandbox until you have verified the server's behavior

This is third-party code. Review the repository files before installing.

What it does

A TypeScript server combines three Yandex APIs in one stdio MCP process: 52 Webmaster tools (indexing, sitemaps, diagnostics, links, recrawl, feeds), 43 Direct tools (campaigns, ad groups, ads, bids, reports) and 22 Metrika tools (counters, goals, expense and CRM import, Logs API, Stat API). It ships 6 ready prompt scenarios such as a campaign audit or a weekly report. The server supports several projects with different tokens at once, and Direct and Metrika write tools require confirm true and respect the project's budget and bid change limits.

Who it is for. For marketers and agencies who manage Yandex search, ads and analytics for several projects from one agent.

Good fit when

  • You want one server for Yandex SEO, ads and analytics together
  • You manage several projects or client accounts with different tokens
  • You need guarded Direct write tools with diffs and budget limits

Not a fit when

  • You only need one of the three services: a narrower single-purpose server is simpler
  • You lack Direct access: the access request is submitted from the Direct account separately from Webmaster and Metrika

Example request

Check site indexing in Webmaster and show Direct campaign spend and conversions for the week

MCP

Transport
stdio
Authentication
API key

Environment variables

YANDEX_OAUTH_TOKEN required, secret
Yandex OAuth token for Webmaster and Metrika; Direct needs separately approved access

Limitations

The Webmaster token expires after 6 months and must be reissued. Direct access must be requested separately after registering the app; until approved, only the Direct Sandbox is available. The package is not published to the npm registry; the README only shows building from source and running locally with node.

How to disable. Remove the yandex server from your MCP client settings and stop the node process.

FAQ

Can the server's Direct changes be limited?

Yes, the project config sets a maximum budget and bid change percentage, and write tools preview a diff by default without applying it.

Do I need a separate token per API?

One OAuth token covers Webmaster and Metrika with the right scopes; Direct needs a separate access request.

Discussion

No questions or reviews yet.

All Yandex Webmaster tools
Russian stack

A 155-tool MCP server for Yandex Direct, Metrika, Wordstat and Webmaster, with self-setup OAuth and read-only and confirm modes

MCP serverBroad access3
Russian stack

A ZAI.ONE MCP server bringing Direct, Metrika, search, Wordstat and Webmaster into one agent, with a setup wizard and opt-in write operations

MCP serverBroad access1
Russian stack

An MCP server for Yandex Direct, Metrika, Wordstat and Webmaster: campaigns, ads, bids, reports and keyword research from chat

MCP serverBroad access58
Russian stack

A read-only Yandex Webmaster MCP with PKCE sign-in and no app registration needed: indexing, queries, diagnostics, backlinks

PluginBroad access4

Yandex Webmaster MCP server (npm)

@theyahia/yandex-webmaster-mcp

Russian stack

A TypeScript MCP server for the Yandex Webmaster API: sites, indexing, search queries, sitemaps, diagnostics and recrawl, 13 tools

MCP serverExtended access6

README in short

The README lists all 125 tools by group with the yandex_webmaster_, yandex_direct_ and yandex_metrika_ prefixes, explains getting an OAuth token and the specifics of requesting Direct access. It separately covers the multi-project projects.json configuration with active project switching and budget limits, plus the src directory layout.

README badge

Report a problem