Yandex Direct MCP plugin
yandex-direct-mcp
A Claude Code and Codex plugin for Yandex Direct: a 147-tool MCP server, OAuth, and skills for ad copy and stats analysis
- 14 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Changes bids, budgets and campaign states in an ad account
- Includes finance operations: top-ups, invoices and transfers between accounts
- Stores a Yandex OAuth token and a live session
Install
- Works in
- Services
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/yandex-direct-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Changes bids, budgets and campaign states in an ad account
- Includes finance operations: top-ups, invoices and transfers between accounts
- Stores a Yandex OAuth token and a live session
This is third-party code. Review the repository files before installing.
What it does
The plugin installs a local MCP server built on direct-cli that covers most of the Direct API: campaigns, ad groups, ads, keywords and negative keywords, bids and modifiers, strategies, retargeting, feeds, reports, Metrica goals, Wordstat and budget forecasts. Finance operations are included: balance, top-ups, invoices and transfers between accounts. Three skills help manage campaigns, write ads within character limits and run exploratory stats analysis. The tool set can be narrowed with a profile such as analytics only, and Campaign Masters are read through a Playwright-driven browser.
Who it is for. For PPC specialists and business owners who run Yandex Direct campaigns.
Good fit when
- You need campaign stats and to find expensive ads
- You need to change bids or pause weak ads by a rule
- You need ad variants within Direct character limits
- You need a breakdown by device, region and search query
Not a fit when
- A high-budget account where every change needs sign-off
- You only need stats and do not want to grant write access
Example request
Show campaigns for the last week and find ads where a lead costs more than 1500 rublesLimitations
Before first login you must create a Yandex OAuth app with direct:api access and get your API application approved in Direct, otherwise requests return incomplete_registration. Python 3.11 is required. Campaign Masters need Playwright, Chromium and a manual terminal login. Unofficial plugin.
How to disable. Uninstall the yandex-direct plugin via /plugin. Saved auth lives in ~/.direct-cli/, and the Masters profile is removed with direct masters logout.
FAQ
How do I limit the agent to reading stats?
Set YANDEX_DIRECT_TOOL_PROFILE=analytics or disable groups via YANDEX_DIRECT_DISABLED_GROUPS.
Why do requests return incomplete_registration?
Your API access application for the app's Client ID has not been approved in the Direct interface.
Does it work with Codex?
Yes, the repo has a marketplace manifest at .agents/plugins/marketplace.json and a Codex plugin bundle.
Discussion
No questions or reviews yet.
Related
All Yandex Direct toolsFive MCP servers for Yandex Search, Wordstat, Webmaster, Metrika and Direct, bundled as a Claude Code plugin with two skills
An MCP server for Yandex Direct, Metrika, Wordstat and Webmaster: campaigns, ads, bids, reports and keyword research from chat
Yandex Direct MCP: hardened fork
yandex-direct-mcp
A fork of a popular Yandex Direct MCP server that defaults to read-only, with explicit flags for writes and finance
A Codex and Claude Code plugin with skills and MCP for Yandex Direct, Metrika, Wordstat v2, Roistat, amoCRM and Yandex Search API
An MCP server for Yandex Direct, Metrica, Audiences and Wordstat with read-only mode and change confirmation
Yandex Direct MCP server (npm)
@theyahia/yandex-direct-mcp
A TypeScript MCP server with an npm package: 20 tools for Yandex Direct campaigns, bids and negative keywords, with money always in rubles
README in short
The Russian README starts with plugin marketplace install and Yandex login. It lists capability groups, sample prompts and ways to connect Claude Code, Codex and other MCP clients. It details creating the OAuth app and API application, profiles that limit tools, and separate browser auth for Campaign Masters. It ends with a skills table and development commands. MIT licensed.
README badge
Original SKILL.md
--- name: direct-ads description: "Написание рекламных объявлений для Яндекс.Директ. Используется когда пользователь просит написать, улучшить или проверить текст объявления, заголовки, или тексты для контекстной рекламы." user-invocable: true argument-hint: "[тема или описание рекламируемого продукта/услуги]" --- # Написание объявлений Яндекс.Директ Скилл для создания эффективных рекламных объявлений в Яндекс.Директ. ## Лимиты символов | Элемент | Максимум символов | |---|---| | Title (Заголовок) | 35 | | Title2 (Второй заголовок) | 30 | | Text (Текст объявления) | 81 | ## Правила написания ### Заголовок (Title) - Начинайте с главного предложения или УТП - Используйте цифры и конкретику: "Скидка 30%", "Доставка за 30 мин" - Включите гео если релевантно: "Пицца Москва" ### Второй заголовок (Title2) - Дополняйте первый заголовок - Добавьте призыв к действию: "Закажите сейчас" - Укажите дополнительные преимущества ### Текст объявления - Подробности о предложении - Условия доставки/оплаты - Гарантии и преимущества - Не повторяйте то, что уже в заголовках