Developer-tools MCP server

VK Ads MCP

Version history of discovered tools, schemas, and declared agent authority.

View watchlist

DistributionDistribution: npm
Packagemcp-vk-ads
Latest analyzed version1.8.3
Current tool count23
Latest analysisNov 16, 2026
Package source

OBSERVED INTERFACE

Capability surface

Modelara’s observed declarations are shown separately from its derived effect classifications.

3 releases analyzed1.8.1 → 1.8.3Latest: 1.8.3
  • read10
  • write8
  • destructive5
  • unknown0

Unknown means Valyd could not determine the capability's effect confidently from the declared interface and static evidence. It is not treated as safe.

Package
mcp-vk-ads@1.8.3
Registry
npm
Published
Nov 1, 2026
Integrity
sha512-qH0altyzRhjr8ReTGQFSK+AEle7vvcw4LcdEzfTxD1I8sqFI45u7jT2okZjf6+iBLV06O4pck+inTYtQ86j9/w==
Analyzer
modelara v0.1.8 · policy not recorded
Repository
https://github.com/askads/mcp-vk-ads

23 capabilities

CapabilityTypeDerived effectFirst observed in Valyd coverageLast changed
ad_group_actionaskads-mcp-vk-ads:tool:ad_group_action
Observed interface and hashes

Меняет статус групп объявлений по id: activate (status=active), stop (status=blocked) или delete (status=deleted).

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "action": {
      "enum": [
        "activate",
        "stop",
        "delete"
      ],
      "type": "string"
    },
    "ids": {
      "description": "Id групп объявлений, к которым применить действие.",
      "items": {
        "type": "integer"
      },
      "minItems": 1,
      "type": "array"
    }
  },
  "required": [
    "action",
    "ids"
  ],
  "type": "object"
}
sha256:215920758bfa8631af4035b71218b7b02c13707613230f957b62fa6dfa139a58

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:f7f2280aea4125a04ecae4e8bf7c1546dd2446544456b4a38ac12ec6d06653f2

Interface hash: sha256:e9e9ceb43afea822eac5f0d5b7d79bced7032c2a6636143ef427cf29b04874f1

Other observed Modelara metadata
{
  "id": "mcp:mcp-vk-ads/ad_group_action",
  "title": "Действие над группой объявлений",
  "source": {
    "type": "mcp",
    "server": "mcp-vk-ads",
    "operation": "ad_group_action"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "false",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:daf4f3fd265860c44efa43abac53c2d9356a98daf4c44f742dd21961e7c02c86"
}
tooldestructive1.8.1No change observed
ad_plan_actionaskads-mcp-vk-ads:tool:ad_plan_action
Observed interface and hashes

Меняет статус кампаний по id: activate (status=active), stop (status=blocked) или delete (status=deleted). delete удаляет только саму кампанию: её группы и объявления остаются в прежнем статусе — их удаляют отдельно через ad_group_action и banner_action.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "action": {
      "enum": [
        "activate",
        "stop",
        "delete"
      ],
      "type": "string"
    },
    "ids": {
      "description": "Id кампаний, к которым применить действие.",
      "items": {
        "type": "integer"
      },
      "minItems": 1,
      "type": "array"
    }
  },
  "required": [
    "action",
    "ids"
  ],
  "type": "object"
}
sha256:03e171dfae503fd06f44d3fe6989969a7938267b85746185c08a5804a7a13d41

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:29d448ccc20a22a73247b90c8a58c7994d235793d4aafead37781c4a74e092d6

Interface hash: sha256:280bb4ac1fbd5ecb4e2f45d3899914099bbe1dd3bd1582a1ac6e9b899a54fa69

Other observed Modelara metadata
{
  "id": "mcp:mcp-vk-ads/ad_plan_action",
  "title": "Действие над кампанией",
  "source": {
    "type": "mcp",
    "server": "mcp-vk-ads",
    "operation": "ad_plan_action"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "false",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:58e5cc6d80354009e5e48f083a763a264c8f46774a6f77231cd3f73d39841955"
}
tooldestructive1.8.1No change observed
auth_statusaskads-mcp-vk-ads:tool:auth_status
Observed interface and hashes

Показывает, подключена ли VK Реклама: есть ли токен, откуда он взят (переменная окружения VK_ADS_TOKEN или сохранённый вход), когда истекает, какой client_id и аккаунт за ним стоят и где лежит файл с сохранёнными данными. Ничего не отправляет в сеть, не показывает ни токен, ни client_secret. Вызовите это, если инструменты VK Рекламы отвечают, что подключение не настроено.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {},
  "type": "object"
}
sha256:73fc3af6ba54a1293c44f954cf944c40d069a764ef7974e6fc74addd4231b225

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:d309cb37fb555f397df2ebc01f6a125efabd97376e3430542c8a7814734311aa

Interface hash: sha256:3a81cc2911f0ce6e5229b296a6469e641b5ab77cb13578191d580170d17d690a

Other observed Modelara metadata
{
  "id": "mcp:mcp-vk-ads/auth_status",
  "title": "Статус подключения к VK Рекламе",
  "source": {
    "type": "mcp",
    "server": "mcp-vk-ads",
    "operation": "auth_status"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:842ab0c7213e3881f9f7289c6c860e9403e426b9b984ba356f8f6e53fc1e2cdd"
}
toolread1.8.1No change observed
banner_actionaskads-mcp-vk-ads:tool:banner_action
Observed interface and hashes

Меняет статус объявлений по id: activate (status=active), stop (status=blocked) или delete (status=deleted).

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "action": {
      "enum": [
        "activate",
        "stop",
        "delete"
      ],
      "type": "string"
    },
    "ids": {
      "description": "Id объявлений, к которым применить действие.",
      "items": {
        "type": "integer"
      },
      "minItems": 1,
      "type": "array"
    }
  },
  "required": [
    "action",
    "ids"
  ],
  "type": "object"
}
sha256:281aa52bb3f7afb5f5e6c19e2db1344903b65d722c1ca0ea60a9d547c6352b40

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:973b364bf2b6ef08cbc5c54a62cfd585e3f631a2e73f6f3bbb2a778a8ad87e83

