yandex-direct-mcp server
MCP server for Yandex Direct — PPC campaigns, ads, keywords, statistics (Russia)
5 stars117 downloads/wk
Reviews
Write oneNobody has reviewed yandex-direct-mcp yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
yandex-direct-mcp tools (12, 4 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
add_keywordsДобавить ключевые фразы в группу объявлений.
create_ad_groupwrite actionСоздать группу объявлений в кампании с таргетингом по регионам.
create_campaignwrite actionСоздать новую рекламную кампанию в Яндекс.Директ.
create_text_adwrite actionСоздать текстовое объявление: заголовок, текст, ссылка.
get_account_balanceИнформация об аккаунте Яндекс.Директ и состоянии справочников.
get_campaignДетальная информация о кампании по ID: бюджет, статус, даты, статистика.
get_statisticsСтатистика кампаний за период: показы, клики, расход, CTR, CPC (ReportService).
list_ad_groupsГруппы объявлений выбранных кампаний: названия, регионы, статусы.
list_adsОбъявления в группах: заголовки, тексты, ссылки, статусы.
list_campaignsСписок рекламных кампаний Яндекс.Директ с фильтрацией по статусу и типу.
list_keywordsКлючевые слова в группах объявлений: фразы, ставки, статусы.
update_campaignwrite actionОбновить кампанию: название, бюджет, статус (SUSPEND/RESUME/ARCHIVE).
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan19 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 22 days ago15/15
- Maintainer identityregistry namespace matches repository owner6/10
Install yandex-direct-mcp in Claude Code, Cursor or VS Code
Runs npx -y @theyahia/yandex-direct-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add yandex-direct-mcp -- npx -y @theyahia/yandex-direct-mcp
What the publisher says
From the yandex-direct-mcp repository's README, as published. We do not edit it. Read it on GitHub
@theyahia/yandex-direct-mcp
MCP-сервер для API Яндекс.Директ — управление контекстной рекламой из любого MCP-клиента (Claude, Cursor и др.): кампании, группы, объявления, ключевые слова, ставки, минус-фразы, статистика, баланс. 20 инструментов.
Деньги — в рублях (бюджеты, ставки на вводе и выводе); сервер сам конвертирует в микроединицы API. Поддержаны песочница для безопасного теста и агентский режим (Client-Login).
Установка
Claude Desktop
{
"mcpServers": {
"yandex-direct": {
"command": "npx",
"args": ["-y", "@theyahia/yandex-direct-mcp"],
"env": {
"YANDEX_DIRECT_TOKEN": "ваш_токен"
}
}
}
}Claude Code
claude mcp add yandex-direct -e YANDEX_DIRECT_TOKEN=ваш_токен -- npx -y @theyahia/yandex-direct-mcpКонфигурация (переменные окружения)
Как получить токен
OAuth-токен выпускается для приложения, зарегистрированного в Яндекс OAuth, с доступом к API Директа. Подробности — регистрация приложения и получение токена. Доступ к API нужно запросить в интерфейсе Директа.
⚠️ Внимание: реальные траты
Инструменты createcampaign, createtextad, addkeywords, setkeywordbids и др. меняют боевой рекламный аккаунт и могут расходовать деньги. Для отладки сценариев включайте песочницу (YANDEXDIRECTSANDBOX=1).
Инструменты (20)
Кампании
Группы объявлений
Объявления
Ключевые слова и ставки
Статистика, аккаунт, справочники
Примеры запросов
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
yandex-direct-mcp: common questions
- Is yandex-direct-mcp server safe?
- Yes, by our scan: it is graded A (89/100). Read the yandex-direct-mcp safety report
- How do I install yandex-direct-mcp?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does yandex-direct-mcp need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is yandex-direct-mcp maintained?
- The last commit was 22 days ago (2026-09-06). The latest release is v3.0.2.
- What can I use instead of yandex-direct-mcp?
- Servers from other publishers that do the same job: NotFair-MetaAds MCP server.
Alternatives to yandex-direct-mcp
Same job from other publishers: the closest match first, then the best rated.
NotFair-MetaAdsMeta Ads MCP (Facebook + Instagram) - analyze performance, manage budgets, pause campaigns.not reviewedEstablishedA