Direct, Metrika, Wordstat and Webmaster MCP server
Yandex MCP Server
An MCP server with 141 tools: full Direct campaign management, Metrika counters and goals, Wordstat and Webmaster
High risk
We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.
Why this level
- It creates, stops and deletes campaigns, ads and keywords directly in the live Direct account
- metrika_delete_counter deletes a Metrika counter with its entire data history, with no way back
- Start with YANDEX_USE_SANDBOX=true and a minimally scoped token until you trust the agent's behavior
Install
Manual install
git clone https://github.com/seklekov/yandex-direct-mcp.git && cd yandex-mcp && python -m venv .venv && source .venv/bin/activate && pip install -e .Install from source, then set YANDEX_TOKEN in .env.
This is third-party code. Review the repository files before installing.
What it does
A Python server exposes 141 tools across four Yandex APIs. Direct (80 tools) covers the full cycle: creating, pausing, archiving and deleting campaigns, ad groups and ads of every type, bids and modifiers, retargeting, smart ad targets, business cards, feeds, video and stats. Metrika (43 tools) manages counters, goals, segments, filters, access grants, and uploads offline conversions, calls and expenses. Wordstat (5 tools) returns query frequency, dynamics and regions. Webmaster (13 tools) adds and verifies sites, submits URLs for recrawl and reads popular queries. Create, update and delete tools exist almost everywhere: the server does not just read, it directly changes campaigns and counters.
Who it is for. For PPC specialists who want to run Direct campaigns and Metrika entirely through an agent.
Good fit when
- You need to not just read but create and change campaigns, ads, bids and goals from chat
- You want one server covering Direct, Wordstat, Webmaster and Metrika at once
- You are ready to test in the Direct sandbox before making live changes
Not a fit when
- You only need safe read-only access to reports: most of this server exposes delete and change operations
- You do not have time to review the agent's actions carefully before confirming
Example request
Pause the Summer sale campaign and raise the bid on the keyword buy iphone to 60 rublesLimitations
The package is not published to PyPI; install by cloning and pip install -e. Wordstat only works via the new Search API v2 with a Yandex Cloud service-account key, the old OAuth Wordstat API is shut down. Metrika can delete a counter entirely with all its data: the metrika_delete_counter tool is irreversible.
How to disable. Remove the yandex server from your MCP client settings and stop the process or container.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| YANDEX_TOKEN required, secret | OAuth token for Direct and Metrika, one shared token can be used |
| YANDEX_WORDSTAT_API_KEY secret | Yandex Cloud service-account key for Wordstat via Search API v2 |
| YANDEX_USE_SANDBOX | true routes Direct requests to the sandbox instead of the live account |
Security check
- It creates, stops and deletes campaigns, ads and keywords directly in the live Direct account
- metrika_delete_counter deletes a Metrika counter with its entire data history, with no way back
- Start with YANDEX_USE_SANDBOX=true and a minimally scoped token until you trust the agent's behavior
README in short
The English README (with a README.ru.md counterpart) lists all 141 tools across four APIs, grouped into campaigns, ads, bids, retargeting and feeds among others, gives environment variables for separate Direct and Metrika tokens, example user phrasing, three run methods including Docker, and a security section advising sandbox use and minimum token scopes.
FAQ
Can it be tested without risking the live account?
Yes, setting YANDEX_USE_SANDBOX=true routes Direct requests to Yandex's sandbox.
What does Wordstat need?
A separate Yandex Cloud service-account key for Search API v2; the old OAuth Wordstat API no longer works.
Related
Official DataLens (Yandex) skills for Claude Code, Codex and OpenCode: SDK, HTML reports and RLS resolution
A Yandex Metrika MCP server generated from the API spec: 108 methods, 10 tools declared by default, transparent filters and response metadata
An open MCP server and agent skill set for SEO: keyword research, competitors, backlinks and site audits powered by DataForSEO
A Claude Code plugin for SEO audits: technical SEO, E-E-A-T, schema, local and AI search via parallel subagents