Interface hash: sha256:b10196bd99b80ae4c5a911272a3df704131fc0778b342e60c112a7461b131a29

Other observed Modelara metadata
{
  "id": "mcp:mcp-vk-ads/banner_action",
  "title": "Действие над объявлением",
  "source": {
    "type": "mcp",
    "server": "mcp-vk-ads",
    "operation": "banner_action"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "false",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:5a6fc251fdd40397964774c946f85f96edeb4d769902df22fde8399542c18cd5"
}
tooldestructive1.8.1No change observed
create_ad_groupaskads-mcp-vk-ads:tool:create_ad_group
Observed interface and hashes

Создаёт группу объявлений внутри кампании. Таргетинг задаётся в `targetings` (например, {"geo":{"regions":[188]},"age":{"age_list":[25,26]}}). Денежные поля — в валюте аккаунта. Остальные поля — через `extra`.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "adPlanId": {
      "description": "Id родительской кампании.",
      "type": "integer"
    },
    "autobiddingMode": {
      "description": "Стратегия аукциона, например max_goals.",
      "type": "string"
    },
    "budgetLimit": {
      "description": "Общий бюджет в валюте аккаунта.",
      "exclusiveMinimum": 0,
      "type": "number"
    },
    "budgetLimitDay": {
      "description": "Дневной бюджет в валюте аккаунта. Минимум по справке VK — 300 ₽ (у Дзена свой лимит).",
      "exclusiveMinimum": 0,
      "type": "number"
    },
    "dateEnd": {
      "description": "Дата окончания, YYYY-MM-DD.",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "type": "string"
    },
    "dateStart": {
      "description": "Дата начала, YYYY-MM-DD.",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "type": "string"
    },
    "extra": {
      "additionalProperties": {},
      "description": "Дополнительные поля, подмешиваемые в тело запроса как есть.",
      "type": "object"
    },
    "maxPrice": {
      "description": "Предельная ставка в валюте аккаунта.",
      "exclusiveMinimum": 0,
      "type": "number"
    },
    "name": {
      "description": "Название группы объявлений.",
      "minLength": 1,
      "type": "string"
    },
    "objective": {
      "description": "Цель группы, например site_conversions, leadads, traffic.",
      "type": "string"
    },
    "price": {
      "description": "Цена оптимизируемого события в валюте аккаунта.",
      "exclusiveMinimum": 0,
      "type": "number"
    },
    "targetings": {
      "additionalProperties": {},
      "description": "Структура таргетинга, отправляется как есть.",
      "type": "object"
    }
  },
  "required": [
    "adPlanId",
    "name"
  ],
  "type": "object"
}
sha256:9f3c084bb0e5ace0f131e49858dc913a703b37bddf0139de421b01d2fafeab01

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:5ce24ad705e519fba6351654abb1f42a028e9eb3f521535cca2659bbe4299c1f

Interface hash: sha256:fcdf880fbe74a638fc86469c8919363f236a96a03c61b45e459aafd8d1d7aeaf

