VK MCP Server

MCP server for the VK API: profiles, walls, communities, photos, likes and stats, with confirmable post publishing

MCP serverHigh riskRussian stack

bulatko/vk-mcp-server

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 common

Limitations

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
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.

Marketing Skills for AI agents

Marketing Skills for AI Agents

Editors’ pick

About fifty skills for CRO, copywriting, SEO, analytics, ads and launches, built for coding agents

SkillLow risk50.2K
Editors’ pick

A skill that strips AI writing tells from text using Wikipedia's list, without adding invented facts

SkillLow risk48.1K

Content skills: article illustrations, covers, infographics, comics, translation, URL to Markdown and social posting

SkillHigh risk25.9K

The Chinese version of Humanizer: finds and removes signs of AI writing in Chinese text

SkillLow risk17.3K