Yandex Direct MCP
MCP server that manages Yandex Direct campaigns, ads, keywords, bids and reports
- Pricing
- Open source
- Platforms
- CLI
- Runs
- Locally
- Version
- 2.3.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.
Write access with no dry run is the headline caveat in the README: this server can create, update, delete and archive live campaigns and ads and set bids, and bids are expressed in micro-units, so a factor-of-1,000,000 mistake is a real risk. The author advises pointing it at the Yandex Direct sandbox (YANDEX_DIRECT_SANDBOX=true) until you trust the workflow.
As a guard, fourteen irreversible tools refuse to run unless the call carries a literal confirm: true. These are the seven delete tools, the four update tools for campaigns, ad groups, ads and keywords, and the three bid-setting tools. Without it, the tool returns an explanation and sends nothing to the Direct API. Additions, archive, suspend and moderate calls are deliberately left unguarded because each has an inverse.
It covers 43 tools for Yandex Direct API v5 across campaigns, ad groups, ads, keywords, bids, bid modifiers, sitelinks, vCards and reports. Known limits: the path is fixed to /json/v5, so the unified performance campaigns endpoint is unreachable, and the API's Units quota header is not surfaced. The npm package is not published yet, so it runs from source with Node.
Install
Run in a terminal
claude mcp add yandex-direct-mcp --env YANDEX_DIRECT_TOKEN='<YANDEX_DIRECT_TOKEN>' -- npx -y @stufently/yandex-direct-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"yandex-direct-mcp": {
"command": "npx",
"args": [
"-y",
"@stufently/yandex-direct-mcp"
],
"env": {
"YANDEX_DIRECT_TOKEN": "<YANDEX_DIRECT_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"yandex-direct-mcp": {
"command": "npx",
"args": [
"-y",
"@stufently/yandex-direct-mcp"
],
"env": {
"YANDEX_DIRECT_TOKEN": "<YANDEX_DIRECT_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"yandex-direct-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@stufently/yandex-direct-mcp"
],
"env": {
"YANDEX_DIRECT_TOKEN": "<YANDEX_DIRECT_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"yandex-direct-mcp": {
"command": "npx",
"args": [
"-y",
"@stufently/yandex-direct-mcp"
],
"env": {
"YANDEX_DIRECT_TOKEN": "<YANDEX_DIRECT_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"yandex-direct-mcp": {
"command": "npx",
"args": [
"-y",
"@stufently/yandex-direct-mcp"
],
"env": {
"YANDEX_DIRECT_TOKEN": "<YANDEX_DIRECT_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
YANDEX_DIRECT_TOKENOAuth token for Yandex Direct API v5RequiredYANDEX_DIRECT_CLIENT_LOGINClient login, only for agency accountsYANDEX_DIRECT_SANDBOXSet to true to use the Direct sandbox
Tools this server provides (43)
Taken from the project documentation; the running server may differ.
- get_campaigns
- Reads campaigns in Yandex Direct
- add_campaigns
- Creates campaigns in Yandex Direct
- update_campaigns
- Updates campaigns in Yandex Direct
- delete_campaigns
- Deletes campaigns in Yandex Direct
- archive_campaigns
- Archives campaigns in Yandex Direct
- unarchive_campaigns
- Unarchives campaigns in Yandex Direct
- suspend_campaigns
- Suspends campaigns in Yandex Direct
- resume_campaigns
- Resumes campaigns in Yandex Direct
- get_adgroups
- Reads adgroups in Yandex Direct
- add_adgroups
- Creates adgroups in Yandex Direct
- update_adgroups
- Updates adgroups in Yandex Direct
- delete_adgroups
- Deletes adgroups in Yandex Direct
- archive_adgroups
- Archives adgroups in Yandex Direct
- unarchive_adgroups
- Unarchives adgroups in Yandex Direct
- get_ads
- Reads ads in Yandex Direct
- add_ads
- Creates ads in Yandex Direct
- update_ads
- Updates ads in Yandex Direct
- delete_ads
- Deletes ads in Yandex Direct
- archive_ads
- Archives ads in Yandex Direct
- unarchive_ads
- Unarchives ads in Yandex Direct
- moderate_ads
- Sends for moderation ads in Yandex Direct
- get_keywords
- Reads keywords in Yandex Direct
- add_keywords
- Creates keywords in Yandex Direct
- update_keywords
- Updates keywords in Yandex Direct
- delete_keywords
- Deletes keywords in Yandex Direct
- suspend_keywords
- Suspends keywords in Yandex Direct
- resume_keywords
- Resumes keywords in Yandex Direct
- get_keyword_bids
- Reads keyword bids in Yandex Direct
- set_keyword_bids
- Sets keyword bids in Yandex Direct
- set_auto_keyword_bids
- Sets auto keyword bids in Yandex Direct
- get_bid_modifiers
- Reads bid modifiers in Yandex Direct
- add_bid_modifiers
- Creates bid modifiers in Yandex Direct
- set_bid_modifiers
- Sets bid modifiers in Yandex Direct
- delete_bid_modifiers
- Deletes bid modifiers in Yandex Direct
- get_sitelinks
- Reads sitelinks in Yandex Direct
- add_sitelinks
- Creates sitelinks in Yandex Direct
- delete_sitelinks
- Deletes sitelinks in Yandex Direct
- get_vcards
- Reads vcards in Yandex Direct
- add_vcards
- Creates vcards in Yandex Direct
- delete_vcards
- Deletes vcards in Yandex Direct
- create_report
- Creates report in Yandex Direct
- get_dictionaries
- Reads dictionaries in Yandex Direct
- get_clients
- Reads clients in Yandex Direct
What it does
- 43 Direct API tools
- Covers campaigns, ad groups, ads, keywords, bids, modifiers, sitelinks, vCards and reports.
- Confirm guard
- Fourteen irreversible tools need `confirm: true` or they send nothing.
- Sandbox mode
- `YANDEX_DIRECT_SANDBOX=true` routes calls to the Direct sandbox.
- Agency support
- `YANDEX_DIRECT_CLIENT_LOGIN` lets agency accounts act for a client.
- Destructive hints
- The guarded tools carry `destructiveHint` annotations so clients can warn before the call.
- Reporting
- `create_report` and `get_dictionaries` pull performance data and reference lists.
Good for
- Pause or resume keywords across campaigns from a chat
- Adjust keyword bids in bulk with a confirmation step
- Add sitelinks and vCards to ads
- Pull a Direct report for a campaign
- Rehearse an ad workflow in the sandbox before touching production
Pricing
Open source
MIT licensed
Yandex Direct MCP FAQ
Can it change live ads?
Yes. It has write access to live campaigns, ads and bids and no dry-run mode, so the README recommends the sandbox first.
What is the confirm flag?
Fourteen irreversible tools refuse unless called with a literal `confirm: true`; strings like "yes" or 1 are refused.
How do I install it?
The README says nothing is published on the npm scope yet, so clone the repo, run `bun install` and start `src/index.mjs` with Node.
What credentials does it need?
`YANDEX_DIRECT_TOKEN`, an OAuth token for Direct API v5; `YANDEX_DIRECT_CLIENT_LOGIN` is only for agency accounts.
Are there known limits?
It uses the `/json/v5` path only, and the Units quota header is not shown to the client.
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 yandex-direct-mcp --env YANDEX_DIRECT_TOKEN='<YANDEX_DIRECT_TOKEN>' -- npx -y @stufently/yandex-direct-mcp
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.
