Yandex Direct MCP server
MCP server for Yandex Direct API v5 — campaigns, ads, keywords, bids, audiences
1 stars24 downloads/wk
Reviews
Write oneNobody has reviewed Yandex Direct yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Yandex Direct tools (2, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
yd_executewrite actionВыполнить действие Yandex Direct API по ID.
yd_searchНайти действия Yandex Direct API по намерению. Вызывай первым.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan33 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 qualitystatic API keys via environment variables6/15
- Maintenancelast push 140 days ago8/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Yandex Direct compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 72/100
- higher than 38% of 48,255 servers
- Tools
- 2
- the typical server has 7
- Tools that change things
- 50%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 65% of 28,688 servers
- Downloads a week
- 24
- more than 10% of 12,191 servers with a package
What its tools let an agent do: 1 read · 1 change
Install Yandex Direct in Claude Code, Cursor or VS Code
claude mcp add yandex-direct -- uvx mcp-server-yandex-direct
What the publisher says
From the Yandex Direct repository's README, as published. We do not edit it. Read it on GitHub
<!-- mcp-name: io.github.dontsovcmc/yandex-direct -->
mcp-server-yandex-direct
MCP-сервер, CLI-утилита и библиотека Pydantic-моделей для Yandex Direct API v5.
- MCP-сервер — интеграция с Claude Code, Claude Desktop и другими MCP-клиентами
- CLI-утилита — работа с API из терминала, скрипты и автоматизация
- Pydantic-модели — типизированные модели API для использования в своих Python-программах
Все данные остаются на вашем компьютере — токен никуда не передаётся.
Оглавление
- Архитектура
- Доступные действия
- MCP-сервер
- Установка
- Подключение к Claude Code
- Подключение к Claude Desktop
- Подключение через --mcp-config
- Примеры
- CLI-утилита
- Установка
- Использование
- Примеры команд
Архитектура
Сервер использует паттерн search + execute — вместо 79 отдельных инструментов предоставляет 2:
Как это работает
LLM: yd_search("остановить кампании")
→ [{"id": "campaigns-suspend", "params_schema": {"SelectionCriteria": {...}, ...}, ...}]
LLM: yd_execute("campaigns-suspend", '{"SelectionCriteria": {"Ids": [12345]}}')
→ {"SuspendResults": [...]}Доступные действия (79)
MCP-сервер
Установка
Шаг 1. Получить OAuth-токен
- Войдите в Яндекс Директ
- Перейдите в Настройки → API
- Создайте OAuth-токен с нужными правами
- Скопируйте токен
Шаг 2. Подключить MCP-сервер
Подключение к Claude Code
Способ 1: через uvx (не требует установки пакета)
Требуется uv — если не установлен:
bash
curl -LsSf https://astral.sh/uv/install.sh | sh
claude mcp add yandex-direct \
-e YD_TOKEN=ваш_токен \
-- uvx mcp-server-yandex-directСпособ 2: через pip
pip install mcp-server-yandex-direct
claude mcp add yandex-direct \
-e YD_TOKEN=ваш_токен \
-- python -m mcp_server_yandex_directДля удаления:
claude mcp remove yandex-directShortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Yandex Direct: common questions
- Is Yandex Direct MCP server safe?
- Mostly: it is graded B (72/100). Read the Yandex Direct safety report
- How do I install Yandex Direct?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Yandex Direct need an API key?
- Yes. The registry entry asks for
YD_TOKEN. - Is Yandex Direct maintained?
- The last commit was 178 days ago (2026-05-10). The latest release is v0.3.0.
- How does Yandex Direct compare with other MCP servers?
- safety score 72/100 (higher than 38% of 48,255 servers); tools 2 (the typical server has 7); tools that change things 50% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.