Other observed Modelara metadata
{
  "id": "mcp:mcp-vk-ads/create_ad_group",
  "title": "Создать группу объявлений",
  "source": {
    "type": "mcp",
    "server": "mcp-vk-ads",
    "operation": "create_ad_group"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:41e6aab83e9566024fa997601eedb5a8e889a3c4ba4b7702bad97aca149db950"
}
toolwrite1.8.1No change observed
create_ad_planaskads-mcp-vk-ads:tool:create_ad_plan
Observed interface and hashes

Создаёт кампанию (ad_plan). Денежные поля — в валюте аккаунта. Сложные и редкие поля передаются через `extra` (подмешиваются в тело запроса как есть). Пустую кампанию VK не создаёт: в `adGroups` нужен массив новых групп объявлений, у каждой — name, package_id, targetings, а для autobiddingMode=max_goals ещё priced_goal {source_id: id счётчика, name: цель}. Следующие группы добавляет create_ad_group. Кампании на сайт нужна привязка `extra.ad_object_type`="url" + `extra.ad_object_id` (id URL-объекта; без неё любой package_id отвергается как invalid_package) — проще всего взять ad_object_id, package_id и priced_goal у существующей кампании и её групп (list_ad_plans / list_ad_groups с нужными fields). budgetLimit и budgetLimitDay одновременно передавать нельзя — только одно из двух. Чтобы ничего не запустилось, передать status="blocked" и в `extra`, и у каждой группы в `adGroups`.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "adGroups": {
      "description": "Первые группы объявлений, создаваемые вместе с кампанией (новые, без id). Обязательны: VK не создаёт пустую кампанию.",
      "items": {
        "additionalProperties": {},
        "type": "object"
      },
      "minItems": 1,
      "type": "array"
    },
    "autobiddingMode": {
      "description": "Стратегия аукциона, например max_goals, fixed, second_price_mean.",
      "type": "string"
    },
    "budgetLimit": {
      "description": "Общий бюджет в валюте аккаунта.",
      "exclusiveMinimum": 0,
      "type": "number"
    },
    "budgetLimitDay": {
      "description": "Дневной бюджет в валюте аккаунта. Минимум по справке VK — 300 ₽ (у Дзена свой лимит).",
      "exclusiveMinimum": 0,
      "type": "number"
    },
    "dateEnd": {
      "description": "Дата окончания, YYYY-MM-DD.",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "type": "string"
    },
    "dateStart": {
      "description": "Дата начала, YYYY-MM-DD.",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "type": "string"
    },
    "extra": {
      "additionalProperties": {},
      "description": "Дополнительные поля кампании, подмешиваемые в тело запроса (например, priced_goal, pricelist_id).",
      "type": "object"
    },
    "maxPrice": {
      "description": "Предельная ставка в валюте аккаунта.",
      "exclusiveMinimum": 0,
      "type": "number"
    },
    "name": {
      "description": "Название кампании.",
      "minLength": 1,
      "type": "string"
    },
    "objective": {
      "description": "Цель кампании, например site_conversions, leadads, traffic.",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}
sha256:a81d257f077b23fa0758c5e4530a99fff10b72d137e650a16c92d88acdf46fb6

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:3eb091b3e7343080641e7c0681c8f9b8a1861c1db91595d350f29da11cfcce20

Interface hash: sha256:3abd99f55c4a2e28555884bd2e787248434b84d481da3e15eed166d6c1f5fc4d

Other observed Modelara metadata
{
  "id": "mcp:mcp-vk-ads/create_ad_plan",
  "title": "Создать кампанию (ad_plan)",
  "source": {
    "type": "mcp",
    "server": "mcp-vk-ads",
    "operation": "create_ad_plan"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:914bd792a8f99ae8188e1bf291e0f26c39095e291d0cc2fb167e61695e4c1b04"
}
toolwrite1.8.1No change observed
create_banneraskads-mcp-vk-ads:tool:create_banner
Observed interface and hashes

Создаёт объявление внутри группы объявлений (POST v2/ad_groups/{adGroupId}/banners.json; верхний v2/banners.json — только список). Креатив ссылается на загруженные медиа через `content`, тексты объявления — в `textblocks`, ссылки — в `urls`. Эти структуры отправляются как есть; точная форма для каждого формата объявления — в документации VK Рекламы.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "adGroupId": {
      "description": "Id родительской группы объявлений.",
      "type": "integer"
    },
    "content": {
      "additionalProperties": {},
      "description": "Ссылки на содержимое креатива: {\"<слот>\": {\"id\": <id из upload_image>}}. Картинка должна подходить слоту по размеру (image_600x600 — не шире 600 px).",
      "type": "object"
    },
    "extra": {
      "additionalProperties": {},
      "description": "Дополнительные поля объявления, подмешиваемые в тело запроса как есть.",
      "type": "object"
    },
    "name": {
      "description": "Название объявления.",
      "minLength": 1,
      "type": "string"
    },
    "textblocks": {
      "additionalProperties": {},
      "description": "Текстовые блоки, например {\"title\":{\"text\":\"...\"},\"text\":{\"text\":\"...\"}}.",
      "type": "object"
    },
    "urls": {
      "additionalProperties": {},
      "description": "Объекты ссылок, например {\"primary\":{\"url\":\"https://...\"}}.",
      "type": "object"
    }
  },
  "required": [
    "adGroupId"
  ],
  "type": "object"
}
sha256:57ce885e411cc6135cf216a224577a4f0bfaea5dc76679388bd4a41a7bd7b0ea

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:ec8a74a0538fbe3762b47c4d1a9fc872cc32022f215f32914c4dfd6eed728e76

Interface hash: sha256:cf069c25683b8ba75cf8faa2e0f7a39476b8c9dda15cbd7b1576fcbaa64e1984

Other observed Modelara metadata
{
  "id": "mcp:mcp-vk-ads/create_banner",
  "title": "Создать объявление (banner)",
  "source": {
    "type": "mcp",
    "server": "mcp-vk-ads",
    "operation": "create_banner"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:0caec796f7228e6c626b8a816c1653c73d0d3ca7777bac8d5dfe536ce326958b"
}
toolwrite1.8.1No change observed
finish_loginaskads-mcp-vk-ads:tool:finish_login
Observed interface and hashes

Второй шаг подключения: обменивает client_id и client_secret из start_login на токен доступа (grant client_credentials), сохраняет всё в файл только для владельца (0600) и сразу проверяет живым запросом к VK Рекламе. После успеха остальные инструменты работают немедленно — перезапускать клиент не нужно. Токен живёт около суток и продлевается автоматически, поэтому повторно вызывать это не требуется: каждый вызов создаёт НОВЫЙ токен, а у VK не больше 5 активных токенов на пару client_id + пользователь. Ошибка invalid_client означает, что пара скопирована не полностью или относится к разным приложениям.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "clientId": {
      "description": "client_id приложения из раздела «Настройки → Доступ к API» кабинета VK Рекламы.",
      "minLength": 1,
      "type": "string"
    },
    "clientSecret": {
      "description": "client_secret того же приложения. Не показывайте его в ответе пользователю.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "clientId",
    "clientSecret"
  ],
  "type": "object"
}
sha256:81ed9ab7bcec906f574bbc4ea0bb341c83c9daa022d57038b259fca66bd86133

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:810470854421458c8bf6bedd13b3caffe2dff82c191254b148ee5f9d9f89e15a

Interface hash: sha256:dd578b8d840ea4005178f9b62e598511951e62463af98f0537ce3d432835ab5d

