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
- 1 ★ on the repository
- Last commit
- MIT
Extended access
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
- Works in
- Services
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.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- 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
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 bestMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
client_idrequired, secret- The VK Ads OAuth application's client ID.
client_secretrequired, secret- The VK Ads OAuth application's client secret.
Limitations
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.
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.
Discussion
No questions or reviews yet.
Related
All VK toolsVK Ads MCP server
VK Реклама MCP
An MCP server for VK Ads: campaigns, groups, banners, statistics and balance through chat, with in-chat account connection instead of manual OAuth
A VK Ads MCP server with a turnkey installer: 136 tools, VK community research and a skill for several agents at once
A VK Ads MCP server built on the myTarget API v2 with 49 to 55 tools: campaigns, remarketing, lookalikes, product feeds and agency access
Hardened VK Ads MCP
vk-ads-mcp
A hardened VK Ads MCP fork: read-only by default, mutations gated by VK_ADS_ENABLE_WRITES, and SSRF protection on file uploads
A VK API MCP server for business: community shop, posts, ads, stats, messages and lead forms with write confirmation
MCP server for the VK API: profiles, walls, communities, photos, likes and stats, with confirmable post publishing
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| VK Ads MCP server, read-only (this card) | no | API key | 1 | |
| VK Ads MCP All in One | no | API key | 0 | 136 tools |
| Hardened VK Ads MCP | no | API key | 0 | read-only by default, SSRF guard |
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.