VK Ads MCP — Claude Code MCP server: features and setup
Connects an AI client to VK Ads for campaign analysis, reporting, and live changes to budgets or ad statuses.
claude mcp add --env VK_ADS_TOKEN=<VK_ADS_TOKEN> --env VK_ADS_LANG=<VK_ADS_LANG> --env VK_ADS_TIMEOUT_MS=<VK_ADS_TIMEOUT_MS> --env VK_ADS_MAX_RETRIES=<VK_ADS_MAX_RETRIES> --env VK_ADS_API_BASE=<VK_ADS_API_BASE> --transport stdio vk-ads-mcp -- npx -y mcp-vk-adsWhat VK Ads MCP does
VK Ads MCP gives an AI client access to the VK Ads advertising account. It can inspect campaigns, ad groups, banners, spending, clicks, balances, API limits, regions, and moderation states. The object tree uses ad_plan for campaigns, ad_group for groups, and banner for ads.
Read operations cover lists, reports, balances, limits, and regions. Creating or editing campaigns, groups, and ads applies changes to the live account, as do status actions. VK Ads has no sandbox, so a budget or status request should be checked against the intended object before execution.
The server needs Node.js 20 or newer and VK_ADS_TOKEN; optional settings use VK_ADS_LANG, VK_ADS_TIMEOUT_MS, VK_ADS_MAX_RETRIES, and VK_ADS_API_BASE. It runs through npx -y mcp-vk-ads.
What it helps with
- inspect campaign spend by date range
- compare ad groups by clicks and cost
- locate ads blocked by delivery or moderation
- change a group’s daily budget
- pause an ad by ID
Example prompts for the agent
- Show my VK Ads campaigns and group spend for last week.
- Compare the ad groups in this campaign by clicks, spend, and status.
- Check the selected group ID, then change its daily budget.
How to install VK Ads MCP
Platform CLI
claude mcp add --env VK_ADS_TOKEN=<VK_ADS_TOKEN> --env VK_ADS_LANG=<VK_ADS_LANG> --env VK_ADS_TIMEOUT_MS=<VK_ADS_TIMEOUT_MS> --env VK_ADS_MAX_RETRIES=<VK_ADS_MAX_RETRIES> --env VK_ADS_API_BASE=<VK_ADS_API_BASE> --transport stdio vk-ads-mcp -- npx -y mcp-vk-adsReplace <…> with your own values
Platform CLI
codex mcp add vk-ads-mcp --env VK_ADS_TOKEN=<VK_ADS_TOKEN> --env VK_ADS_LANG=<VK_ADS_LANG> --env VK_ADS_TIMEOUT_MS=<VK_ADS_TIMEOUT_MS> --env VK_ADS_MAX_RETRIES=<VK_ADS_MAX_RETRIES> --env VK_ADS_API_BASE=<VK_ADS_API_BASE> -- npx -y mcp-vk-adsReplace <…> with your own values
Config file
{
"mcpServers": {
"vk-ads-mcp": {
"command": "npx",
"args": [
"-y",
"mcp-vk-ads"
],
"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 <…> with your own values
Config file
{
"servers": {
"vk-ads-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-vk-ads"
],
"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 <…> with your own values
Platform CLI
gemini mcp add -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> vk-ads-mcp npx -y mcp-vk-adsReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about VK Ads MCP
How do I install VK Ads MCP in Claude Code?
Run claude mcp add mcp-vk-ads -e VK_ADS_TOKEN=<VK_ADS_TOKEN> -- npx -y mcp-vk-ads.
What does VK Ads MCP do?
It lets an AI client inspect and manage VK Ads campaigns, groups, banners, reports, balances, API limits, and regions.
Which VK Ads MCP actions affect the live account?
Creating or editing campaigns, groups, and ads changes the production account immediately. Status actions do the same, and VK Ads provides no sandbox.