Other observed Modelara metadata
{
  "id": "mcp:mcp-vk-ads/finish_login",
  "title": "Завершить подключение VK Рекламы",
  "source": {
    "type": "mcp",
    "server": "mcp-vk-ads",
    "operation": "finish_login"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:4eea3bbf135b22e4dd5ae2a904dc1fddbe84343d1f721eeaf0dd7ce090c5bc4d"
}
toolwrite1.8.1No change observed
get_balanceaskads-mcp-vk-ads:tool:get_balance
Observed interface and hashes

Возвращает текущий баланс аккаунта VK Рекламы: доступные средства и валюту. Вызывает user.json с полем `account`, в котором лежит кошелёк (account.balance, account.currency). Показывает баланс того аккаунта, на который указывает токен (параметров нет). Важно: точное имя поля с балансом в v3/user.json на новой платформе ads.vk.com не подтверждено на живом кабинете (домен закрыт JS); схема следует объектной модели myTarget/VK Ads (v2/v3). Инструмент отдаёт СЫРОЙ ответ VK без изменений, поэтому вызывающая сторона может аккуратно прочитать account.balance независимо от точной формы ответа — проверить на первом живом аккаунте с доступом read_payments.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {},
  "type": "object"
}
sha256:73fc3af6ba54a1293c44f954cf944c40d069a764ef7974e6fc74addd4231b225

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:70e9bf89c1310e845578e02785d0cecf2dcb3190659a22faf9e00ebb21b1d914

Interface hash: sha256:a91bd055d2d401c79f864395e65795c37a92d3db8eb6b9ef5b6b86832744c2d1

Other observed Modelara metadata
{
  "id": "mcp:mcp-vk-ads/get_balance",
  "title": "Баланс аккаунта",
  "source": {
    "type": "mcp",
    "server": "mcp-vk-ads",
    "operation": "get_balance"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:a0a4fff34ea17e57ae825a1b72a5ce8d80e8d4c4eae02275694329d0c766f922"
}
toolread1.8.1No change observed
get_regionsaskads-mcp-vk-ads:tool:get_regions
Observed interface and hashes

Возвращает гео-регионы VK Рекламы (id, name, type), при необходимости отфильтрованные по подстроке названия. Id регионов нужны для гео-таргетинга группы объявлений.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "limit": {
      "description": "Сколько регионов вернуть после фильтрации. По умолчанию 50.",
      "minimum": 1,
      "type": "integer"
    },
    "query": {
      "description": "Подстрока для фильтра по названию региона, без учёта регистра (например, «Москва»).",
      "type": "string"
    }
  },
  "type": "object"
}
sha256:65e584f5ad5e3f1da753548d501f580ac36a49593c32f7dd23e0d967d8b6dfec

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:dc64aa696e6fbb12a95935eaab816cdd307fb93caa1049ebb80733e4e4f23060

Interface hash: sha256:405bb80cb38c9447829da1b8df3e0d2814b6a04f1729dcda907a1e449708406c

Other observed Modelara metadata
{
  "id": "mcp:mcp-vk-ads/get_regions",
  "title": "Список регионов",
  "source": {
    "type": "mcp",
    "server": "mcp-vk-ads",
    "operation": "get_regions"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:d7acdd6385a781397a953f428b7d37102b93fdf0f171d7757d84ce5f596d8ccc"
}
toolread1.8.1No change observed
get_statisticsaskads-mcp-vk-ads:tool:get_statistics
Observed interface and hashes

Возвращает статистику по кампаниям (ad_plans), группам объявлений (ad_groups) или объявлениям (banners). По умолчанию группировка `summary` — одна сводная строка (`items[].total`) на объект: с dateFrom/dateTo — за этот период, без дат — за всё время. `day` нужна ТОЛЬКО для динамики и вопросов про тренд: добавляет к каждому объекту `rows` по дням, даты обязательны. Недель и месяцев API не отдаёт — их собирают из `day`. Ранжирование на стороне сервера (sortBy, например base.spent, и order) и постраничная выдача (limit/offset) работают только в `summary` с датами — в остальных режимах VK их молча игнорирует, поэтому инструмент вернёт ошибку. Там VK и так отдаёт все объекты одним ответом, так что autoPaginate безвреден в любом режиме. `total` в ответе — сумма по объектам ЭТОЙ страницы (при фильтре по ids — по этим объектам), а не по всему кабинету. Метрики лежат в `base` (shows, clicks, spent, ...); spent — в валюте аккаунта.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "autoPaginate": {
      "description": "Забрать все страницы, идя по offset/count (в day и summary без дат ответ и так полный).",
      "type": "boolean"
    },
    "dateFrom": {
      "description": "Дата начала, YYYY-MM-DD (обязательна для day; для summary без дат — итог за всё время).",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "type": "string"
    },
    "dateTo": {
      "description": "Дата окончания, YYYY-MM-DD (обязательна для day).",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "type": "string"
    },
    "entity": {
      "description": "Тип объектов для отчёта. По умолчанию banners.",
      "enum": [
        "ad_plans",
        "ad_groups",
        "banners"
      ],
      "type": "string"
    },
    "ids": {
      "description": "Ограничить отчёт этими id объектов (выбранного entity).",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "limit": {
      "description": "Сколько объектов на страницу (не больше 250).",
      "maximum": 250,
      "minimum": 1,
      "type": "integer"
    },
    "metrics": {
      "description": "Группы метрик в отчёте, например base, events, video. По умолчанию — набор API.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "offset": {
      "description": "Смещение постраничной выдачи (сколько объектов пропустить).",
      "minimum": 0,
      "type": "integer"
    },
    "order": {
      "description": "Направление сортировки для sortBy. По умолчанию desc.",
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string"
    },
    "period": {
      "description": "Группировка: summary (итог по объекту, по умолчанию) либо day для динамики по дням.",
      "enum": [
        "summary",
        "day"
      ],
      "type": "string"
    },
    "sortBy": {
      "description": "Поле сортировки на стороне сервера, например base.spent / base.clicks / base.shows (топ-N по метрике).",
      "type": "string"
    }
  },
  "type": "object"
}
sha256:274b7c388459bedca1263d0bc8394f795347713e7acd1b527abaed95bf3e6204

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:2a660bc81f9d37c67c22c44e6639074e63a80d91fe63bce57c179a8fc9a0573f

