Developer-tools MCP server
VK Ads MCP
Version history of discovered tools, schemas, and declared agent authority.
OBSERVED INTERFACE
Capability surface
Modelara’s observed declarations are shown separately from its derived effect classifications.
- 10
- 8
- 5
- 0
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
| Capability | Type | Derived effect | First observed in Valyd coverage | Last changed |
|---|---|---|---|---|
ad_group_actionaskads-mcp-vk-ads:tool:ad_group_actionObserved interface and hashesМеняет статус групп объявлений по id: activate (status=active), stop (status=blocked) или delete (status=deleted). Input schemasha256:215920758bfa8631af4035b71218b7b02c13707613230f957b62fa6dfa139a58Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 1.8.1 | No change observed | |
ad_plan_actionaskads-mcp-vk-ads:tool:ad_plan_actionObserved interface and hashesМеняет статус кампаний по id: activate (status=active), stop (status=blocked) или delete (status=deleted). delete удаляет только саму кампанию: её группы и объявления остаются в прежнем статусе — их удаляют отдельно через ad_group_action и banner_action. Input schemasha256:03e171dfae503fd06f44d3fe6989969a7938267b85746185c08a5804a7a13d41Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 1.8.1 | No change observed | |
auth_statusaskads-mcp-vk-ads:tool:auth_statusObserved interface and hashesПоказывает, подключена ли VK Реклама: есть ли токен, откуда он взят (переменная окружения VK_ADS_TOKEN или сохранённый вход), когда истекает, какой client_id и аккаунт за ним стоят и где лежит файл с сохранёнными данными. Ничего не отправляет в сеть, не показывает ни токен, ни client_secret. Вызовите это, если инструменты VK Рекламы отвечают, что подключение не настроено. Input schemasha256:73fc3af6ba54a1293c44f954cf944c40d069a764ef7974e6fc74addd4231b225Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 1.8.1 | No change observed | |
banner_actionaskads-mcp-vk-ads:tool:banner_actionObserved interface and hashesМеняет статус объявлений по id: activate (status=active), stop (status=blocked) или delete (status=deleted). Input schemasha256:281aa52bb3f7afb5f5e6c19e2db1344903b65d722c1ca0ea60a9d547c6352b40Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 1.8.1 | No change observed | |
create_ad_groupaskads-mcp-vk-ads:tool:create_ad_groupObserved interface and hashesСоздаёт группу объявлений внутри кампании. Таргетинг задаётся в `targetings` (например, {"geo":{"regions":[188]},"age":{"age_list":[25,26]}}). Денежные поля — в валюте аккаунта. Остальные поля — через `extra`. Input schemasha256:9f3c084bb0e5ace0f131e49858dc913a703b37bddf0139de421b01d2fafeab01Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 1.8.1 | No change observed | |
create_ad_planaskads-mcp-vk-ads:tool:create_ad_planObserved 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 schemasha256:a81d257f077b23fa0758c5e4530a99fff10b72d137e650a16c92d88acdf46fb6Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 1.8.1 | No change observed | |
create_banneraskads-mcp-vk-ads:tool:create_bannerObserved interface and hashesСоздаёт объявление внутри группы объявлений (POST v2/ad_groups/{adGroupId}/banners.json; верхний v2/banners.json — только список). Креатив ссылается на загруженные медиа через `content`, тексты объявления — в `textblocks`, ссылки — в `urls`. Эти структуры отправляются как есть; точная форма для каждого формата объявления — в документации VK Рекламы. Input schemasha256:57ce885e411cc6135cf216a224577a4f0bfaea5dc76679388bd4a41a7bd7b0eaOutput schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 1.8.1 | No change observed | |
finish_loginaskads-mcp-vk-ads:tool:finish_loginObserved interface and hashesВторой шаг подключения: обменивает client_id и client_secret из start_login на токен доступа (grant client_credentials), сохраняет всё в файл только для владельца (0600) и сразу проверяет живым запросом к VK Рекламе. После успеха остальные инструменты работают немедленно — перезапускать клиент не нужно. Токен живёт около суток и продлевается автоматически, поэтому повторно вызывать это не требуется: каждый вызов создаёт НОВЫЙ токен, а у VK не больше 5 активных токенов на пару client_id + пользователь. Ошибка invalid_client означает, что пара скопирована не полностью или относится к разным приложениям. Input schemasha256:81ed9ab7bcec906f574bbc4ea0bb341c83c9daa022d57038b259fca66bd86133Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 1.8.1 | No change observed | |
get_balanceaskads-mcp-vk-ads:tool:get_balanceObserved 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 schemasha256:73fc3af6ba54a1293c44f954cf944c40d069a764ef7974e6fc74addd4231b225Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 1.8.1 | No change observed | |
get_regionsaskads-mcp-vk-ads:tool:get_regionsObserved interface and hashesВозвращает гео-регионы VK Рекламы (id, name, type), при необходимости отфильтрованные по подстроке названия. Id регионов нужны для гео-таргетинга группы объявлений. Input schemasha256:65e584f5ad5e3f1da753548d501f580ac36a49593c32f7dd23e0d967d8b6dfecOutput schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 1.8.1 | No change observed | |
get_statisticsaskads-mcp-vk-ads:tool:get_statisticsObserved 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 schemasha256:274b7c388459bedca1263d0bc8394f795347713e7acd1b527abaed95bf3e6204Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 1.8.1 | No change observed | |
get_throttlingaskads-mcp-vk-ads:tool:get_throttlingObserved interface and hashesВозвращает текущие лимиты запросов VK Рекламы и их остаток (throttling.json) — чтобы не упереться в лимит. Input schemasha256:73fc3af6ba54a1293c44f954cf944c40d069a764ef7974e6fc74addd4231b225Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 1.8.1 | No change observed | |
get_user_infoaskads-mcp-vk-ads:tool:get_user_infoObserved interface and hashesВозвращает информацию о текущем аккаунте VK Рекламы (user.json), включая additional_info.client_name. Позволяет убедиться, на какой аккаунт рекламодателя указывает токен. Токен гранта client_credentials агентского аккаунта видит объекты самого агентства, а не его клиентов: кабинет клиента открывает только токен гранта agency_client_credentials в VK_ADS_TOKEN. Input schemasha256:9564bab62da3fa1958e82e287d9c493a0c5a3c175c9d4357e7c7b7ccd71f09feOutput schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 1.8.1 | 1.8.3 | |
list_ad_groupsaskads-mcp-vk-ads:tool:list_ad_groupsObserved interface and hashesВозвращает список групп объявлений с необязательной фильтрацией по id, родительской кампании и статусу. Денежные поля — в валюте аккаунта; в `targetings` лежит структура таргетинга по гео, демографии и интересам. Input schemasha256:015c4fc48e10df54e9549f9561e71a41db23baad613a931e270af2defe9dd873Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 1.8.1 | No change observed | |
list_ad_plansaskads-mcp-vk-ads:tool:list_ad_plansObserved interface and hashesВозвращает список ad_plan (верхнеуровневый объект кампании в VK Рекламе) с необязательной фильтрацией по id и статусу. Денежные поля (budget_limit, budget_limit_day, max_price) — в валюте аккаунта. Input schemasha256:dae7ccb587a9d85b6b4a9c2ccbee15d2a82efc567ff52f74b2b7d9c0cdb8d692Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 1.8.1 | No change observed | |
list_bannersaskads-mcp-vk-ads:tool:list_bannersObserved interface and hashesВозвращает список banner (объект объявления/креатива в VK Рекламе) с необязательной фильтрацией по id, родительской группе объявлений и статусу. moderation_status (pending/allowed/banned) и delivery объясняют, почему объявление показывается или не показывается. Input schemasha256:d39a0b021462dbdd41cc5faf440cc01e9fefc96986bb0f90132ea028f398e2abOutput schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 1.8.1 | No change observed | |
logoutaskads-mcp-vk-ads:tool:logoutObserved interface and hashesУдаляет сохранённые токен и данные приложения VK Рекламы с диска. Токен, заданный переменной окружения VK_ADS_TOKEN, не трогает — его нужно убирать из конфигурации клиента вручную. На стороне VK токен остаётся активным до истечения срока: отозвать его можно запросом POST v2/oauth2/token/delete.json, но он удаляет ВСЕ токены этого пользователя для данного client_id, поэтому здесь не вызывается. Input schemasha256:73fc3af6ba54a1293c44f954cf944c40d069a764ef7974e6fc74addd4231b225Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 1.8.1 | No change observed | |
raw_requestaskads-mcp-vk-ads:tool:raw_requestObserved interface and hashesУниверсальный запрос напрямую к любому эндпоинту API VK Рекламы (например, path "v2/ad_plans.json", method GET). Нужен для эндпоинтов, у которых нет отдельного инструмента. `query` уходит в строку запроса, `body` отправляется как JSON для POST. GET выполняется свободно; POST и DELETE — запись, для них нужен confirmWrite=true. Input schemasha256:c1e9f0d598717402d5dffde4a8f1deaa03ed063e07436e04a6a1756029bce1e2Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 1.8.1 | No change observed | |
start_loginaskads-mcp-vk-ads:tool:start_loginObserved interface and hashesПервый шаг подключения VK Рекламы без правки конфигурации и без перезапуска клиента. Ничего не отправляет в сеть — возвращает инструкцию, которую нужно показать пользователю целиком: где в кабинете создать приложение и откуда скопировать client_id и client_secret. Полученную пару передайте в finish_login. Предупредите, что client_secret — это пароль от рекламного кабинета: он сохранится на диске только для владельца и нужен, чтобы продлевать токен. Input schemasha256:73fc3af6ba54a1293c44f954cf944c40d069a764ef7974e6fc74addd4231b225Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 1.8.1 | No change observed | |
update_ad_groupaskads-mcp-vk-ads:tool:update_ad_groupObserved interface and hashesМеняет у группы объявлений название, бюджеты, предельную ставку, даты или таргетинг. Денежные поля — в валюте аккаунта. Для смены статуса — ad_group_action. Input schemasha256:34a4fba709fd6f18d1cded4841d75c0bb0d9f194cd90351a42cf2f214dddf3ddOutput schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 1.8.1 | No change observed | |
update_ad_planaskads-mcp-vk-ads:tool:update_ad_planObserved interface and hashesМеняет у кампании название, бюджеты, предельную ставку или даты. Денежные поля — в валюте аккаунта. Для смены статуса — ad_plan_action. Input schemasha256:2849e1fe6596505586a22e212cfdc95de3b994f4c2349e2b943bdced11a08de7Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 1.8.1 | No change observed | |
update_banneraskads-mcp-vk-ads:tool:update_bannerObserved interface and hashesМеняет у объявления название, текстовые блоки или ссылки. Для смены статуса — banner_action. Структуры отправляются как есть. Input schemasha256:62261b9ee1eed34425fe2802b6ff2074f431f9a297b70ff5b28ca9782c2e02c4Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 1.8.1 | No change observed | |
upload_imageaskads-mcp-vk-ads:tool:upload_imageObserved 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 schemasha256:7b01d9b41547ed09846d0adc5c061dde3626a323079d581e50b507cc9d003b94Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 1.8.1 | No change observed |
No capabilities match these filters.
STATIC COMPARISONS
Release history
- 1.8.2 1.8.3PASS0 added0 removed0 schema0 write0 destructive0 unknown
- 1.8.1 1.8.2PASS0 added0 removed0 schema0 write0 destructive0 unknown