Skip to main content
Glama
Yandex Direct MCP

Yandex Direct MCP

Создать текстовую кампанию

create_text_campaign

Creates a Yandex Direct text campaign with a name and start date, and optionally applies a bidding strategy to control budgets or ad networks.

Instructions

Создаёт кампанию TextCampaign (текстово-графические объявления). Без biddingStrategy применяются ручные ставки на поиске с отключёнными сетями (Search HIGHEST_POSITION, Network SERVING_OFF) — у ручных ставок текстовой кампании бюджета в API нет. Чтобы ограничить расход, включить автостратегию или сети, передать biddingStrategy целиком — {Search, Network}, недельный бюджет внутри него (WeeklySpendLimit в структуре параметров автостратегии). Дневного бюджета у Директа больше нет. Запрос идёт в API v501, в песочнице — в v5.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "name": "<name>",
      "startDate": "<startDate>"
    },
    "name": "create_text_campaign"
  }
}

Input Schema

NameRequiredDescriptionDefault
nameYesНазвание кампании.
endDateNoДата окончания в формате YYYY-MM-DD.
startDateYesДата начала в формате YYYY-MM-DD.
client_loginNoЛогин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.
biddingStrategyNoПолный объект BiddingStrategy {Search, Network} в формате API, деньги (WeeklySpendLimit, BidCeiling, AverageCpc, AverageCpa, Cpa…) в валюте аккаунта. Заменяет значение по умолчанию.
dailyBudgetModeNoУстарело: дневного бюджета в Директе больше нет (с 30.11.2026) — вызов с этим параметром отклоняется. У текстовой кампании недельный бюджет есть только у автостратегий: передать biddingStrategy, например {Search: {BiddingStrategyType: "WB_MAXIMUM_CLICKS", WbMaximumClicks: {WeeklySpendLimit: <сумма>}}, Network: {BiddingStrategyType: "SERVING_OFF"}}. У ручных ставок (HIGHEST_POSITION) TextCampaign бюджета нет.
dailyBudgetAmountNoУстарело: дневного бюджета в Директе больше нет (с 30.11.2026) — вызов с этим параметром отклоняется. У текстовой кампании недельный бюджет есть только у автостратегий: передать biddingStrategy, например {Search: {BiddingStrategyType: "WB_MAXIMUM_CLICKS", WbMaximumClicks: {WeeklySpendLimit: <сумма>}}, Network: {BiddingStrategyType: "SERVING_OFF"}}. У ручных ставок (HIGHEST_POSITION) TextCampaign бюджета нет.
weeklyBudgetAmountNoУстарело: вызов с этим параметром отклоняется. У текстовой кампании недельный бюджет есть только у автостратегий: передать biddingStrategy, например {Search: {BiddingStrategyType: "WB_MAXIMUM_CLICKS", WbMaximumClicks: {WeeklySpendLimit: <сумма>}}, Network: {BiddingStrategyType: "SERVING_OFF"}}. У ручных ставок (HIGHEST_POSITION) TextCampaign бюджета нет.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changedv1.13.1
    • changedInput schema / properties / dailyBudgetAmount / description
      Previous value: -"Дневной бюджет в валюте аккаунта (конвертируется в микроединицы)."New value: +"Устарело: дневного бюджета в Директе больше нет (с 30.11.2026) — вызов с этим параметром отклоняется. У текстовой кампании недельный бюджет есть только у автостратегий: передать biddingStrategy, например {Search: {BiddingStrategyType: \"WB_MAXIMUM_CLICKS\", WbMaximumClicks: {WeeklySpendLimit: <сумма>}}, Network: {BiddingStrategyType: \"SERVING_OFF\"}}. У ручных ставок (HIGHEST_POSITION) TextCampaign бюджета нет."
    • removedInput schema / properties / dailyBudgetAmount / exclusiveMinimum
      Removed value: -0
    • changedInput schema / properties / dailyBudgetMode / description
      Previous value: -"Режим траты дневного бюджета: STANDARD — показы как можно быстрее, DISTRIBUTED — равномерно в течение дня. По умолчанию STANDARD."New value: +"Устарело: дневного бюджета в Директе больше нет (с 30.11.2026) — вызов с этим параметром отклоняется. У текстовой кампании недельный бюджет есть только у автостратегий: передать biddingStrategy, например {Search: {BiddingStrategyType: \"WB_MAXIMUM_CLICKS\", WbMaximumClicks: {WeeklySpendLimit: <сумма>}}, Network: {BiddingStrategyType: \"SERVING_OFF\"}}. У ручных ставок (HIGHEST_POSITION) TextCampaign бюджета нет."
    • addedInput schema / properties / weeklyBudgetAmount
      Added value: +{
      +  "description": "Устарело: вызов с этим параметром отклоняется. У текстовой кампании недельный бюджет есть только у автостратегий: передать biddingStrategy, например {Search: {BiddingStrategyType: \"WB_MAXIMUM_CLICKS\", WbMaximumClicks: {WeeklySpendLimit: <сумма>}}, Network: {BiddingStrategyType: \"SERVING_OFF\"}}. У ручных ставок (HIGHEST_POSITION) TextCampaign бюджета нет.",
      +  "type": "number"
      +}
  2. Changed1 schema field changedv1.12.1
    • changedInput schema / properties / biddingStrategy / description
      Previous value: -"Полный объект BiddingStrategy {Search, Network}. Заменяет значение по умолчанию."New value: +"Полный объект BiddingStrategy {Search, Network} в формате API, деньги (WeeklySpendLimit, BidCeiling, AverageCpc, AverageCpa, Cpa…) в валюте аккаунта. Заменяет значение по умолчанию."
  3. Changed1 schema field changedv1.6.0
    • addedInput schema / properties / client_login
      Added value: +{
      +  "description": "Логин клиента агентства или кабинета в управлении (из list_clients). Если не указан — YANDEX_DIRECT_LOGIN из конфигурации, а без него собственный аккаунт токена.",
      +  "pattern": "^[A-Za-z0-9][A-Za-z0-9._@-]{0,99}$",
      +  "type": "string"
      +}
  4. Changed6 schema fields changedv1.5.1
    • changedInput schema / properties / biddingStrategy / description
      Previous value: -"Full BiddingStrategy object {Search, Network}. Overrides the default."New value: +"Полный объект BiddingStrategy {Search, Network}. Заменяет значение по умолчанию."
    • changedInput schema / properties / dailyBudgetAmount / description
      Previous value: -"Daily budget in account currency units (converted to micros)."New value: +"Дневной бюджет в валюте аккаунта (конвертируется в микроединицы)."
    • addedInput schema / properties / dailyBudgetMode / description
      Added value: +"Режим траты дневного бюджета: STANDARD — показы как можно быстрее, DISTRIBUTED — равномерно в течение дня. По умолчанию STANDARD."
    • changedInput schema / properties / endDate / description
      Previous value: -"End date, format YYYY-MM-DD."New value: +"Дата окончания в формате YYYY-MM-DD."
    • changedInput schema / properties / name / description
      Previous value: -"Campaign name."New value: +"Название кампании."
    • changedInput schema / properties / startDate / description
      Previous value: -"Start date, format YYYY-MM-DD."New value: +"Дата начала в формате YYYY-MM-DD."
  5. First observedv0.1.0

