Yandex Direct MCP server (npm)
@theyahia/yandex-direct-mcp
A TypeScript MCP server with an npm package: 20 tools for Yandex Direct campaigns, bids and negative keywords, with money always in rubles
- 4 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Creates and changes campaigns, ads and bids in the live ad account
- Can spend real budget when sandbox mode is not enabled
Install
- Works in
- Services
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/theyahia-yandex-direct-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.
- Creates and changes campaigns, ads and bids in the live ad account
- Can spend real budget when sandbox mode is not enabled
This is third-party code. Review the repository files before installing.
What it does
The server wraps the Yandex Direct API into 20 MCP tools: listing and creating campaigns, ad groups with region targeting, text ads with headline and body length checks, keywords and bids, negative keywords at the group and campaign level, statistics and account balance. All money values in and out are in rubles; the server converts them to the API's micro-units itself. It supports a sandbox mode via YANDEX_DIRECT_SANDBOX for testing without real spending, and an agency mode with a Client-Login header for acting on a client's behalf. It ships its own SKILL.md for analyzing campaign performance.
Who it is for. For PPC specialists and agencies running Yandex Direct campaigns through an agent who want money in rubles rather than the API's micro-units.
Good fit when
- You want an npm MCP package for Direct with an npx command and no build step
- You need to act on behalf of an agency's clients via an agency token
- You want a ready skill for analyzing a campaign's spend and bids
Not a fit when
- You have no OAuth token and Direct API access: the server will not work without an application submitted in the Direct interface
- You need image uploads or image ads: there are no tools for that
Example request
Show spend and CTR for Yandex Direct campaign 12345 over the last two weeksMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
YANDEX_DIRECT_TOKENrequired, secret- Yandex Direct OAuth token
YANDEX_DIRECT_SANDBOX- Enables the sandbox with no real spending
YANDEX_DIRECT_LOGIN- Client login for agency tokens
Limitations
You need an OAuth token from an application registered in Yandex OAuth and a separate application for Direct API access. Agency tokens require the client's login in the YANDEX_DIRECT_LOGIN variable. Tools for creating campaigns, ads, keywords and bids change the live account and spend money immediately; sandbox mode is opt-in and not on by default. The package is young, and its CHANGELOG shows a recent start.
How to disable. Remove the server with claude mcp remove yandex-direct, or delete the yandex-direct block from your MCP client config.
FAQ
What currency is used for input and output?
Rubles everywhere; the server converts them to the micro-units the Direct API uses internally.
Can it act on behalf of an agency's client?
Yes, agency mode is enabled with the YANDEX_DIRECT_LOGIN variable set to the client's login, and the server adds a Client-Login header.
Discussion
No questions or reviews yet.
Related
All Yandex Direct toolsYandex Direct MCP server in Ruby
yandex-direct-mcp
A dependency-free, pure Ruby MCP server with 30 tools for Yandex Direct campaigns, ad groups, ads, keywords and reports
Yandex Direct MCP
yandex-direct-mcp
A Claude Code and Codex plugin for Yandex Direct: a 147-tool MCP server, OAuth, and skills for ad copy and stats analysis
Dependency-free Node MCP for Yandex Direct
yandex-direct-mcp
A single-file, dependency-free Node.js Direct API v5 MCP server with a universal direct_call tool and a read-only mode
Yandex Direct MCP: hardened fork
yandex-direct-mcp
A fork of a popular Yandex Direct MCP server that defaults to read-only, with explicit flags for writes and finance
Monorepo of Yandex MCP servers: Direct, Metrica, Webmaster, Wordstat, Tracker, 360, Maps, SpeechKit, YandexGPT and AppMetrica
Python MCP for Yandex Direct and Wordstat
Yandex.Direct MCP
A Python MCP server with 48 Yandex Direct tools and Wordstat frequency lookup, switchable between sandbox and production
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Yandex Direct MCP server (npm) (this card) | no | API key | 4 | |
| Yandex Direct MCP with launch policies | no | API key | 2 | policies |
| Bun-based Yandex Direct MCP with Unified Performance and Click.ru proxy | no | key is optional | 0 | Click.ru proxy |
| Yandex Direct MCP with dry-run by default | no | API key | 0 | 20 tools, edits with dry-run by default |
README in short
The README lists 20 tools across five groups: campaigns, ad groups, ads, keywords and bids, statistics and balance. It covers installation for Claude Desktop and Claude Code via npx, an environment variable table with the token, sandbox flag and client login, the steps to get an OAuth token, and an explicit warning that some tools spend real money. MIT license, published on npm.