Format API errors into actionable messages.

Make a request to Yandex Direct API.

Make a request to Yandex Metrika API.

Make a request to Yandex Webmaster API v4. ``endpoint`` is the path after the API version, e.g. ``/user/{user_id}/hosts/``. List valu

Resolve the Webmaster UserID of the token owner.

Make a request to Wordstat via Yandex Cloud Search API v2. ``endpoint`` is the path after ``/v2/wordstat``, e.g. ``/topRequests``. Au

Map v1 device names to v2 enum values (v2 names pass through).

Map v1 period name to the v2 enum value (v2 names pass through).

Map v1 region_type to the v2 enum value (v2 names pass through).

Register a single MCP manage-operation tool (suspend/resume/archive/unarchive/delete). This factory replaces ~25 lines of boilerplate per action

v2 {results, associations, totalCount} -> v1 topRequests shape.

v2 expects google.protobuf.Timestamp (RFC3339), not bare YYYY-MM-DD.

v2 {results: [{date, count, share}]} -> v1 {dynamics: [...]}.

v2 {results: [{region, ...}]} -> v1 {regions: [{regionId, ...}]}.

Get token for Direct API.

Get Direct API URL based on configuration.

Get token for Metrika API.

Get token for Webmaster API.

Get the Yandex Cloud Api-Key for the Wordstat (Search API v2).

Build a human-readable response string for a manage action. Parameters ---------- action: Action name (e.g. ``"suspend"``). e

Format ad groups list as markdown.

Format ads list as markdown.

Format campaigns list as markdown.

Format keywords list as markdown.

Format Metrika comparison report as markdown.

Format Metrika counters as markdown.

Format Metrika drilldown report as markdown.

Format Metrika filters as markdown.

Format Metrika goals as markdown.

Format Metrika access grants as markdown.

Format Metrika report data as markdown.

Format Metrika segments as markdown.

Parse a Direct API manage-action response into success IDs and errors. The Direct API returns results in the shape:: {"result": {"<Actio

Register all Direct, Metrika, Wordstat, and Webmaster tools.

Register all Yandex Direct tools.

Register all Yandex Metrika tools.

Run the MCP server.

Provide a dummy token so tools can register without real credentials.

Add an audience target to an ad group.

Add a bid modifier. Bid modifier values: - 0 = disable (no impressions) - 50 = decrease bid by 50% - 100 = no change

Create new callout extensions (уточнения). Each callout text max 25 characters. Up to 50 callouts per ad.

Add a feed (YML/CSV) to Yandex Direct. Supports password-protected feeds via HTTP Basic Auth. Business types: RETAIL, HOTELS, REALTY,

Add keywords to an ad group. Creates new keywords with optional bid settings.

Create a new negative keyword shared set. After creating, link it to campaigns using direct_link_shared_set_to_campaign. Max 20 sets

Create a new retargeting list. Rules are grouped: OR between groups, AND within each group. Each rule references a Metrika goal ID.

Create a new sitelink set. Creates a set of sitelinks that can be attached to ads. Each set can contain 1-8 sitelinks. Max to

Add a targeting filter to a smart ad group. Defines which product offers from the feed are used to generate smart banners. Without co

Create a new vCard. VCards display business contact info in ads. Phone format: +7-495-123-45-67

Check all changes in the account since a timestamp. Returns IDs of modified campaigns, ad groups, and ads. Useful for full account sy

Check if campaigns have changed since a given timestamp. Useful for incremental sync - only fetch campaigns that changed. Returns cam

Create a new ad group in a campaign. Creates an ad group with specified name and targeting regions.

Create a new advertising campaign. Creates TEXT_CAMPAIGN or CPM_BANNER_CAMPAIGN with specified settings. For РСЯ campaigns, use CPM_B

Create a dynamic text ad in a dynamic ad group. Title is auto-generated from feed data. Only text needs to be specified. Used

Create a new image ad (banner) in an ad group. Creates an IMAGE_AD with the given image hash and landing page. Use image hashes from

Create a shopping ad (товарное объявление) in a UnifiedCampaign group. Shopping ads use product feed data to auto-generate ads. Repla

Create a new text ad in an ad group. Creates a text ad with title, text, and landing page URL. The ad will be sent for moderation aut

Create a VIDEO_EXTENSION_CREATIVE from an uploaded video. The video must have status READY (check with direct_get_advideos). Returns

Delete bid modifiers.

Delete feeds permanently. WARNING: Irreversible.

Delete ad images by their hashes. WARNING: Irreversible. Only images not associated with any ad can be deleted. Use direct_get_images

Delete negative keyword shared sets. WARNING: Deleting a shared set will unlink it from all associated campaigns.

Delete retargeting lists.

Delete sitelink sets. WARNING: Deleted sitelink sets will be removed from all ads using them.

Delete vCards.

Get ad extensions (callouts/уточнения) from Yandex Direct.

Get list of ad groups from Yandex Direct. Retrieves ad groups with their settings and targeting information.

Get list of ads from Yandex Direct. Retrieves ads with their content and moderation status.

Get uploaded ad videos and their processing status. Statuses: NEW, CONVERTING, READY, ERROR. Video must be READY before creating a cr

Get audience targets from Yandex Direct. Audience targets link retargeting lists to ad groups.

Get bid modifiers from Yandex Direct. Bid modifiers adjust bids based on: - Device type (mobile/desktop) - Demographics (age,

Get list of advertising campaigns from Yandex Direct. Retrieves campaigns with their settings, statistics, and current status. Suppor