TDQS

A4.5/5.0
Behavior5/5

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

Beyond the annotations (which only declare it is a non-idempotent write with open-world scope), the description discloses the concrete default state created when biddingStrategy is omitted, that manual-bid text campaigns carry no budget at all, that deprecated budget parameters are rejected outright, and which API version the call targets. This is exactly the kind of consequence-of-calling detail the annotations cannot supply.

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?

Five tight sentences, front-loaded with purpose and then default behavior, with no filler. The weekly-budget guidance is stated once in the body and then echoed three times via the schema's deprecated-parameter descriptions, which is slightly redundant but outside the description text itself.

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

Completeness4/5

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

For a mutation tool with a deeply nested biddingStrategy object and no output schema, the description covers the risky parts: defaults, budget placement, deprecated fields, and API version. It does not say what is returned (e.g., the new campaign ID) or whether any permission/agency context is required beyond client_login, which are minor residual gaps given the annotations.

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

Parameters4/5

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

Schema coverage is 100%, so the baseline is 3, but the description adds real meaning the schema lacks: it states what the default biddingStrategy actually is and that the weekly budget must be nested inside the autostrategy object rather than passed as a top-level amount. The deprecation notes for dailyBudgetMode/dailyBudgetAmount/weeklyBudgetAmount are already in the schema, so the description only reinforces rather than extends those.

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?

The opening sentence names a specific verb and resource ('Создаёт кампанию TextCampaign') and scopes it to text-graphic ads, which distinguishes it immediately from create_text_ad, create_ad_group, and update_campaign. An agent knows exactly what object this creates without reading the schema.

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

Usage Guidelines4/5

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

It gives clear conditional guidance on when to omit biddingStrategy (manual HIGHEST_POSITION bids, networks off) versus when to pass it (to cap spend via an autostrategy). It does not route to siblings such as set_campaign_strategy for later changes, so it stops short of full when/when-not/alternatives coverage.

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