Skip to main content
Glama
skiddgoddamn

yandex-marketing-mcp

by skiddgoddamn

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
YD_LOGINNoЛогин клиента по умолчанию (для агентских аккаунтов)
YD_CONFIRMNotrue — изменяющие вызовы сначала возвращают превью; для выполнения нужен confirm=true
YD_SANDBOXNotrue — тестовый режим Директа (sandbox)
YD_LOG_FILENoПуть к лог-файлу (пусто — только stderr, файл не создаётся)
YD_READONLYNotrue — блокирует все изменяющие инструменты; только чтение и отчёты
YC_FOLDER_IDNoID каталога Yandex Cloud для Wordstat (seed; сохраняется через yd_set_token)
YD_LOG_LEVELNoDEBUG / INFO / WARNING / ERROR (по умолчанию INFO)INFO
YD_LOG_BODIESNotrue — писать тела запросов и ответов в лог
YD_OAUTH_TOKENNoOAuth access_token (seed; сохраняется через yd_set_token)
YD_ALLOWED_LOGINSNoБелый список логинов клиентов через запятую (только для инструментов Директа)
YANDEX_OAUTH_CLIENT_IDNoClient ID OAuth-приложения (seed; сохраняется через yd_set_client_id)

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

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