Interface hash: sha256:dfadbdbbecb0721384539154e162ed023e2e937432faf479e52a1398bec61269

Other observed Modelara metadata
{
  "id": "mcp:mcp-vk-ads/get_statistics",
  "title": "Статистика",
  "source": {
    "type": "mcp",
    "server": "mcp-vk-ads",
    "operation": "get_statistics"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:0bf2f9188b58a8f07f3c85dbe4aaa4b1de45c67613308c8aeb1c44c3fcb92a72"
}
toolread1.8.1No change observed
get_throttlingaskads-mcp-vk-ads:tool:get_throttling
Observed interface and hashes

Возвращает текущие лимиты запросов VK Рекламы и их остаток (throttling.json) — чтобы не упереться в лимит.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {},
  "type": "object"
}
sha256:73fc3af6ba54a1293c44f954cf944c40d069a764ef7974e6fc74addd4231b225

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:e29781b87cec1d25465825529ede96ab75428c4f716132515e789297d4890771

Interface hash: sha256:fc6e647cd9f4551f24ac1320644a235fb5822b6c2131f74b13fc3c9cb86de848

Other observed Modelara metadata
{
  "id": "mcp:mcp-vk-ads/get_throttling",
  "title": "Лимиты запросов к API",
  "source": {
    "type": "mcp",
    "server": "mcp-vk-ads",
    "operation": "get_throttling"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:b37c507518a2e55c2cda283be055379f39e6b197588b6fc3dab5235111c0a9f2"
}
toolread1.8.1No change observed
get_user_infoaskads-mcp-vk-ads:tool:get_user_info
Observed interface and hashes

Возвращает информацию о текущем аккаунте VK Рекламы (user.json), включая additional_info.client_name. Позволяет убедиться, на какой аккаунт рекламодателя указывает токен. Токен гранта client_credentials агентского аккаунта видит объекты самого агентства, а не его клиентов: кабинет клиента открывает только токен гранта agency_client_credentials в VK_ADS_TOKEN.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "fields": {
      "description": "Поля пользователя в ответе. По умолчанию — базовый набор.",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "type": "object"
}
sha256:9564bab62da3fa1958e82e287d9c493a0c5a3c175c9d4357e7c7b7ccd71f09fe

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:656be523c9665229fae80d4a351f07cc2282177eacba2c955bc011f436f4e8f5

Interface hash: sha256:9db9408e3b590ca90a0a51b5bda43cefc8fc16e70c02294cb363f1a8d22f2780

Other observed Modelara metadata
{
  "id": "mcp:mcp-vk-ads/get_user_info",
  "title": "Информация об аккаунте",
  "source": {
    "type": "mcp",
    "server": "mcp-vk-ads",
    "operation": "get_user_info"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:f09fbd2dc0ee75206af8c63d4c87d4f432454922834d01905a714d5c78286e0c"
}
toolread1.8.11.8.3
list_ad_groupsaskads-mcp-vk-ads:tool:list_ad_groups
Observed interface and hashes

Возвращает список групп объявлений с необязательной фильтрацией по id, родительской кампании и статусу. Денежные поля — в валюте аккаунта; в `targetings` лежит структура таргетинга по гео, демографии и интересам.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "adPlanIds": {
      "description": "Фильтр по id родительских кампаний.",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "autoPaginate": {
      "description": "Забрать все страницы, идя по offset/count (limit при этом не ограничивает общее число объектов).",
      "type": "boolean"
    },
    "fields": {
      "description": "Поля группы объявлений в ответе (с «targetings» вернётся полный объект таргетинга).",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "ids": {
      "description": "Фильтр по id групп объявлений.",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "limit": {
      "description": "Сколько объектов на страницу (не больше 250).",
      "maximum": 250,
      "minimum": 1,
      "type": "integer"
    },
    "offset": {
      "description": "Смещение постраничной выдачи (сколько объектов пропустить).",
      "minimum": 0,
      "type": "integer"
    },
    "statuses": {
      "description": "Фильтр по статусу.",
      "items": {
        "enum": [
          "active",
          "blocked",
          "deleted"
        ],
        "type": "string"
      },
      "type": "array"
    }
  },
  "type": "object"
}
sha256:015c4fc48e10df54e9549f9561e71a41db23baad613a931e270af2defe9dd873

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:1c38cc607e9e69f48d4756cae788650e54538fe6cbc72d301957d002a65406a7

Interface hash: sha256:726e33979c0c87a6c79ddd858a79923ad37c27030124de5daa6a052563d3e519

Other observed Modelara metadata
{
  "id": "mcp:mcp-vk-ads/list_ad_groups",
  "title": "Список групп объявлений",
  "source": {
    "type": "mcp",
    "server": "mcp-vk-ads",
    "operation": "list_ad_groups"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:f3b7be8fdcce1682d2945496f77500bd5407a059d0f270f1953023325e939705"
}
toolread1.8.1No change observed
list_ad_plansaskads-mcp-vk-ads:tool:list_ad_plans
Observed interface and hashes

Возвращает список ad_plan (верхнеуровневый объект кампании в VK Рекламе) с необязательной фильтрацией по id и статусу. Денежные поля (budget_limit, budget_limit_day, max_price) — в валюте аккаунта.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "autoPaginate": {
      "description": "Забрать все страницы, идя по offset/count (limit при этом не ограничивает общее число объектов).",
      "type": "boolean"
    },
    "fields": {
      "description": "Поля кампании в ответе.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "ids": {
      "description": "Фильтр по id кампаний.",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "limit": {
      "description": "Сколько объектов на страницу (не больше 250).",
      "maximum": 250,
      "minimum": 1,
      "type": "integer"
    },
    "offset": {
      "description": "Смещение постраничной выдачи (сколько объектов пропустить).",
      "minimum": 0,
      "type": "integer"
    },
    "statuses": {
      "description": "Фильтр по статусу.",
      "items": {
        "enum": [
          "active",
          "blocked",
          "deleted"
        ],
        "type": "string"
      },
      "type": "array"
    }
  },
  "type": "object"
}
sha256:dae7ccb587a9d85b6b4a9c2ccbee15d2a82efc567ff52f74b2b7d9c0cdb8d692

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:3874007e284acf7a5d20878a3df3a1d5ac45577ca54e829b3134b55de9d0a32f

Interface hash: sha256:a9f160618a1880cf4ab3dc16676204554c6685b74d32d9357351a7a552a53462

Other observed Modelara metadata
{
  "id": "mcp:mcp-vk-ads/list_ad_plans",
  "title": "Список кампаний (ad_plans)",
  "source": {
    "type": "mcp",
    "server": "mcp-vk-ads",
    "operation": "list_ad_plans"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:7f3a455e6dc1b17ae610ab88b93f11c271ae53367fc71d8a8d7cd840d774cf0f"
}
toolread1.8.1No change observed
list_bannersaskads-mcp-vk-ads:tool:list_banners
Observed interface and hashes

Возвращает список banner (объект объявления/креатива в VK Рекламе) с необязательной фильтрацией по id, родительской группе объявлений и статусу. moderation_status (pending/allowed/banned) и delivery объясняют, почему объявление показывается или не показывается.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "adGroupIds": {
      "description": "Фильтр по id родительских групп объявлений.",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "autoPaginate": {
      "description": "Забрать все страницы, идя по offset/count (limit при этом не ограничивает общее число объектов).",
      "type": "boolean"
    },
    "fields": {
      "description": "Поля объявления в ответе.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "ids": {
      "description": "Фильтр по id объявлений.",
      "items": {
        "type": "integer"
      },
      "type": "array"
    },
    "limit": {
      "description": "Сколько объектов на страницу (не больше 250).",
      "maximum": 250,
      "minimum": 1,
      "type": "integer"
    },
    "offset": {
      "description": "Смещение постраничной выдачи (сколько объектов пропустить).",
      "minimum": 0,
      "type": "integer"
    },
    "statuses": {
      "description": "Фильтр по статусу.",
      "items": {
        "enum": [
          "active",
          "blocked",
          "deleted"
        ],
        "type": "string"
      },
      "type": "array"
    }
  },
  "type": "object"
}
sha256:d39a0b021462dbdd41cc5faf440cc01e9fefc96986bb0f90132ea028f398e2ab

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:72135bdf6ea586369d3dd521c99e3678bed3f4be1a640fd44d019b01e5b297ba

Interface hash: sha256:fbd6abf0b7587c32f6e9a96abf61f6ce8eaf0735e7ed097ea9c7ecebb81ef395

Other observed Modelara metadata
{
  "id": "mcp:mcp-vk-ads/list_banners",
  "title": "Список объявлений (banners)",
  "source": {
    "type": "mcp",
    "server": "mcp-vk-ads",
    "operation": "list_banners"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:fb657be368a8cb9e25f2f00660cfa0d0de9e29dfd888a9f2168c107f7dce0003"
}
toolread1.8.1No change observed
logoutaskads-mcp-vk-ads:tool:logout
Observed interface and hashes

Удаляет сохранённые токен и данные приложения VK Рекламы с диска. Токен, заданный переменной окружения VK_ADS_TOKEN, не трогает — его нужно убирать из конфигурации клиента вручную. На стороне VK токен остаётся активным до истечения срока: отозвать его можно запросом POST v2/oauth2/token/delete.json, но он удаляет ВСЕ токены этого пользователя для данного client_id, поэтому здесь не вызывается.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {},
  "type": "object"
}
sha256:73fc3af6ba54a1293c44f954cf944c40d069a764ef7974e6fc74addd4231b225

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:20c47b1dbff1e9e3cbad14ee9fb5f6b96934c74cf51b7a42635ab01390a9c544

Interface hash: sha256:a57d5c3c677a7cb6a8b716cc6a07534c361e4a18849642994ea35586557ee5ca

Other observed Modelara metadata
{
  "id": "mcp:mcp-vk-ads/logout",
  "title": "Отключить VK Рекламу",
  "source": {
    "type": "mcp",
    "server": "mcp-vk-ads",
    "operation": "logout"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "false",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:d05fe72bfc1519d9516243d6ffc3762db11e7f812bf6ddce24a8092b27806fe8"
}
tooldestructive1.8.1No change observed
raw_requestaskads-mcp-vk-ads:tool:raw_request
Observed interface and hashes

Универсальный запрос напрямую к любому эндпоинту API VK Рекламы (например, path "v2/ad_plans.json", method GET). Нужен для эндпоинтов, у которых нет отдельного инструмента. `query` уходит в строку запроса, `body` отправляется как JSON для POST. GET выполняется свободно; POST и DELETE — запись, для них нужен confirmWrite=true.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "body": {
      "additionalProperties": {},
      "description": "JSON-тело для POST-запросов.",
      "type": "object"
    },
    "confirmWrite": {
      "description": "Должен быть true для записи (POST или DELETE).",
      "type": "boolean"
    },
    "method": {
      "description": "HTTP-метод. По умолчанию GET.",
      "enum": [
        "GET",
        "POST",
        "DELETE"
      ],
      "type": "string"
    },
    "path": {
      "description": "Путь эндпоинта с версией, например \"v2/ad_plans.json\", \"v3/statistics/banners/day.json\".",
      "minLength": 1,
      "type": "string"
    },
    "query": {
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      },
      "description": "Параметры строки запроса (фильтры, поля, постраничная выдача).",
      "type": "object"
    }
  },
  "required": [
    "path"
  ],
  "type": "object"
}
sha256:c1e9f0d598717402d5dffde4a8f1deaa03ed063e07436e04a6a1756029bce1e2

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:ea6e51246887fe8e5b0cd60f905c3f6602d2a181641d3adb9c12bb2f9ce6aa0b

Interface hash: sha256:88e8edf5641f7192659837b6aebcbd8a8645ca0e4cc1bc53667458bfc8d6028e

Other observed Modelara metadata
{
  "id": "mcp:mcp-vk-ads/raw_request",
  "title": "Произвольный запрос к API VK Рекламы",
  "source": {
    "type": "mcp",
    "server": "mcp-vk-ads",
    "operation": "raw_request"
  },
  "declared": {
    "read_only": "false",
    "destructive": "true",
    "idempotent": "false",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:dc12e158321f22406ddc3ea2859d72747a5e62a41ac435b3bb18a14ae701dbeb"
}
tooldestructive1.8.1No change observed
start_loginaskads-mcp-vk-ads:tool:start_login
Observed interface and hashes

Первый шаг подключения VK Рекламы без правки конфигурации и без перезапуска клиента. Ничего не отправляет в сеть — возвращает инструкцию, которую нужно показать пользователю целиком: где в кабинете создать приложение и откуда скопировать client_id и client_secret. Полученную пару передайте в finish_login. Предупредите, что client_secret — это пароль от рекламного кабинета: он сохранится на диске только для владельца и нужен, чтобы продлевать токен.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {},
  "type": "object"
}
sha256:73fc3af6ba54a1293c44f954cf944c40d069a764ef7974e6fc74addd4231b225

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:c0d13366c83867c6b7576d183eeedea8f4d0112069883ef5086ecbaf92233d7c

Interface hash: sha256:c963e2d40ba2ffd59b5549ac83c4478685208b46fd875a19113c6b1180aac83b

Other observed Modelara metadata
{
  "id": "mcp:mcp-vk-ads/start_login",
  "title": "Начать подключение VK Рекламы",
  "source": {
    "type": "mcp",
    "server": "mcp-vk-ads",
    "operation": "start_login"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:2780750a7d20650dc70771392bab3d964645c86a9762e48e086848d778892ed4"
}
toolread1.8.1No change observed
update_ad_groupaskads-mcp-vk-ads:tool:update_ad_group
Observed interface and hashes

Меняет у группы объявлений название, бюджеты, предельную ставку, даты или таргетинг. Денежные поля — в валюте аккаунта. Для смены статуса — ad_group_action.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "budgetLimit": {
      "description": "Общий бюджет в валюте аккаунта.",
      "exclusiveMinimum": 0,
      "type": "number"
    },
    "budgetLimitDay": {
      "description": "Дневной бюджет в валюте аккаунта. Минимум по справке VK — 300 ₽ (у Дзена свой лимит).",
      "exclusiveMinimum": 0,
      "type": "number"
    },
    "dateEnd": {
      "description": "Новая дата окончания, YYYY-MM-DD.",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "type": "string"
    },
    "extra": {
      "additionalProperties": {},
      "description": "Дополнительные поля, подмешиваемые в тело запроса как есть.",
      "type": "object"
    },
    "id": {
      "description": "Id изменяемой группы объявлений.",
      "type": "integer"
    },
    "maxPrice": {
      "description": "Предельная ставка в валюте аккаунта.",
      "exclusiveMinimum": 0,
      "type": "number"
    },
    "name": {
      "description": "Новое название.",
      "minLength": 1,
      "type": "string"
    },
    "targetings": {
      "additionalProperties": {},
      "description": "Новая структура таргетинга взамен прежней, отправляется как есть.",
      "type": "object"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}
sha256:34a4fba709fd6f18d1cded4841d75c0bb0d9f194cd90351a42cf2f214dddf3dd

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:a1b8418ed228cabae96d6da8bffb4f2a86cfc8a199039cdea5b0b60707ef9ee9

Interface hash: sha256:378cca076fa138217481ef380a54574279773c8e09ac3c0bfee6e6f4fd074ce2

Other observed Modelara metadata
{
  "id": "mcp:mcp-vk-ads/update_ad_group",
  "title": "Изменить группу объявлений",
  "source": {
    "type": "mcp",
    "server": "mcp-vk-ads",
    "operation": "update_ad_group"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:7982d169e9ed4ac3234124426456a7d0b3a674385ee192ccf8789acef352ded4"
}
toolwrite1.8.1No change observed
update_ad_planaskads-mcp-vk-ads:tool:update_ad_plan
Observed interface and hashes

Меняет у кампании название, бюджеты, предельную ставку или даты. Денежные поля — в валюте аккаунта. Для смены статуса — ad_plan_action.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "budgetLimit": {
      "description": "Общий бюджет в валюте аккаунта.",
      "exclusiveMinimum": 0,
      "type": "number"
    },
    "budgetLimitDay": {
      "description": "Дневной бюджет в валюте аккаунта. Минимум по справке VK — 300 ₽ (у Дзена свой лимит).",
      "exclusiveMinimum": 0,
      "type": "number"
    },
    "dateEnd": {
      "description": "Новая дата окончания, YYYY-MM-DD.",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "type": "string"
    },
    "extra": {
      "additionalProperties": {},
      "description": "Дополнительные поля, подмешиваемые в тело запроса как есть.",
      "type": "object"
    },
    "id": {
      "description": "Id изменяемой кампании.",
      "type": "integer"
    },
    "maxPrice": {
      "description": "Предельная ставка в валюте аккаунта.",
      "exclusiveMinimum": 0,
      "type": "number"
    },
    "name": {
      "description": "Новое название.",
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}
sha256:2849e1fe6596505586a22e212cfdc95de3b994f4c2349e2b943bdced11a08de7

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:3b15261494cab82fc1503def33066b29b6b6632074b6451ae6028defab03b73a

Interface hash: sha256:a04b98a35601b23e1ce3f8e27cf963be66de7b1cd8979681b5961fe70afa1446

Other observed Modelara metadata
{
  "id": "mcp:mcp-vk-ads/update_ad_plan",
  "title": "Изменить кампанию (ad_plan)",
  "source": {
    "type": "mcp",
    "server": "mcp-vk-ads",
    "operation": "update_ad_plan"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:253b6896c81b2fb97e22c657f6753dd11532017a1b8a4ae32859ac9b2de87b58"
}
toolwrite1.8.1No change observed
update_banneraskads-mcp-vk-ads:tool:update_banner
Observed interface and hashes

Меняет у объявления название, текстовые блоки или ссылки. Для смены статуса — banner_action. Структуры отправляются как есть.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "extra": {
      "additionalProperties": {},
      "description": "Дополнительные поля, подмешиваемые в тело запроса как есть.",
      "type": "object"
    },
    "id": {
      "description": "Id изменяемого объявления.",
      "type": "integer"
    },
    "name": {
      "description": "Новое название.",
      "minLength": 1,
      "type": "string"
    },
    "textblocks": {
      "additionalProperties": {},
      "description": "Новые текстовые блоки взамен прежних, отправляются как есть.",
      "type": "object"
    },
    "urls": {
      "additionalProperties": {},
      "description": "Новые объекты ссылок взамен прежних, отправляются как есть.",
      "type": "object"
    }
  },
  "required": [
    "id"
  ],
  "type": "object"
}
sha256:62261b9ee1eed34425fe2802b6ff2074f431f9a297b70ff5b28ca9782c2e02c4

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:0a0ee909c430cb6e99d36907012a5424c828d02136f40af6e5fe5a7efb3f18e3

Interface hash: sha256:6a2a21f558e8d8e72e1e05e403ce1eab649ee0f3a450e5e69cc7fab431c80c43

Other observed Modelara metadata
{
  "id": "mcp:mcp-vk-ads/update_banner",
  "title": "Изменить объявление (banner)",
  "source": {
    "type": "mcp",
    "server": "mcp-vk-ads",
    "operation": "update_banner"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "true",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:1e4c4eb56238cf4d9fb40a742a15797655c24eb36158ba1d00985c573379943a"
}
toolwrite1.8.1No change observed
upload_imageaskads-mcp-vk-ads:tool:upload_image
Observed interface and hashes

Загружает изображение JPEG или PNG в медиатеку VK Рекламы (multipart POST v2/content/static.json) и возвращает его id и variants. Этот id передаётся в create_banner как content.<слот>={"id": <id>}; какие слоты нужны, зависит от формата (package) группы. Размер картинки должен подходить слоту: например, image_600x600 принимает не шире 600 px, иначе create_banner получит bad_width. Байты передаются base64 без префикса data:, вместе с шириной и высотой картинки в пикселях. При сетевой ошибке или 5xx загрузка могла пройти — не повторять вслепую.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "height": {
      "description": "Высота изображения в пикселях.",
      "maximum": 16384,
      "minimum": 1,
      "type": "integer"
    },
    "imageBase64": {
      "description": "Изображение JPEG/PNG в base64, без префикса data:. Не больше 5 МБ после декодирования.",
      "maxLength": 6990508,
      "minLength": 4,
      "type": "string"
    },
    "width": {
      "description": "Ширина изображения в пикселях.",
      "maximum": 16384,
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "imageBase64",
    "width",
    "height"
  ],
  "type": "object"
}
sha256:7b01d9b41547ed09846d0adc5c061dde3626a323079d581e50b507cc9d003b94

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:81552c3b7600eb3396e257adec1335eb86fca8f8517f0461feddef639f8ae627

Interface hash: sha256:080e9fc2815d61a319aee664b0ad4195a8af6035ef15a44cf0e5256936f4204e

Other observed Modelara metadata
{
  "id": "mcp:mcp-vk-ads/upload_image",
  "title": "Загрузить изображение",
  "source": {
    "type": "mcp",
    "server": "mcp-vk-ads",
    "operation": "upload_image"
  },
  "declared": {
    "read_only": "false",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "true"
  },
  "safety": {
    "idempotent": "false",
    "retry_safe": "false"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:bde6696f39b79bf4cfefd9efa1d6b2bb73207b720633f745feb8712595429251"
}
toolwrite1.8.1No change observed

STATIC COMPARISONS

Release history

2 release transitions
  1. 0 added0 removed0 schema0 write0 destructive0 unknown

    Nov 16, 2026· Automated static analysis

  2. 0 added0 removed0 schema0 write0 destructive0 unknown

    Nov 16, 2026· Automated static analysis