An MCP server that gives AI agents direct access to the VK Ads API (myTarget v2) to read account state, manage campaigns, ads, statistics, and more via 48 tools.

Stars

6

7-day growth

No data

Forks

0

Open issues

0

License

Apache-2.0

Last updated

2026-07-27

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It bridges AI agents (like Claude) with the VK Ads advertising platform, enabling natural language control of ad operations without manual API calls. Provides OAuth/Click.ru authentication, supports multiple accounts, and includes 48 tools covering full campaign lifecycle.

Who it is for

  • AI developers building ad management assistants
  • Digital marketers using AI agents to manage VK Ads
  • Ad agencies automating VK Ads workflows
  • Developers integrating MCP with VK Ads

Use cases

  • Automate creation and optimization of ad campaigns via chat
  • Generate and download performance reports and statistics
  • Manage remarketing audiences and pixel segments
  • Launch and stop ad campaigns, submit ads for moderation

Strengths

  • 48 tools cover full campaign lifecycle from budget to moderation
  • Supports multiple authentication methods (Click.ru, OAuth, direct token)
  • HTTP and stdio modes with multi-account support via headers
  • Includes automated tests (54 tests) and live API checking script

Considerations

  • Does not generate ad strategy or creative content
  • No lead form creation, no listing of previously uploaded images/videos
  • Soft delete for campaigns but irreversible delete for segments/pixels

README quick start

MCP «ВК Реклама»

MCP-сервер на Bun и TypeScript, который даёт ИИ-агенту прямой доступ к API ВК Рекламы (myTarget API v2).

Что это

Из диалога с вами агент читает состояние аккаунта и вносит изменения через API: смотрит кампании, группы и объявления, выгружает статистику со срезами, создаёт и правит сущности, загружает креативы, собирает аудитории для ремаркетинга, отправляет объявления на модерацию, запускает и останавливает показы.

Стратегию и тексты объявлений сервер не придумывает — он исполняет решения, которые принимаете вы вместе с агентом. В наборе 48 инструментов.

Как проходит работа

  1. Подключение и доступ. Вы выбираете готовый токен ВК Рекламы, OAuth-приложение или подключение через Click.ru. Проверить связь можно инструментом auth_check. Сервер работает локально через стандартный ввод-вывод или по HTTP, в том числе с несколькими аккаунтами.
  2. Чтение состояния. Перед изменением агент получает кампании, группы, объявления, справочники и текущую статистику.
  3. Изменение. Агент создаёт и правит сущности, загружает изображения и видео, собирает аудитории и списки клиентов, отправляет объявления на модерацию и меняет статусы.
  4. Проверка. После изменения агент снова читает состояние и статистику.

Сервер не запускает кампании самостоятельно. Показ включается только отдельной явной сменой статуса.

Инструменты

ОбластьЧто позволяет сделать
Авторизация и аккаунтПроверить доступ, получить данные аккаунта и отозвать лишние OAuth-токены
Кампании — API ad_plansСоздавать и вести кампании верхнего уровня, задавать сроки и ограничения бюджета
Группы объявлений — API campaignsСоздавать группы с целью, бюджетом и таргетингом, запускать и останавливать показы
Дополнительные группы — API ad_groupsГруппировать объявления по таргетингу
Объявления — API bannersСоздавать и править объявления, привязывать креативы и отправлять на модерацию
КонтентЗагружать изображения и видео из локального файла или по URL
СтатистикаПолучать данные по дням, итоги за период, срезы и большие асинхронные отчёты
РемаркетингРаботать с сегментами, пикселями и списками пользователей
АгентствоПолучать список клиентов и создавать клиентов агентского аккаунта
СправочникиИскать регионы, пакеты форматов, интер

Description

MCP server for VK Ads API: campaigns, audiences, budgets, stats. Click.ru proxy, static token or OAuth. Docs in Russian.

Related repositories

Similar projects matched by category, topics, and programming language.

OneInterface
Featured
OneInterface GitHub avatar

stormy-cookbook

Stormy Cookbook provides copy-pasteable recipes for using the Stormy Social Data API and MCP server, which offers a unified REST API and MCP tools to search profiles, posts, and emails across TikTok, YouTube, Instagram, LinkedIn, X, and Reddit through a single HTTP contract.

AI & Machine LearningLarge Language Models
72
0xwilliamortiz
Featured
0xwilliamortiz GitHub avatar

openclaude-improved

OpenClaude is an open-source CLI coding agent that runs on any platform and supports a wide range of LLM providers, offering the same tools and workflows as Claude Code.

AI & Machine LearningLarge Language Models
577
S40911120
Featured
S40911120 GitHub avatar

recensa

Recensa is a self-hosted web viewer that indexes Claude Code session transcripts into a local SQLite database, enabling full-text search, replay, and audit of all past agent conversations without uploading data anywhere.

AI & Machine LearningLarge Language Models
67