Log inSubmit server
Vk MCP Server logo

Vk MCP Server

by bulatko

Connects AI clients to VK for profile, community, wall, photo, feed, likes, and statistics operations.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Vk MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "bulatko-vk-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "vk-mcp-server"
      ],
      "env": {
        "VK_ACCESS_TOKEN": "YOUR_VALUE_HERE",
        "VK_TIMEOUT_MS": "YOUR_VALUE_HERE",
        "VK_API_BASE": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 19 tools correctly (1mo ago).

Overview

The bulatko/vk-mcp-server MCP server exposes VKontakte API operations for users, walls, communities, friends, newsfeed, photos, likes, and community statistics. It runs locally through npm, communicates with MCP clients over stdio, and uses a VK access token for API requests. Read and write tools support tasks such as researching public VK content, publishing community posts, and reviewing engagement data. Reach for it when an agent needs structured VK access rather than browser automation.

Use cases

  • Search VK users and communities
  • Read paginated VK walls
  • Publish and manage community posts
  • Upload photos for wall posts
  • Review community statistics and reactions

Key features

  • VK user and community search
  • Wall publishing and moderation
  • Photo upload and album browsing
  • Friends and newsfeed access
  • Community statistics and reactions
  • Structured paginated tool output

Tools19

What Vk MCP Server lets your agent do. Expand a tool for its parameters.

Verified live~2.8k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

7/7 checks healthy over the last 77d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · vk-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars16Stargazers on the source repository.
npm downloads1.6kPackage downloads in the last 30 days.
Last commit16d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed19Callable tools this server registers over MCP.
Directory activity6 viewsConfig copies, upvotes, and views on AllMCPs.

How Vk MCP Server works

What bulatko/vk-mcp-server MCP server does

The bulatko/vk-mcp-server MCP server connects an MCP-compatible client to VKontakte’s API. It provides 19 tools covering user lookup and search, wall reading and publishing, comments, post editing and deletion, community discovery and membership, friend lists, the token owner’s newsfeed, photo uploads and album browsing, likes, and community statistics.

The read tools can resolve users or communities by numeric ID or short name, inspect profile or community details, search by filters, and retrieve paginated results. Wall responses include engagement counters such as likes, reposts, comments, and views. Write operations include publishing posts, adding comments, editing posts, deleting posts, and uploading photos for later attachment.

How it works

The server translates MCP tool calls into VK API requests and returns structured, typed results. List operations report match counts and continuation offsets, allowing a client to request additional pages instead of treating the first response as complete. Prompts are also included for workflows such as community digests, engagement reports, audience snapshots, and community searches.

VK access depends on the token type and the account or community behind it. User tokens are needed for a user’s communities, friends, and personal newsfeed. Community statistics require the token owner to administer the target community. Posting, editing, and photo uploads require a community token with the relevant permissions. Public profile, wall, and community reads can use a service token or a token obtained through the VK ID login flow, but that login token does not provide the broader operations.

Hosts that support MCP Apps can render walls, communities, and profiles as cards. Other MCP clients still receive the same structured tool data without those visual renderings.

Setup and configuration

Install and run the package with npx -y vk-mcp-server. MCP client configuration supplies the access token through VK_ACCESS_TOKEN. The server can start and expose its tools without a token, but tool calls require one. The repository documents configurations for Claude Desktop and Claude Code, and also provides a one-click installation path for VS Code.

VK_TIMEOUT_MS controls the request timeout and defaults to 30,000 milliseconds. VK_API_BASE can replace the default VK API endpoint with a mirror or proxy. The --check option identifies the token type and tests which operations it can reach without invoking write methods. The --login <APP_ID> option starts the VK ID sign-in flow for a reading token.

Tools and capabilities

  • Resolve users and communities by ID or short name.
  • Search users and communities with filters and pagination.
  • Read, publish, edit, comment on, and delete wall posts.
  • Upload photos for wall attachments and list album photos.
  • List community members, joined communities, friends, and the token owner’s newsfeed.
  • Read reactions and community reach, visitor, and activity statistics.

Limitations and notes

VK’s permissions are not uniform across token types. A service token cannot call user methods, private profiles may deny access, and communities can hide their member lists. Friend retrieval only works when the target profile exposes its friends. Statistics are restricted to community administrators.

User tokens are rate-limited to a few requests per second. The server retries rate-limit responses with backoff up to three times, and it reports timeout, captcha, HTTP, and VK API errors with explanatory messages. Deleting a wall post is irreversible, while editing replaces the existing text or attachments rather than appending to them.

The bulatko/vk-mcp-server MCP server is therefore best suited to VK workflows where the required token permissions are known in advance. Use numeric negative owner IDs for community walls, positive IDs for personal walls, and positive group IDs when uploading community photos.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Vk MCP Server

Run `npx -y vk-mcp-server`, then configure your MCP client with the `VK_ACCESS_TOKEN` environment variable.

Yes. The README provides Claude Desktop configuration using `npx -y vk-mcp-server` and `VK_ACCESS_TOKEN`.

It requires a VK access token for tool calls. Token capabilities vary: community tokens support posting and uploads, while user tokens are needed for friends, joined communities, and the owner’s newsfeed.

Yes. `vk_wall_post` publishes posts, and related tools can add comments, edit posts, delete posts, and upload photos for attachments.

Related MCP servers

All in Social Media All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewVk MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/bulatko-vk-mcp-server?style=directory)](https://allmcps.com/mcp/bulatko-vk-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/bulatko-vk-mcp-server"><img src="https://allmcps.com/api/badge/bulatko-vk-mcp-server?style=directory" alt="Vk MCP Server on AllMCPs" /></a>