VK Ads MCP MCP Server

io.github.askads/mcp-vk-ads

Repository Registry

What is the VK Ads MCP MCP server?

MCP server for VK Ads (VK Реклама) API: manage ad plans, ad groups, banners, and statistics.

How to install VK Ads MCP

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

VK_ADS_TOKEN
secret
Optional ready-made VK Ads OAuth2 access token (Bearer) for CI and unattended installs — full account access, treat it as a secret. Without it the server connects from the chat via start_login/finish_login.
VK_ADS_LANG
Language for API responses (Accept-Language header), e.g. ru, en.
VK_ADS_TIMEOUT_MS
Per-request timeout in milliseconds.
VK_ADS_MAX_RETRIES
Max retries for transient errors (429 rate limit, 5xx on GET, network errors on GET).
VK_ADS_API_BASE
API root without a version segment. Defaults to https://ads.vk.com/api.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-vk-ads": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-vk-ads"
      ],
      "env": {
        "VK_ADS_TOKEN": "<YOUR_VK_ADS_TOKEN>",
        "VK_ADS_LANG": "<YOUR_VK_ADS_LANG>",
        "VK_ADS_TIMEOUT_MS": "<YOUR_VK_ADS_TIMEOUT_MS>",
        "VK_ADS_MAX_RETRIES": "<YOUR_VK_ADS_MAX_RETRIES>",
        "VK_ADS_API_BASE": "<YOUR_VK_ADS_API_BASE>"
      }
    }
  }
}