VK Ads MCP
VK Ads MCP server: campaigns, ad groups, ads, statistics and account balance
Install
claude mcp add vk-ads -e VK_ADS_TOKEN=ваш_токен -- npx -y @theyahia/vk-ads-mcpThis is third-party code. Review the repository files before installing.
What it does
The server works with VK Ads API v2 and gives the agent eight tools. The agent can list campaigns, ad groups with targeting and ads, create a campaign or an ad, change a budget, and activate, stop or delete a campaign. Impressions, clicks and spend are available per day or as a summary, and the balance comes from account data. The token selects the account, so an agency uses a separate token per client.
Who it is for. Targeting specialists and marketers running campaigns in VK Ads.
Good fit when
- You need spend and remaining budget without spreadsheet exports
- You need to quickly stop or start a campaign
- You need a daily campaign report for a period
Not a fit when
- You need bulk actions, creative uploads or retargeting audiences
- The agent must not be allowed to create and delete campaigns
Example request
Show daily stats for campaign 12345 for last week and the account balanceLimitations
Requires a VK Ads OAuth token that lasts about a day. Auto-refresh needs the client id, client secret and refresh token. Balance requires the read_payments scope. The author marks some API details, such as budget units and the balance field, as needing verification with a live token. Bulk actions, creatives and targeting reference lists are not included yet.
How to disable. Remove it with claude mcp remove vk-ads or delete the vk-ads block from your client config.
MCP
- Transport
- stdio
- Authentication
- OAuth
| Environment variables | |
|---|---|
| VK_ADS_TOKEN required, secret | VK Ads API OAuth access_token |
| VK_ADS_CLIENT_ID | For token auto-refresh |
| VK_ADS_CLIENT_SECRET secret | For token auto-refresh |
| VK_ADS_REFRESH_TOKEN secret | For token auto-refresh |
Security check
- Creates campaigns and changes budgets, spending ad account money
- Can stop and delete campaigns
README in short
The Russian README explains the VK Ads v2 data model and eight tools with their API methods. It gives configs for Claude Desktop and Claude Code, an auth variable table and sample prompts. A separate section covers breaking changes from version 1.x, which used the legacy API. The server is part of the WWmcp series. MIT license.
FAQ
How do I pick an agency client's account?
There is no account_id parameter. Each client needs its own token issued via agency_client_credentials.
What if the token expires?
Set VK_ADS_CLIENT_ID, VK_ADS_CLIENT_SECRET and VK_ADS_REFRESH_TOKEN and the server refreshes it on a 401 response.
Related
Marketing Skills for AI agents
Marketing Skills for AI Agents
About fifty skills for CRO, copywriting, SEO, analytics, ads and launches, built for coding agents
A skill that strips AI writing tells from text using Wikipedia's list, without adding invented facts
Content skills: article illustrations, covers, infographics, comics, translation, URL to Markdown and social posting
The Chinese version of Humanizer: finds and removes signs of AI writing in Chinese text