VK Реклама MCP: Documentation
Updated:
Connection
npx -y @theyahia/vk-ads-mcp (stdio only). Auth: VK_ADS_TOKEN — an OAuth2 Bearer token for VK Ads API v2 (lasts ~1 day); optionally VK_ADS_CLIENT_ID + VK_ADS_CLIENT_SECRET + VK_ADS_REFRESH_TOKEN for auto-refresh via grant_type=refresh_token on 401 — without them you'll need to refresh the token manually.
Tools
8 tools: campaigns (list_campaigns — filterable by status, create_campaign — name/objective/budget, update_campaign — edits and activate/stop/delete), ad groups (list_ad_groups — with targeting, filterable by campaign), banners (list_ads — auto-paginated, create_ad — text blocks, links, content), get_statistics (views/clicks/spend by day) and get_account (account data and balance, needs the read_payments scope).
Agent flow
"Show active campaigns and spend for the last week", "create a campaign with a daily budget and add a banner", "pause the underperforming ad group".
Note
A community project (theYahia), not an official VK product. Stdio transport only. Version 4.0.0 (June 23, 2026) is a breaking release: v1's account_id parameters are gone, numeric statuses became strings, budget fields were renamed — re-check any workflow built on the old version.