SkillFoxx

yandex-direct-mcp

A Python SDK and MCP server for the Yandex Direct API v5: campaigns, keywords and reports for an agent

  • 0 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • Can suspend, resume, archive and delete ad campaigns
  • Can change bids and add keywords, which directly affects budget spend
  • Without the sandbox variable it acts on the live ad account
All reasons and checks
Russian stack

ovelichko16-ux/yandex-direct-mcpAuthor:ovelichko16-ux

A similar tool with a larger community: Yandex Direct MCP server in Ruby, 6 ★ on the repository

Install

Manual install

poetry install

Install project dependencies.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • Can suspend, resume, archive and delete ad campaigns
  • Can change bids and add keywords, which directly affects budget spend
  • Without the sandbox variable it acts on the live ad account

This is third-party code. Review the repository files before installing.

What it does

The project ships a typed, async Python SDK for the Yandex Direct API v5 and an MCP server on top of it. The server exposes tools to list, suspend, resume, archive and delete campaigns, add keywords and change bids, and to request performance reports and poll until they are ready. The author states the project is early: transport, auth and the campaign/keyword/report services are tested, while campaign creation and type-specific updates are not implemented yet.

Who it is for. For PPC specialists who want to manage Yandex Direct campaigns through an agent.

Good fit when

  • You need to quickly pause or resume ad delivery for a list of campaigns
  • You need to add keywords or change a bid without opening the Direct interface
  • You need a campaign performance report inside a conversation with an agent

Not a fit when

  • You need to create new campaigns or change type-specific settings: the server does not support this yet
  • You need a stable, well-tested project: the author labels it early development

Example request

Pause the campaigns with zero conversions over the last week

MCP

Transport
stdio
Authentication
API key

Environment variables

YANDEX_DIRECT_ACCESS_TOKEN required, secret
OAuth token for the Yandex Direct application
YANDEX_DIRECT_CLIENT_LOGIN
Client login to act on behalf of an agency
YANDEX_DIRECT_USE_OPERATOR_UNITS
Bills points to the operator account instead of the client
YANDEX_DIRECT_LANGUAGE
Error message language: ru, en or uk
YANDEX_DIRECT_SANDBOX
Routes requests to the API sandbox instead of the live account

Limitations

The author warns the project is in early development. Campaign creation and type-specific updates are not implemented. Installation is via poetry; there is no packaged npm or PyPI release. A Yandex Direct OAuth token is required, and without sandbox mode the tools act on the live account immediately.

How to disable. Remove the server from your MCP client config and revoke the Yandex Direct OAuth token in the developer console.

FAQ

Can it create new campaigns?

No, the author states that campaign creation and type-specific updates are not implemented yet.

Is there protection against accidental spending?

Yes, the YANDEX_DIRECT_SANDBOX variable targets the API sandbox instead of the live account.

Discussion

No questions or reviews yet.

All Yandex Direct tools
Russian stack

A dependency-free, pure Ruby MCP server with 30 tools for Yandex Direct campaigns, ad groups, ads, keywords and reports

MCP serverBroad access6
Russian stack

A Python MCP server with 48 Yandex Direct tools and Wordstat frequency lookup, switchable between sandbox and production

MCP serverBroad access1

Yandex Direct MCP server (npm)

@theyahia/yandex-direct-mcp

Russian stack

A TypeScript MCP server with an npm package: 20 tools for Yandex Direct campaigns, bids and negative keywords, with money always in rubles

MCP serverBroad access4
Russian stack

20 Yandex Direct tools where every edit shows the plan by default and needs confirm=True to actually send anything

MCP serverBroad access

Yandex Direct MCP

yandex-direct-mcp

Russian stack

A Claude Code and Codex plugin for Yandex Direct: a 147-tool MCP server, OAuth, and skills for ad copy and stats analysis

PluginBroad access14
Russian stack

A single-file, dependency-free Node.js Direct API v5 MCP server with a universal direct_call tool and a read-only mode

MCP serverBroad access

Comparison with similar tools

Cards that share the main search query, and how they differ.

ToolOfficialAuthenticationRepository starsMain difference
yandex-direct-mcp (this card)noAPI key0
Yandex Direct MCP, CLI and models with action searchnoAPI key179 actions
Direct, Metrika, Wordstat and Webmaster MCP servernoAPI key0Metrika, Webmaster

README in short

The README states the project goals: a typed SDK and MCP server for the Direct API with clean architecture and full test coverage. It lists environment variables for the token, agency login, operator units, error language and sandbox mode. A table of 13 server tools is given along with a Claude Desktop config example. The development section shows lint, format, type-check and test commands. MIT license.

README badge

Report a problem