vk-mcp-ru
A VK API MCP server for business: community shop, posts, ads, stats, messages and lead forms with write confirmation
Install
uvx vk-mcp-ruRuns the PyPI release.
This is third-party code. Review the repository files before installing.
What it does
The server is built from the official VK API schema and gives the agent a method catalog for business sections: communities, products and orders, wall posts, ads, statistics, messages, lead forms, photos, videos and documents. The agent searches for a method in plain words, reads its parameters and calls it. Reads run immediately, writes need confirmation, and irreversible actions such as deleting a product or banning a user need two. Keys are stored locally in ~/.ru-mcp/cabinets.json with no telemetry. Claude Desktop can install it from an .mcpb file without a terminal.
Who it is for. For SMM specialists, marketers and business owners on VK.
Good fit when
- You need community shop orders and products in a table
- You need community and post statistics for a period
- You need to triage unread messages and draft replies for approval
Not a fit when
- You need a personal profile rather than a community or app
- The agent must not post or message customers
Example request
Pull community stats for September and the top 5 posts by reachLimitations
Requires a VK app service key or a community token with market, messages, ads and stats rights; avoid extra scopes. The server offers a generic search-and-call mechanism rather than dedicated functions per scenario. The .mcpb install needs Python 3.10 or newer.
How to disable. Remove the server from the client config or the Claude Desktop extension, delete ~/.ru-mcp/cabinets.json and revoke the token in VK settings.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| VK_TOKEN required, secret | VK app service key or community token |
Security check
- Publishes posts, messages customers and changes ad campaigns
- Some methods are irreversible: deleting products or posts, bans
- The community token grants access to customer conversations
README in short
The README describes a VK API server whose catalog is built from the official VKCOM/vk-api-schema. There are two install paths: an .mcpb file for Claude Desktop or uvx with a config. It maps methods by section into read, write and irreversible, shows a chat example of searching and calling a method, and lists typical tasks. Security, the doctor command, sibling servers and the privacy policy are covered.
FAQ
Which token do I need?
An app service key from dev.vk.com or a community token scoped to the sections you need.
How do I check the setup?
uvx vk-mcp-ru doctor shows how many methods loaded and whether keys were found; --live makes one real read call.
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