yandex-direct-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| YANDEX_DIRECT_TOKEN | Yes | OAuth-токен Яндекс.Директ |
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 |
|---|---|
| list_campaignsA | Список рекламных кампаний Яндекс.Директ с фильтрацией по статусу и типу. Бюджеты — в рублях. |
| get_campaignA | Детальная информация о кампании по ID: бюджет (руб), статус, даты, статистика. |
| create_campaignA | Создать новую рекламную кампанию. Бюджет в рублях. ⚠️ Тратит реальные деньги — используйте sandbox для теста. |
| update_campaignA | Обновить кампанию: название, бюджет (руб) и/или статус (SUSPEND/RESUME/ARCHIVE/UNARCHIVE). |
| list_ad_groupsB | Группы объявлений выбранных кампаний: названия, регионы, статусы. |
| create_ad_groupB | Создать группу объявлений в кампании с таргетингом по регионам (см. get_regions). |
| delete_ad_groupsA | Удалить группы объявлений по их ID. ⚠️ Необратимо. |
| list_adsB | Объявления в группах: заголовки, тексты, ссылки, статусы. |
| create_text_adB | Создать текстовое объявление: заголовок (≤56), второй заголовок (≤30), текст (≤81), ссылка. |
| update_text_adA | Обновить текстовое объявление: заголовок, текст, ссылка. Изменённое объявление уходит на модерацию. |
| manage_adsA | Действие над объявлениями: suspend/resume/archive/unarchive/moderate/delete. ⚠️ delete необратимо. |
| list_keywordsB | Ключевые фразы в группах объявлений: фразы, ставки (руб), статусы. |
| add_keywordsB | Добавить ключевые фразы в группу объявлений. |
| set_keyword_bidsA | Установить ставки (поиск/сети, в рублях) на уровне фраз, групп или кампаний (сервис Bids). |
| manage_keywordsA | Действие над ключевыми фразами: suspend/resume/delete. ⚠️ delete необратимо. |
| set_campaign_negative_keywordsA | Задать минус-фразы на уровне кампании (заменяет текущий список; пустой массив очищает). |
| set_ad_group_negative_keywordsA | Задать минус-фразы на уровне группы объявлений (заменяет текущий список; пустой массив очищает). |
| get_statisticsA | Статистика кампаний за период: показы, клики, расход (руб), CTR, CPC (ReportService, TSV). |
| get_account_balanceB | Баланс и финансовая информация аккаунта (Amount, Currency) через Live API v4. |
| get_regionsA | Справочник кодов регионов (GeoRegions) для таргетинга. Фильтр по названию. 225 = Россия. |
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 20 tools
Each tool targets a distinct action and level (campaign, ad group, ad, keyword, etc.). There is no overlap in purpose; even similar tools like `add_keywords` and `set_keyword_bids` handle different aspects (adding phrases vs setting bids).
All tool names use a consistent verb_noun snake_case pattern (e.g., `create_campaign`, `list_ads`, `set_keyword_bids`). Verbs like create, get, list, update, delete, manage, set, add are used consistently across similar operations.
20 tools is appropriate for a Yandex Direct advertising platform. It covers account management, campaign/ad group/ad operations, keywords, negative keywords, bids, stats, and reference data without being excessive or too sparse.
Core workflows are covered, but notable gaps exist: no campaign delete, no update for ad groups, and no individual get tools for ad groups or keywords (only list). Missing management for ad types beyond text ads. These gaps may hinder some use cases.