yandex-marketing-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| YD_LOGIN | No | Логин клиента по умолчанию (для агентских аккаунтов) | |
| YD_CONFIRM | No | true — изменяющие вызовы сначала возвращают превью; для выполнения нужен confirm=true | |
| YD_SANDBOX | No | true — тестовый режим Директа (sandbox) | |
| YD_LOG_FILE | No | Путь к лог-файлу (пусто — только stderr, файл не создаётся) | |
| YD_READONLY | No | true — блокирует все изменяющие инструменты; только чтение и отчёты | |
| YC_FOLDER_ID | No | ID каталога Yandex Cloud для Wordstat (seed; сохраняется через yd_set_token) | |
| YD_LOG_LEVEL | No | DEBUG / INFO / WARNING / ERROR (по умолчанию INFO) | INFO |
| YD_LOG_BODIES | No | true — писать тела запросов и ответов в лог | |
| YD_OAUTH_TOKEN | No | OAuth access_token (seed; сохраняется через yd_set_token) | |
| YD_ALLOWED_LOGINS | No | Белый список логинов клиентов через запятую (только для инструментов Директа) | |
| YANDEX_OAUTH_CLIENT_ID | No | Client ID OAuth-приложения (seed; сохраняется через yd_set_client_id) |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| yd_auth_statusA | Show Yandex auth status: whether client_id, OAuth token, and Wordstat folder_id are configured. |
| yd_set_client_idA | Save the Yandex OAuth application client_id and return the authorization link. Register an app at https://oauth.yandex.ru/client/new with scopes direct:api, metrika:read, metrika:write, cloud:auth and redirect 'Подставить URL для разработки'. |
| yd_set_tokenA | Save the Yandex OAuth access_token (obtained via the authorize link). Validated against the Metrika API before saving. Optionally set yc_folder_id for Wordstat. |
| yd_metrika_counters_getA | List all Metrika counters. Optional search and favorite filter. |
| yd_metrika_counter_getB | Get counter details by ID. |
| yd_metrika_counter_createB | Create a new Metrika counter. |
| yd_metrika_counter_updateB | Update a Metrika counter. |
| yd_metrika_counter_deleteC | Delete a Metrika counter. |
| yd_metrika_goals_getC | List goals for a counter. |
| yd_metrika_goal_createC | Create a goal for a counter. |
| yd_metrika_goal_updateC | Update a goal. |
| yd_metrika_goal_deleteC | Delete a goal. |
| yd_metrika_segments_getB | List segments for a counter. |
| yd_metrika_segment_createC | Create a segment. |
| yd_metrika_segment_updateC | Update a segment. |
| yd_metrika_segment_deleteC | Delete a segment. |
| yd_metrika_filters_getB | List filters for a counter. |
| yd_metrika_filter_createC | Create a filter for a counter. |
| yd_metrika_filter_updateC | Update a filter. |
| yd_metrika_filter_deleteB | Delete a filter. |
| yd_metrika_grants_getB | List access grants for a counter. |
| yd_metrika_grant_addB | Add access grant to a counter. |
| yd_metrika_grant_updateC | Update access grant. |
| yd_metrika_grant_deleteC | Delete access grant. |
| yd_metrika_reportC | Get a Metrika report (table). |
| yd_metrika_report_by_timeC | Get a Metrika report grouped by time. |
| yd_metrika_report_comparisonB | Get a Metrika comparison report (A vs B periods). |
| yd_metrika_report_drilldownD | Get a Metrika drilldown report. |
| yd_metrika_upload_conversionsC | Upload offline conversions. |
| yd_metrika_conversions_statusC | Get offline conversions upload status. |
| yd_metrika_upload_callsC | Upload offline calls. |
| yd_metrika_upload_expensesC | Upload advertising expenses. |
| yd_metrika_upload_user_paramsC | Upload user parameters. |
| yd_metrika_labels_getB | List all labels. |
| yd_metrika_label_createC | Create a label. |
| yd_metrika_label_updateC | Update a label. |
| yd_metrika_label_deleteB | Delete a label. |
| yd_metrika_label_linkB | Link a counter to a label. |
| yd_metrika_label_unlinkB | Unlink a counter from a label. |
| yd_metrika_annotations_getC | List chart annotations for a counter. |
| yd_metrika_annotation_createC | Create a chart annotation. |
| yd_metrika_annotation_updateC | Update a chart annotation. |
| yd_metrika_annotation_deleteB | Delete a chart annotation. |
| yd_metrika_delegates_getA | List all delegates. |
| yd_metrika_delegate_addB | Add a delegate. |
| yd_metrika_delegate_deleteC | Delete a delegate. |
| yd_campaigns_getC | Get list of campaigns. Filters: types, states, statuses, ids. |
| yd_campaigns_addB | Create a new text campaign. Supports all strategies: PAY_FOR_CONVERSION, WB_MAXIMUM_CLICKS, WB_MAXIMUM_CONVERSION_RATE, AVERAGE_CPA, SERVING_OFF, etc. |
| yd_campaigns_updateB | Update campaign settings (name, budget, strategy, status, etc.). |
| yd_campaigns_actionC | Suspend, resume, archive, or unarchive campaigns. |
| yd_adgroups_addC | Create ad groups in a campaign. |
| yd_adgroups_getB | Get ad groups by campaign or group IDs. |
| yd_ads_addA | Create text ads in ad groups. Supports bulk creation, sitelinks, and images. |
| yd_ads_updateC | Update existing text ads. Can change title, text, href, sitelinks, image, etc. |
| yd_ads_getB | Get ads by campaign, ad group, or ad IDs. |
| yd_ads_actionB | Moderate, suspend, resume, archive, or unarchive ads. |
| yd_keywords_addC | Add keywords to ad groups. |
| yd_keywords_getC | Get keywords by campaign, ad group, or keyword IDs. |
| yd_keywords_researchA | Deduplicate keywords: merge duplicates, eliminate overlapping phrases. Preprocesses keywords before adding to campaigns. |
| yd_bids_setC | Set bids for keywords. |
| yd_reportC | Get campaign statistics report. Returns TSV data. |
| yd_dictionariesB | Get reference data: regions, currencies, ad categories, etc. |
| yd_keywords_has_volumeA | Check if keywords have search volume (impressions) in specified regions. Returns YES/NO per device type. Max 10000 keywords, max 20 requests per 60 seconds. |
| yd_keyword_bids_getC | Get keyword bids and traffic forecasts. |
| yd_keyword_bids_setC | Set keyword bids (search and network). |
| yd_keyword_bids_set_autoC | Set automatic bidding for keywords based on target position or other criteria. |
| yd_bid_modifiers_addB | Add bid modifiers (adjustments) for demographics, devices, regions, etc. |
| yd_bid_modifiers_getC | Get bid modifiers for campaigns or ad groups. |
| yd_bid_modifiers_setB | Update existing bid modifiers by their IDs. |
| yd_bid_modifiers_deleteB | Delete bid modifiers by IDs. |
| yd_negative_keywords_sets_addA | Create shared negative keyword sets (max 30 total, reusable across campaigns). |
| yd_negative_keywords_sets_getB | Get shared negative keyword sets. |
| yd_negative_keywords_sets_updateB | Update a shared negative keyword set. |
| yd_negative_keywords_sets_deleteC | Delete shared negative keyword sets. |
| yd_sitelinks_addA | Create sitelink sets (quick links under ads, 1-8 per set). |
| yd_sitelinks_getB | Get sitelink sets by IDs. |
| yd_sitelinks_deleteC | Delete sitelink sets. |
| yd_ad_extensions_addB | Create ad extensions (callouts — short texts shown under ads, max 25 chars each). |
| yd_ad_extensions_getC | Get ad extensions by IDs. |
| yd_ad_extensions_deleteC | Delete ad extensions. |
| yd_changes_checkB | Check what changed since a given timestamp (campaigns, ad groups, ads, stats). |
| yd_audience_targets_addC | Add audience targeting conditions to ad groups (retargeting lists or interests). |
| yd_audience_targets_getB | Get audience targets by campaign, ad group, or target IDs. |
| yd_audience_targets_deleteC | Delete audience targeting conditions. |
| yd_retargeting_lists_addC | Create retargeting/audience conditions based on Yandex Metrika goals or audience segments. |
| yd_retargeting_lists_getC | Get retargeting lists. |
| yd_retargeting_lists_deleteC | Delete retargeting lists. |
| yd_ad_images_addC | Upload ad images (base64-encoded). Max 100 per request (recommended <=3). |
| yd_ad_images_getB | Get ad images by IDs or linked entities. |
| yd_ad_images_deleteB | Delete ad images by hashes. |
| yd_businesses_getB | Get organization profiles from Yandex Business linked to ads. |
| yd_clients_getA | Get advertiser account info (settings, balance, bonuses, etc.). |
| yd_vcards_addC | Add a VCard (business card) to a campaign. |
| yd_vcards_getC | Get VCards. Optionally filter by IDs. |
| yd_vcards_deleteB | Delete VCards by IDs. |
| yd_feeds_addB | Add a feed for dynamic/smart/shopping ads. |
| yd_feeds_getB | Get feeds. Optionally filter by IDs. |
| yd_feeds_updateC | Update a feed (name, URL, auth). |
| yd_feeds_deleteC | Delete feeds by IDs. |
| yd_smart_targets_addC | Add a smart ad target (filter) to an ad group. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/skiddgoddamn/yandex-marketing-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server