Skip to main content
Glama
yandex-direct-mcp-plus

yandex-direct-mcp-plus

by Pavelsiba

Установить ставки

set_keyword_bids
Idempotent

Set fixed search and network bids by keyword, ad group, or campaign, and enable or disable autotargeting auto-bid for manual Yandex.Direct strategies.

Instructions

Установить фиксированные ставки (поиск/сети, в рублях) на уровне фраз, групп или кампаний и включить или выключить автоставку автотаргетинга. Ставки применяются только при ручной стратегии: на автостратегии их назначает Директ, и ставка, не подходящая стратегии, не применится. Сначала get_strategy, затем get_keyword_auction — сколько стоит нужный объём трафика; ставку под объём ставит set_auto_keyword_bids.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "set_keyword_bids"
  }
}

Input Schema

NameRequiredDescriptionDefault
search_bidNoСтавка на поиске в рублях. Применяется только при ручной стратегии на поиске (HIGHEST_POSITION)
keyword_idsNoСтавки по указанным фразам и автотаргетингам
network_bidNoСтавка в сетях (РСЯ) в рублях. Применяется только при ручной стратегии в сетях (MAXIMUM_COVERAGE)
ad_group_idsNoСтавки по всем фразам указанных групп
campaign_idsNoСтавки по всем фразам указанных кампаний
autotargeting_auto_bidNoАвтоставка автотаргетинга на поиске: true — Директ подбирает ставку сам, false — действует search_bid. Если для keyword_ids передать search_bid без этого поля, Директ выключит автоставку; чтобы сохранить её, передайте true

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed15 schema fields changedv2.1.0
    • changedInput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • addedInput schema / additionalProperties
      Added value: +false
    • changedInput schema / properties / ad_group_ids / description
      Previous value: -"Ставки на все фразы указанных групп"New value: +"Ставки по всем фразам указанных групп"
    • addedInput schema / properties / ad_group_ids / maxItems
      Added value: +1000
    • addedInput schema / properties / autotargeting_auto_bid
      Added value: +{
      +  "description": "Автоставка автотаргетинга на поиске: true — Директ подбирает ставку сам, false — действует search_bid. Если для keyword_ids передать search_bid без этого поля, Директ выключит автоставку; чтобы сохранить её, передайте true",
      +  "type": "boolean"
      +}
    • removedInput schema / properties / bid
      Removed value: -{
      -  "description": "Ставка на поиске в рублях",
      -  "exclusiveMinimum": 0,
      -  "type": "number"
      -}
    • changedInput schema / properties / campaign_ids / description
      Previous value: -"Ставки на все фразы указанных кампаний"New value: +"Ставки по всем фразам указанных кампаний"
    • addedInput schema / properties / campaign_ids / maxItems
      Added value: +10
    • removedInput schema / properties / context_bid
      Removed value: -{
      -  "description": "Ставка в сетях (РСЯ) в рублях",
      -  "exclusiveMinimum": 0,
      -  "type": "number"
      -}
    • removedInput schema / properties / dry_run
      Removed value: -{
      -  "description": "true — ничего не менять: проверить параметры и вернуть тела запросов, которые ушли бы в Директ. Чтение при этом выполняется.",
      -  "type": "boolean"
      -}
    • changedInput schema / properties / keyword_ids / description
      Previous value: -"Ставки на уровне фраз"New value: +"Ставки по указанным фразам и автотаргетингам"
    • changedInput schema / properties / keyword_ids / items / description
      Previous value: -"ID ключевой фразы"New value: +"ID ключевой фразы или автотаргетинга"
    • addedInput schema / properties / keyword_ids / maxItems
      Added value: +10000
    • addedInput schema / properties / network_bid
      Added value: +{
      +  "description": "Ставка в сетях (РСЯ) в рублях. Применяется только при ручной стратегии в сетях (MAXIMUM_COVERAGE)",
      +  "exclusiveMinimum": 0,
      +  "type": "number"
      +}
    • addedInput schema / properties / search_bid
      Added value: +{
      +  "description": "Ставка на поиске в рублях. Применяется только при ручной стратегии на поиске (HIGHEST_POSITION)",
      +  "exclusiveMinimum": 0,
      +  "type": "number"
      +}
  2. Changed1 schema field changedv1.7.0
    • addedInput schema / properties / dry_run
      Added value: +{
      +  "description": "true — ничего не менять: проверить параметры и вернуть тела запросов, которые ушли бы в Директ. Чтение при этом выполняется.",
      +  "type": "boolean"
      +}
  3. First observedv1.6.1

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the annotations (readOnly=false, idempotent=true), the description discloses two important behaviors: bids are silently not applied when the campaign uses an autostrategy, and the tool toggles autotargeting auto-bidding. The side effect of omitting autotargeting_auto_bid while sending search_bid is documented in the schema rather than the description, and precedence when multiple targeting levels are supplied is not explained.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three dense sentences, front-loaded with the action and scope, then the manual-strategy constraint, then the prerequisite workflow and alternative. Nothing is redundant, though the run-on construction of the first sentence costs a little readability.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a six-parameter mutation with no output schema, the definition covers the strategy prerequisite, the recommended discovery sequence, the sibling alternative, and the auto-bid toggle behavior. An agent has enough to call it correctly without further context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so parameter meaning is already carried by the schema. The description adds only high-level framing (bids are fixed, in rubles, at three levels) and no extra detail about interaction between keyword_ids, ad_group_ids and campaign_ids when supplied together, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource (set fixed bids in rubles for search/network) plus the three targeting levels (keywords, ad groups, campaigns) and the auto-targeting toggle. It explicitly names set_auto_keyword_bids as the tool for volume-based bidding, so the agent can separate the two without opening either schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives an explicit precondition ('Ставки применяются только при ручной стратегии'), an ordered prerequisite workflow (get_strategy, then get_keyword_auction), and an explicit alternative for a different need (set_auto_keyword_bids for volume-based bids). When-to-use and when-not-to-use are both covered.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.