Log inSubmit server
Yandex Direct MCP logo

Yandex Direct MCP

Manage Yandex.Direct campaigns, ads, keywords, bids, negative phrases, statistics, and account balance through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Yandex Direct MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "yandex-direct-mcp-2": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/yandex-direct-mcp"
      ],
      "env": {
        "YANDEX_DIRECT_TOKEN": "YOUR_VALUE_HERE",
        "YANDEX_DIRECT_SANDBOX": "YOUR_VALUE_HERE",
        "YANDEX_DIRECT_LOGIN": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 20 tools correctly (10d ago).

Overview

The yandex-direct-mcp MCP server connects MCP clients to the Yandex.Direct API for managing advertising accounts. It provides 20 tools covering campaigns, ad groups, text ads, keywords, bids, negative phrases, statistics, balance, and region lookups. Configuration uses a Yandex OAuth token, with optional sandbox and agent-token settings. Reach for it when an agent needs to inspect or change Yandex.Direct advertising data, especially when testing workflows in the sandbox first.

Use cases

  • List active Yandex.Direct campaigns
  • Create campaigns with daily ruble budgets
  • Adjust keyword bids across campaigns
  • Add campaign and group negative phrases
  • Review weekly advertising statistics

Key features

  • 20 Yandex.Direct management tools
  • Campaign and ad group lifecycle controls
  • Keyword, bid, and negative phrase management
  • Statistics and account balance retrieval
  • Sandbox support for testing
  • Ruble-based budget and bid handling

Tools20

What Yandex Direct MCP lets your agent do. Expand a tool for its parameters.

Verified live~2.8k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

8/8 checks healthy over the last 50d

What it can do

From the 20 tools this server returned when we ran it; 20 declare their own safety hints.

Can delete or modify data · 3Makes network requests · 20Read-only tools · 17
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age202 days
Maintainers1

Observed 2026-10-18 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 13d ago via OSV.dev · @theyahia/yandex-direct-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars4Stargazers on the source repository.
npm downloads324Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed20Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Yandex Direct MCP works

What yandex-direct-mcp MCP server does

yandex-direct-mcp MCP server exposes Yandex.Direct advertising operations through the Model Context Protocol. It supports campaign management, ad group organization, text ad editing, keyword maintenance, bid changes, negative phrases, reporting, account balance checks, and regional reference data.

The server includes 20 tools. Campaign tools can list, inspect, create, and update campaigns, including budget, strategy, name, and lifecycle status. Ad group tools cover listing, creation with regional targeting, deletion, and group-level negative phrases. Ad tools list ads, create and update text ads, and apply actions such as suspend, resume, archive, unarchive, moderate, or delete.

Keyword tools list and add phrases, set search and network bids, change keyword status, remove keywords, and assign campaign-level negative phrases. Reporting returns impressions, clicks, spend, CTR, and CPC for a selected period. Other tools return the account balance through Live API v4 and look up region codes.

How it works

An MCP client starts the server and invokes its tools against Yandex.Direct. Requests use a bearer OAuth token supplied through the environment. Amounts entered for budgets and bids use rubles; the server converts those values to the API's micro-units and converts returned monetary values back to rubles.

The available operations include both read-only queries and mutations. Listing and reporting calls can inspect existing account data, while campaign creation, ad creation, keyword additions, bid changes, and status actions can alter the account. The README specifically warns that several mutation tools may spend real money when used against a production account.

Setup and configuration

Install and run the package with npx -y @theyahia/yandex-direct-mcp. For Claude Desktop, add a server entry whose command is npx, whose argument is -y @theyahia/yandex-direct-mcp, and whose environment contains YANDEX_DIRECT_TOKEN. Claude Code can register the same command with claude mcp add.

The required YANDEX_DIRECT_TOKEN must be an OAuth token issued for an application registered with Yandex OAuth and authorized for the Direct API. API access also needs to be requested in the Yandex.Direct interface. Set YANDEX_DIRECT_SANDBOX=1 to use isolated sandbox data without spending money. Set YANDEX_DIRECT_LOGIN when using an agent token that requires the Client-Login header.

Tools and capabilities

The yandex-direct-mcp MCP server provides these capability groups:

  • Campaign listing, inspection, creation, budget and status updates
  • Ad group creation, deletion, regional targeting, and negative phrases
  • Text ad creation and updates, plus moderation and lifecycle actions
  • Keyword addition, status management, negative phrases, and bids
  • Period-based performance statistics and account balance retrieval
  • Region code lookup for geographic targeting

Limitations and notes

Production mutations can change a live advertising account and may incur charges. Use the sandbox while developing or testing agent workflows. The sandbox uses isolated data and a different API URL, but the same token setting is used.

Text ad creation accepts limits of 56, 30, and 81 characters for its respective text fields, as specified by the project. Bid and budget inputs are expressed in rubles rather than the API's underlying micro-units. Agent-token users must provide the client login in addition to the bearer token.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Yandex Direct MCP

yandex-direct-mcp is an MCP server that connects AI clients to the Yandex.Direct API. Its 20 tools manage campaigns, ad groups, text ads, keywords, bids, negative phrases, statistics, account balance, and region codes. It authenticates with a Yandex OAuth bearer token and supports sandbox access.

Install it by running `npx -y @theyahia/yandex-direct-mcp` through your MCP client. Claude Desktop uses an `mcpServers` entry with `YANDEX_DIRECT_TOKEN`; Claude Code can use `claude mcp add` with the same package command and environment variable.

Yes, yandex-direct-mcp works with Cursor because the README identifies Cursor as a supported MCP client. Configure the client to start the package with `npx` and provide the required `YANDEX_DIRECT_TOKEN` environment variable.

Set `YANDEX_DIRECT_SANDBOX=1` to use Yandex.Direct's sandbox. The sandbox uses isolated data and does not spend money, making it suitable for debugging agent workflows before running mutation tools against a production advertising account.

Related MCP servers

All in Marketing All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewYandex Direct MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/yandex-direct-mcp-2?style=directory)](https://allmcps.com/mcp/yandex-direct-mcp-2)
HTML Embed
<a href="https://allmcps.com/mcp/yandex-direct-mcp-2"><img src="https://allmcps.com/api/badge/yandex-direct-mcp-2?style=directory" alt="Yandex Direct MCP on AllMCPs" /></a>