VK MCP Server
MCP server for the VK API: profiles, walls, communities, photos, likes and stats, with confirmable post publishing
Install
{
"mcpServers": {
"vk": {
"command": "npx",
"args": ["-y", "vk-mcp-server"],
"env": {
"VK_ACCESS_TOKEN": "your_access_token_here"
}
}
}
}Project .mcp.json file. The same block works in claude_desktop_config.json.
This is third-party code. Review the repository files before installing.
What it does
The server gives the agent 19 VK tools: searching and reading profiles, wall posts, community info and members, photo albums, friends, newsfeed, likes and community stats. Write tools publish, edit and delete posts, add comments, upload photos and join communities, and they carry annotations so the client asks before running them. Ready prompts produce a community digest, an engagement report, an audience snapshot and a post draft in the community's tone. The --check command identifies the token type and probes which methods it can reach, and in clients with MCP Apps support walls and profiles render as cards.
Who it is for. For SMM specialists and marketers who run and analyze VK communities.
Good fit when
- You need to see which community posts drew the most reactions
- You need to draft and publish a post in your community
- You need to find and compare communities on a topic
Not a fit when
- You need private messages or mass mailings
- You need full stats and posting but only have a VK ID token
Example request
Make an engagement report for our community's last 30 posts and explain what the best ones have in commonLimitations
Capabilities depend on the token type. A VK ID token from --login reads only public profiles, walls and communities; posting, photos, friends, feed and stats return error 1051. Writing needs a community token with wall and photos rights. VK limits user tokens to a few requests per second and may bind them to an IP.
How to disable. Delete the vk block from your MCP client config or the extension in Claude Desktop, and revoke the token in community settings.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| VK_ACCESS_TOKEN required, secret | VK API token: community, user or service |
| VK_TIMEOUT_MS | Request timeout in milliseconds, 30000 by default |
| VK_API_BASE | API base URL, https://api.vk.com/method by default |
Security check
- Publishes, edits and deletes posts on behalf of a community or user
- Holds a non-expiring community token
README in short
The README covers one-click install via .mcpb for Claude Desktop and a VS Code button, running via npx and listing in the official MCP registry. It explains the three VK token types and what each can do, and gives Claude Desktop and Claude Code configs and environment variables. There is a table of common VK errors with fixes, a tool list marking write operations and ready prompts. MIT licensed.
FAQ
Which token should I use?
Posting needs a community token from Manage, API usage, Access tokens. For public reads a VK ID token or a service key is enough.
What does error 5 with subcode 1130 mean?
VK bound the token to the IP that issued it. Get the token on the machine running the server or use a community token.
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