VK Ads MCP server, read-only
vk-ads-mcp
A read-only MCP server for VK Ads: statistics, campaign structure, top objects by metric and CSV export
Medium risk
We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.
Why this level
- Accesses an ad account tied to the client's money, even though it only reads data
- The app token may carry broader rights than the server actually uses
Install
Manual install
Install and run vk-ads-mcp with your VK Ads OAuth app's client_id and client_secret, connect the server to your MCP client over stdio, and use the campaign_analysis prompt to review campaigns.
This is third-party code. Review the repository files before installing.
What it does
The server exposes the VK Ads (ads.vk.com) account structure: campaign, ad group and banner lists with filters and pagination, daily and summary statistics for a period, and top objects by a metric like CTR, CPC, CPA or spend. It automatically splits a period over 92 days or an id list over 50 into chunks to stay within API limits. A describe_fields tool discovers valid fields per object type from the API live, resources cover a metrics glossary and campaign hierarchy, and a campaign_analysis prompt gives a ready Russian-language walkthrough. It creates or changes nothing.
Who it is for. For performance marketers who need analytics on their own VK Ads account without the risk of accidentally changing anything.
Good fit when
- You want to ask an agent about campaign stats without granting write access
- You need to find the best and worst ads by a specific metric
- You need statistics exported to CSV for further analysis
Not a fit when
- You need to create or stop campaigns and ads, the server never changes them
- You need to work across several ad accounts at once, the server is built for one
Example request
Show the top 5 ad groups by CPA over the last two weeks, worst to bestLimitations
The server only reads data; a different tool is needed to launch or stop ads. It needs a VK Ads OAuth app's client_id and client_secret with access to your own account. The project is small, with no packaged PyPI releases per the repository.
How to disable. Remove the server from your MCP client configuration and stop the FastMCP process.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| client_id required, secret | The VK Ads OAuth application's client ID. |
| client_secret required, secret | The VK Ads OAuth application's client secret. |
Security check
- Accesses an ad account tied to the client's money, even though it only reads data
- The app token may carry broader rights than the server actually uses
README in short
The README describes the server as a read-only MCP wrapper over the new ads.vk.com account, for your own account only. It lists eight tools: campaign, ad group and banner listings, statistics with automatic splitting of long periods, top objects, field descriptions, CSV export and API quota status. It separately covers resources with a metrics glossary and object hierarchy, plus a campaign_analysis prompt following an analyze, rank, recommend structure.
FAQ
Can the server accidentally change a campaign?
No, the README states plainly it is read-only and creates or changes nothing.
What engine does VK Ads use under the hood?
The author notes it shares the engine with myTarget: ad_plans, ad_groups and banners are the shared object vocabulary of the new ads.vk.com account.
Related
A skill that strips AI writing tells from text using Wikipedia's list, without adding invented facts
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
SendPulse MCP server
SendPulse MCP
SendPulse's official remote MCP server: statistics, campaigns and user data through an agent chat
Yandex Direct MCP generated from a machine-readable schema
yandex-direct-mcp
An MCP server and CLI covering all 113 Yandex Direct API v5 methods generated from WSDL, exposing 9 read tools by default and writes only on demand