NestDaddy

VK Ads MCP

io.github.askads/mcp-vk-ads · v1.8.3

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

Connect Runs on your machine

Terminal
claude mcp add mcp-vk-ads -e VK_ADS_TOKEN=<VK_ADS_TOKEN> -e VK_ADS_LANG=<VK_ADS_LANG> -e VK_ADS_TIMEOUT_MS=<VK_ADS_TIMEOUT_MS> -e VK_ADS_MAX_RETRIES=<VK_ADS_MAX_RETRIES> -e VK_ADS_API_BASE=<VK_ADS_API_BASE> -- npx -y [email protected]
claude_desktop_config.json
{
  "mcpServers": {
    "mcp-vk-ads": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "VK_ADS_TOKEN": "<VK_ADS_TOKEN>",
        "VK_ADS_LANG": "<VK_ADS_LANG>",
        "VK_ADS_TIMEOUT_MS": "<VK_ADS_TIMEOUT_MS>",
        "VK_ADS_MAX_RETRIES": "<VK_ADS_MAX_RETRIES>",
        "VK_ADS_API_BASE": "<VK_ADS_API_BASE>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "mcp-vk-ads": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "VK_ADS_TOKEN": "<VK_ADS_TOKEN>",
        "VK_ADS_LANG": "<VK_ADS_LANG>",
        "VK_ADS_TIMEOUT_MS": "<VK_ADS_TIMEOUT_MS>",
        "VK_ADS_MAX_RETRIES": "<VK_ADS_MAX_RETRIES>",
        "VK_ADS_API_BASE": "<VK_ADS_API_BASE>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "mcp-vk-ads": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "VK_ADS_TOKEN": "<VK_ADS_TOKEN>",
        "VK_ADS_LANG": "<VK_ADS_LANG>",
        "VK_ADS_TIMEOUT_MS": "<VK_ADS_TIMEOUT_MS>",
        "VK_ADS_MAX_RETRIES": "<VK_ADS_MAX_RETRIES>",
        "VK_ADS_API_BASE": "<VK_ADS_API_BASE>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
VK_ADS_TOKEN
Optional, 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
Optional
Language for API responses (Accept-Language header), e.g. ru, en.
VK_ADS_TIMEOUT_MS
Optional
Per-request timeout in milliseconds.
VK_ADS_MAX_RETRIES
Optional
Max retries for transient errors (429 rate limit, 5xx on GET, network errors on GET).
VK_ADS_API_BASE
Optional
API root without a version segment. Defaults to https://ads.vk.com/api.

Details

Package[email protected] (NPM, stdio)
First published1 Nov 2026
Last updated1 Nov 2026
Registry nameio.github.askads/mcp-vk-ads

More marketing and seo servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.