Yandex Direct MCP
Manage Yandex Direct ad campaigns, keywords and stats from an AI chat
- Pricing
- Open source
- Platforms
- CLI, API, self-hosted
- Runs
- Locally
- Version
- 1.14.0
- Listing updated
- today
Similar MCP servers
About Yandex Direct MCP
Yandex Direct MCP is an open-source MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.
The README is written in Russian and describes 46 tools covering campaigns, ad groups, ads, keyword phrases, bids, bid adjustments, extensions, statistics, account balance and reference data. Account connection can also happen inside the conversation: the assistant gives a Yandex sign-in link, you confirm access and send back the code, and access then lasts about a year.
There are two ways to connect. A remote server at mcp.askads.ru is read-only and suited to statistics, audits and browsing objects. The local npx package gives full access, including creating and editing objects. New campaigns and ads can only be created as text type; campaigns of other types can be read, renamed, stopped, archived and deleted by ID.
Local changes apply to the live ad account and can affect spend, and the registry entry warns that the OAuth token gives full account access. A sandbox switch (YANDEX_DIRECT_SANDBOX) points calls at the Yandex Direct test API instead. Money values are shown in the account currency rather than API micro-units, and agency accounts can pick a client by login.
Install
Run in a terminal
claude mcp add mcp-yandex-direct --env YANDEX_DIRECT_TOKEN='<YANDEX_DIRECT_TOKEN>' -- npx -y mcp-yandex-directAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-yandex-direct": {
"command": "npx",
"args": [
"-y",
"mcp-yandex-direct"
],
"env": {
"YANDEX_DIRECT_TOKEN": "<YANDEX_DIRECT_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-yandex-direct": {
"command": "npx",
"args": [
"-y",
"mcp-yandex-direct"
],
"env": {
"YANDEX_DIRECT_TOKEN": "<YANDEX_DIRECT_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-yandex-direct": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-yandex-direct"
],
"env": {
"YANDEX_DIRECT_TOKEN": "<YANDEX_DIRECT_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-yandex-direct": {
"command": "npx",
"args": [
"-y",
"mcp-yandex-direct"
],
"env": {
"YANDEX_DIRECT_TOKEN": "<YANDEX_DIRECT_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-yandex-direct": {
"command": "npx",
"args": [
"-y",
"mcp-yandex-direct"
],
"env": {
"YANDEX_DIRECT_TOKEN": "<YANDEX_DIRECT_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
YANDEX_DIRECT_TOKENYandex Direct OAuth token — full account access (can spend budget). Treat it as a secret.RequiredYANDEX_DIRECT_LOGINDefault client login on agency tokens; any tool can override it with client_login.YANDEX_DIRECT_CLIENTSComma-separated logins of managed (non-agency) accounts, shown by list_clients.YANDEX_DIRECT_SANDBOXSet to true to call the Yandex Direct sandbox API instead of production.YANDEX_DIRECT_LANGLanguage for API responses and error messages (ru, en, ...).
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- list_clients
- Lists managed client accounts.
- set_campaign_strategy
- Changes the strategy and weekly budget of text and unified campaigns.
What it does
- 46 tools
- Covers campaigns, groups, ads, keywords, bids, adjustments, extensions and statistics.
- Two connection modes
- Read-only remote URL or full-access local npx package.
- In-chat sign-in
- Connect a Yandex account by following a link and sending back a code.
- Sandbox mode
- An environment variable switches calls to the Yandex Direct sandbox API.
- Readable money values
- Budgets, bids and balance appear in account currency, not micro-units.
- Agency client switching
- Pick a client login per call or list managed clients.
Good for
- Find which campaigns spent the most last week
- Review keywords that spend budget without clicks
- Check balance and remaining daily API quota
- Add keyword phrases to an ad group with a set bid
- Compare spend per client across an agency's accounts
Pricing
Open source
Runs through npm; remote URL available for read-only use
Yandex Direct MCP FAQ
Can it change my ads?
The local npx version can create and edit objects in the live account. The remote URL version is read-only.
Is there a way to test safely?
Yes. Setting YANDEX_DIRECT_SANDBOX to true makes it call the Yandex Direct sandbox API.
What does it need to run locally?
Node.js 20 or newer and a Yandex Direct OAuth token, which can be obtained through the in-chat sign-in.
Which campaign types can it create?
Only text campaigns and ads. Other campaign types can be read, renamed, stopped, archived or deleted.
Is Yandex Direct MCP free?
Yes. Yandex Direct MCP is open source, so you can use and self-host it for free.
How do I add Yandex Direct MCP to Claude Code?
Run this command in your terminal: claude mcp add mcp-yandex-direct --env YANDEX_DIRECT_TOKEN='<YANDEX_DIRECT_TOKEN>' -- npx -y mcp-yandex-direct
What are the best alternatives to Yandex Direct MCP?
The closest alternatives to Yandex Direct MCP are Google Ads + Meta Ads + SEO/GEO MCP, Calven, Customer Io, Google_search_console and Ads AI Creator MCP.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.
