yandex-direct-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DIRECT_TOOLS | No | Явный список служб или инструментов, побеждает профиль. | |
| DIRECT_PROFILE | No | Профиль поверхности инструментов: core, read, or all. | core |
| DIRECT_SANDBOX | No | Установите '1', чтобы использовать песочницу вместо боевого кабинета. | 0 |
| DIRECT_API_VERSION | No | Версия API: v501 или v5 — меняет представление кампаний. | v501 |
| DIRECT_ALLOW_WRITES | No | Установите '1', чтобы объявить меняющие данные инструменты. | 0 |
| YANDEX_DIRECT_LOGIN | No | Логин кабинета (не почта). Переключает кабинет по-настоящему: под одним токеном отдаёт другой аккаунт со своей квотой. | |
| YANDEX_DIRECT_TOKEN | Yes | OAuth-токен Яндекса со scope direct:api. Обязательна. | |
| DIRECT_MAX_OUTPUT_CHARS | No | Потолок ответа; усечение называется вслух. | 60000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| direct_adgroups_getA | Возвращает параметры групп, отвечающих заданным критериям. Служба adgroups, метод get (чтение). Документация: https://yandex.ru/dev/direct/doc/ru/adgroups/get |
| direct_ads_getB | Служба ads, метод get (чтение). Документация: https://yandex.ru/dev/direct/doc/ru/ads/get |
| direct_bidmodifiers_getB | Возвращает параметры корректировок, отвечающих заданным критериям. Служба bidmodifiers, метод get (чтение). Документация: https://yandex.ru/dev/direct/doc/ru/bidmodifiers/get |
| direct_campaigns_getB | Возвращает параметры кампаний, отвечающих заданным критериям. Служба campaigns, метод get (чтение). Документация: https://yandex.ru/dev/direct/doc/ru/campaigns/get |
| direct_clients_getA | Возвращает параметры рекламодателя и настройки пользователя — представителя рекламодателя либо параметры агентства и настройки пользователя — представителя агентства. Служба clients, метод get (чтение). Документация: https://yandex.ru/dev/direct/doc/ru/clients/get |
| direct_dictionaries_getB | Возвращает справочные данные: регионы, часовые пояса, курсы валют, список станций метрополитена, ограничения на значения параметров, внешние сети (SSP), сегменты Крипты для нацеливания по профилю пользователя и др. Служба dictionaries, метод get (чтение). Документация: https://yandex.ru/dev/direct/doc/ru/dictionaries/get |
| direct_keywordbids_getB | Возвращает ставки для ключевых фраз и автотаргетингов, отвечающих заданным критериям, а также данные торгов: ставки и списываемые цены для различных объемов трафика на поиске и ставки для охвата различных долей аудитории в сетях. Служба keywordbids, метод get (чтение). Документация: https://yandex.ru/dev/direct/doc/ru/keywordbids/get |
| direct_keywords_getB | Возвращает параметры ключевых фраз или автотаргетингов, отвечающих заданным критериям: значения подстановочных переменных, статус и состояние, статистику показов и кликов и ставки. Служба keywords, метод get (чтение). Документация: https://yandex.ru/dev/direct/doc/ru/keywords/get |
| direct_reports_getA | Статистика: показы, клики, расход, конверсии по кампаниям, группам, объявлениям и запросам. Это основной инструмент счёта. ВАЖНО о составе кабинета: список кампаний из campaigns.get неполон — кампании Мастера кампаний в него не попадают вовсе, без ошибки и без признака. Отчёт видит всё, что откручивалось, поэтому состав кабинета определяется отсюда, а не из списка кампаний. Суммы приходят в валюте счёта: сервер запрашивает их у API в рублях, а не в микро-единицах. Документация по полям: https://yandex.ru/dev/direct/doc/ru/reports/fields-list |
| direct_fieldsA | Перечисляет допустимые значения перечисления: колонки отчётов, наборы FieldNames, типы кампаний. Нужен потому, что полные списки в описания инструментов не помещаются. ВАЖНО: список порождён из схемы, а схема отстаёт от живого API — он принимает и то, чего здесь нет. Значение вне списка не считайте недопустимым: право решать за API. |
| direct_schemaA | Возвращает точный состав типа Директа — какие поля, какие обязательны, какие списки. Нужен перед созданием и изменением объектов: вложенные типы в схемы инструментов не разворачиваются, потому что один только CampaignAddItem это больше тысячи полей. |
| direct_inventoryA | Полный состав кабинета: кампании из списка И кампании из отчёта, склеенные в одну таблицу с пометкой источника у каждой строки. Зовите его вместо campaigns.get, когда нужен ответ на вопрос «что сейчас крутится». Метод campaigns.get не отдаёт кампании Мастера кампаний вовсе — ни списком, ни по явному Ids, и ответ при этом успешный и пустой, то есть отличить «нет такой» от «не показывается» нечем. При этом такая кампания может нести основную долю показов кабинета. Строки с пометкой «только отчёт» — это как раз они: кампания откручивается, но списком не отдаётся, и управлять ею через API нельзя. |
| direct_catalogA | Перечисляет ВСЕ методы API Директа и показывает, какие из них объявлены сейчас, а какие скрыты и как их включить. Зовите, когда нужного инструмента не видно среди доступных: скорее всего он существует, но не объявлен ради экономии контекста. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 13 tools
Each tool targets a specific Direct service (adgroups, ads, campaigns, etc.) with clear descriptions. The only potential overlap is campaigns_get vs direct_inventory, but inventory explicitly explains when to use it instead, so no confusion.
All tools share the direct_ prefix and snake_case. Most use the _get suffix for read operations, but inventory, fields, schema, and catalog deviate from this pattern. Still, the naming is consistent in style and readable.
13 tools is well within the optimal range. Each tool serves a distinct purpose, and the meta tools (schema, fields, catalog) add value without bloat.
The set covers read operations for all major entities and reports, plus meta tools for discovery. However, it lacks create/update/delete operations, making it incomplete for full lifecycle management. The catalog tool hints that other methods exist but are hidden, so the current surface is read-only.