vk — Claude Code MCP server: what it does, how to install
Bridges VK (VKontakte) into your AI coding setup: inspect walls, manage community inboxes, and post updates via standardized tools.
claude mcp add vk -e VK_ACCESS_TOKEN=<VK_ACCESS_TOKEN> -e VK_SERVICE_KEY=<VK_SERVICE_KEY> -- npx -y vk-mcp-serverWhat vk does
The server equips assistants with 25 tools for interacting with VKontakte data. It handles public walls, profile lookups, community dialogs, and publishing posts or stories under a group name. Every query returns typed schemas with explicit pagination hints, which keeps the model moving past the initial batch of posts.
A standalone community token cannot read walls because VK blocks those calls with error 27. Pairing your group token in VK_ACCESS_TOKEN with an application service key in VK_SERVICE_KEY routes reads and writes properly. Running npx vk-mcp-server --check inspects your credentials and reports allowed actions before you run workflows.
What it helps with
- reply to unread community inbox messages
- publish posts and stories to a managed community wall
- inspect public VK profiles and community pages
- generate audience snapshots and engagement digests
Example prompts for the agent
- Check unread messages in the community inbox and draft replies
- Publish this text as a new post to the community wall
- Summarize recent posts on the public community wall
How to install vk
Platform CLI
claude mcp add vk -e VK_ACCESS_TOKEN=<VK_ACCESS_TOKEN> -e VK_SERVICE_KEY=<VK_SERVICE_KEY> -- npx -y vk-mcp-serverReplace <…> with your own values
Platform CLI
codex mcp add vk --env VK_ACCESS_TOKEN=<VK_ACCESS_TOKEN> --env VK_SERVICE_KEY=<VK_SERVICE_KEY> -- npx -y vk-mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"vk": {
"command": "npx",
"args": [
"-y",
"vk-mcp-server"
],
"env": {
"VK_ACCESS_TOKEN": "<VK_ACCESS_TOKEN>",
"VK_SERVICE_KEY": "<VK_SERVICE_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"vk": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"vk-mcp-server"
],
"env": {
"VK_ACCESS_TOKEN": "<VK_ACCESS_TOKEN>",
"VK_SERVICE_KEY": "<VK_SERVICE_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e VK_ACCESS_TOKEN=<VK_ACCESS_TOKEN> -e VK_SERVICE_KEY=<VK_SERVICE_KEY> vk npx -y vk-mcp-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about vk
How to install vk in Claude Code?
Run claude mcp add vk -e VK_ACCESS_TOKEN=<VK_ACCESS_TOKEN> -e VK_SERVICE_KEY=<VK_SERVICE_KEY> -- npx -y vk-mcp-server. Replace the placeholders with your actual token and service key.
What does vk do?
It connects AI assistants to the VKontakte social network through 25 structured tools. The server handles wall reading, community messaging, and publishing group content.
Why does the server require both a token and a service key?
A community token allows publishing but fails wall reading requests with error 27. Passing VK_SERVICE_KEY handles the read operations while keeping write actions tied to the group token.
