Yandex Direct MCP server

Read from the package source without running it. The installed server may list more.

• ad_action

  Performs a lifecycle action on ads by id: moderate, suspend, resume, archive, unarchive or delete.

• add_bid_modifier

  Adds a bid adjustment to a campaign or ad group. BidModifier values are percentages per the API (e.g. 0–1300), not money.

• add_calloutswrite action

  Creates callouts (уточнения), up to 25 characters each. Callouts are immutable — delete and recreate to change. Assign to ads via the Ads service.

• add_keywords

  Adds keywords to an ad group, with optional search and network bids.

• campaign_action

  Performs a lifecycle action on campaigns by id: suspend, resume, archive, unarchive or delete.

• create_ad_groupwrite action

  Creates an ad group inside a campaign with a target geo.

• create_sitelinks_setwrite action

  Creates a sitelink set (1–8 links). Sets are immutable — to change links, create a new set and reassign it to the ad.

• create_text_adwrite action

  Creates a text ad (TextAd) inside an ad group. New ads start as drafts.

• create_text_campaignwrite action

  Creates a TextCampaign (Text & Image ads). Without biddingStrategy it defaults to manual search bids with the network off (Search HIGHEST_POSITION, Network SERVING_OFF); pass a full biddingStrategy {Search, Network} to use an auto-strategy or enable the network.

• create_vcardwrite action

  Creates a virtual business card in a campaign. vCards are immutable — delete and recreate to change.

• delete_bid_modifierswrite action

  Deletes bid modifiers by id (bidmodifiers/delete).

• delete_calloutswrite action

  Deletes callouts by id (adextensions/delete).

• delete_sitelinkswrite action

  Deletes sitelink sets by id (only sets not assigned to any ad can be deleted).

• delete_vcardswrite action

  Deletes vCards by id (vcards/delete).

• get_account_info

  Returns information about the current advertiser account (login, currency, type, country) using the Yandex Direct `clients` service.

• get_ad_images

  Lists images in the ad image library, keyed by image hash. Upload new images with upload_ad_image.

• get_ad_videos

  Reads videos from the ad video library by id (the API requires ids). Uploads go via raw_request (advideos/add).

• get_bid_modifiers

  Reads bid adjustments (mobile, desktop, demographics, retargeting, regional, video) for campaigns or ad groups. BidModifier is a percentage, not money.

• get_callouts

  Lists callouts (уточнения) from the adextensions library. Attach a callout to an ad via the Ads service.

• get_creatives

  Lists creatives (smart banners, HTML5) from the creative library.

• get_dictionaries

  Returns Yandex Direct reference dictionaries (currencies, time zones, constants, ad categories, ...). GeoRegions can be very large — prefer get_regions for region lookups.

• get_quota

  Returns today's API points quota (spent / rest / limit) from the Units header, so you can avoid hitting the daily limit.

• get_regions

  Looks up geo region ids for targeting (the regionIds that create_ad_group needs). Filter by a name substring; results are capped by limit.

• get_sitelinks

  Reads sitelink sets (быстрые ссылки) by id. The API requires set ids — get them from ads' SitelinkSetId.

• get_statistics

  Requests a performance report via the Yandex Direct Reports service. By default the report is AGGREGATED over the whole period (one row per object) — add "Date" to fieldNames only for day-by-day dynamics or trend questions. ALL_TIME without a campaign filter is rejected for SEARCH_QUERY/CRITERIA reports; pass campaignIds or a bounded date range. SEARCH_QUERY_PERFORMANCE_REPORT returns a COMPUTED S

• get_vcards

  Reads virtual business cards (визитки) by id. The API requires ids — get them from ads' VCardId.

• keyword_action

  Performs a lifecycle action on keywords by id: suspend, resume or delete.

• list_ad_groups

  Lists ad groups. Provide campaignIds and/or ids — the Yandex Direct API requires at least one selection criterion.

• list_ads

  Lists ads with optional filtering by campaign, ad group, id, state and status.

• list_campaigns

  Lists campaigns with optional filtering by id, type, state and status. Monetary fields (e.g. DailyBudget.Amount) are returned in account currency units.

• list_keywords

  Lists keywords filtered by campaign, ad group or id. Bid and ContextBid are returned in account currency units.

• raw_request

  Escape hatch to call any Yandex Direct API v5 service/method directly (e.g. service "bidmodifiers", method "get"). Use this for services that have no dedicated tool. Money is in micros (no conversion). Read methods (get/has/check) run freely; any other method is a write and requires confirmWrite=true.

• set_bid_modifiers

  Changes the percent of existing bid modifiers and/or enables/disables them (bidmodifiers/set), by modifier id.

• set_keyword_bids

  Sets manual search/network bids on keywords, or on all keywords in given ad groups or campaigns (keywordbids/set). Bids are in account currency units.

• update_ad_groupwrite action

  Updates an ad group's name and/or target regions (adgroups/update).

• update_campaignwrite action

  Updates a campaign's name, end date and/or daily budget (campaigns/update).

• update_text_adwrite action

  Updates a text ad's title, text or landing page (ads/update). Editing an active ad sends it back to moderation.

• upload_ad_imagewrite action

  Uploads an image to the ad image library (adimages/add) and returns its AdImageHash — use that hash as AdImageHash on a text & image ad. Provide the image as a public URL (fetched and encoded server-side) or as base64 in imageData. Yandex accepts JPG/PNG/GIF up to 10 MB; a text & image ad needs a landscape image (min 1080×607).

• Code scan39 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 36 days ago12/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10

Safety score

80/100

higher than 60% of 48,255 servers

Tools

38

the typical server has 7

Tools that change things

37%

typical: 0%. Fewer write tools means less an agent can break

GitHub stars

1

more than 65% of 28,688 servers

Downloads a week

130

more than 68% of 12,191 servers with a package

Yandex Direct: common questions

Is Yandex Direct MCP server safe?

Mostly: it is graded B (80/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 YANDEX_DIRECT_TOKEN.

Is Yandex Direct maintained?

The last commit was 75 days ago (2026-08-21). The latest release is v1.0.5.

How does Yandex Direct compare with other MCP servers?

safety score 80/100 (higher than 60% of 48,255 servers); tools 38 (the typical server has 7); tools that change things 37% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.