Log inSubmit server
MCP Vk Ads logo

MCP Vk Ads

by askads

Manage VK Ads campaigns, targeting, creatives, authentication, and performance reports through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Vk Ads

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "askads-mcp-vk-ads": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-vk-ads@latest"
      ],
      "env": {
        "VK_ADS_TOKEN": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

askads/mcp-vk-ads connects AI applications to the VK Ads API for reading and changing campaigns, ad groups, banners, account data, and statistics. It supports interactive authentication with VK Ads credentials or the VK_ADS_TOKEN environment variable, then stores and renews access credentials locally. Use it to inspect spend and delivery, configure targeting, manage live advertising objects, or call API endpoints that lack dedicated tools. Write operations affect the live VK Ads account, while raw POST and DELETE requests require explicit confirmation.

Use cases

  • Review campaign spend, clicks, impressions, and trends
  • Compare ad groups and banners by performance
  • Create or adjust campaigns, targeting, budgets, and bids
  • Check account balance, regions, moderation, and delivery status

Key features

  • Interactive VK Ads authentication with automatic token renewal
  • Campaign, ad group, and banner CRUD operations
  • Targeting and geographic region lookup
  • Statistics with summary, time grouping, sorting, and totals
  • Direct access to additional VK Ads API endpoints
  • Account balance and API throttling inspection

Tools22

What MCP Vk Ads lets your agent do. Expand a tool for its parameters.

Verified live~4.8k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

18/18 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 10d ago via OSV.dev · mcp-vk-ads@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars11Stargazers on the source repository.
npm downloads852Package downloads in the last 30 days.
Last commit6d agoMost recent push to the default branch.
Tools exposed22Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Vk Ads works

What askads/mcp-vk-ads does

askads/mcp-vk-ads exposes the VK Ads advertising hierarchy through MCP: campaigns (ad_plan), ad groups (ad_group), and banners. It can list, create, update, activate, stop, or delete these objects. Campaign and group tools handle names, budgets, bids, dates, and status actions; group operations also accept targeting data, while banner operations work with text blocks, URLs, and creative references.

Read-only tools cover the connected advertiser account, balance, API throttling limits, geographic regions, object lists, and performance reports. Statistics can be requested for campaigns, groups, or banners, with summary or time-based grouping and server-side sorting. The raw_request tool provides direct access to VK Ads API paths when a specialized tool is not available.

How it works

The server runs over MCP using standard input/output and communicates with VK Ads through its API. Authentication can happen in the conversation: start_login explains how to create an application and obtain client_id and client_secret, while finish_login exchanges those values for an access token, saves the credentials with owner-only permissions, and checks the connection. Stored tokens last about a day and are renewed automatically. auth_status, get_user_info, and logout help inspect or remove the local connection.

VK Ads objects form a three-level structure. A campaign contains groups, and groups contain banners. Monetary values such as budgets, bids, spend, and balance use the advertising account's currency. Region IDs returned by get_regions can be used in group targeting, including geographic and demographic targeting structures.

Setup and configuration

Node.js 20 or newer is required. The package can be started without a separate installation using:

Terminal
npx -y mcp-vk-ads@latest

Add that command as an MCP server in a compatible client. The interactive login flow does not require an environment variable or a client restart. For automated or non-interactive setups, provide VK_ADS_TOKEN; this token is separate from the locally saved login data.

The login flow requires an application created in the VK Ads account's API access settings. The client secret is stored locally because VK Ads requires it when renewing the token. logout removes saved application data and tokens, but it does not remove a token supplied through VK_ADS_TOKEN.

Tools and capabilities

  • Inspect authentication status, advertiser identity, balance, and API request limits.
  • Find VK Ads regions for campaign targeting.
  • List and modify campaigns, ad groups, and banners.
  • Create campaigns and groups with additional request fields through extra.
  • Submit banner content, text blocks, and links using VK Ads structures.
  • Retrieve spend, impressions, clicks, and other statistics by object level and period.
  • Send direct GET, POST, or DELETE requests with raw_request.

Limitations and notes

Changes apply directly to the live advertising account; VK Ads does not provide a sandbox for these operations. Status actions can activate, stop, or delete campaigns, groups, and banners. The dedicated write tools do not include an internal confirmation parameter, so confirmation behavior depends on the MCP client or calling application. For raw_request, GET is read-only, while POST and DELETE require confirmWrite=true.

After a network error or server error during creation, check the object list before retrying because the original request may have succeeded. Banner content formats follow VK Ads API requirements. The balance tool returns VK's raw response, so callers should read the account balance and currency fields from that response. Client accounts managed through an agency require a suitable pre-issued token in VK_ADS_TOKEN.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Vk Ads

askads/mcp-vk-ads is an MCP server that connects AI applications to the VK Ads API. Its main tools authenticate accounts, inspect campaigns, ad groups, banners, balances, regions, and statistics, and create or update advertising objects. It also supports status changes and direct requests to VK Ads endpoints.

Install it by configuring your MCP client to run `npx -y mcp-vk-ads@latest`; Node.js 20 or newer is required. The package does not need a separate installation, and interactive VK Ads authentication can be completed after the server starts.

Yes, askads/mcp-vk-ads works with Cursor through its MCP configuration. Add a server entry that runs `npx -y mcp-vk-ads@latest` in the global `~/.cursor/mcp.json` or the project-level `.cursor/mcp.json` file.

Authenticate by starting the server's conversational login flow, which explains how to obtain a VK Ads `client_id` and `client_secret`, or provide an access token through `VK_ADS_TOKEN`. The interactive flow saves credentials locally and renews its token automatically.

Yes, its campaign, ad group, and banner creation, update, and status tools change the live VK Ads account immediately. The `raw_request` tool additionally requires `confirmWrite=true` for POST and DELETE requests, while confirmation for dedicated write tools depends on the calling client.

Related MCP servers

All in Marketing All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Vk Ads AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/askads-mcp-vk-ads?style=directory)](https://allmcps.com/mcp/askads-mcp-vk-ads)
HTML Embed
<a href="https://allmcps.com/mcp/askads-mcp-vk-ads"><img src="https://allmcps.com/api/badge/askads-mcp-vk-ads?style=directory" alt="MCP Vk Ads on AllMCPs" /></a>