Skip to content
MCP server

Yandex Direct MCP

MCP server that manages Yandex Direct campaigns, ads, keywords, bids and reports

Runs locallyStatus and history
Install
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-mcp

Add 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 v5Required
  • YANDEX_DIRECT_CLIENT_LOGINClient login, only for agency accounts
  • YANDEX_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.

How AIPoweredBot checks servers