Log inSubmit server
Vk MCP logo

Vk MCP

Connects AI clients to VK for wall posts, publishing, search, user and group data, messaging, friends, and community statistics.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Vk MCP

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": {
    "vk-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/vk-mcp"
      ],
      "env": {
        "VK_ACCESS_TOKEN": "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.

We couldn’t confirm it starts correctly

The install command started, but didn't respond the way we expected when we tried to talk to it.

npx -y @theyahia/vk-mcp

initialize succeeded but no response to tools/list.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 11d ago.

Overview

The vk-mcp MCP server connects MCP-compatible AI clients to the VK API for reading and publishing wall content, searching posts, and retrieving VK data. It exposes eight tools covering users, groups, friends, messages, and community statistics in addition to wall operations. The server uses a VK access token, calls VK API version 5.199, and retries selected rate-limit and server-error responses. Reach for it when an agent needs to manage or inspect VK content through either stdio or Streamable HTTP.

Use cases

  • Read recent posts from a VK user or community
  • Publish a post to a VK group wall
  • Search VK posts by keyword
  • Inspect community statistics for a date range
  • Send a VK message through an AI client

Key features

  • VK wall reading and publishing
  • Keyword search across VK posts
  • User, group, and friend lookup
  • VK message sending
  • Community statistics retrieval
  • stdio and Streamable HTTP transport

Security & health

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

ActiveLast checked 1d ago

Recent health check succeeded.

7/7 checks healthy over the last 45d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · @theyahia/vk-mcp (npm)

Adoption & maintenance

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

GitHub stars1Stargazers on the source repository.
npm downloads116Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Install checkInconclusiveStarted but did not complete the MCP handshake in our test.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Vk MCP works

What vk-mcp MCP server does

The vk-mcp MCP server gives an AI client access to selected VK API operations. It supports reading posts from a user or community wall, publishing a new wall entry, and searching the VK news feed by keywords. It also retrieves user details, community information, friend lists, direct-message sending, and community statistics.

The project is intended for conversational workflows where an agent needs to inspect VK data or perform an action on behalf of a user. Example tasks include finding posts about AI, checking a community’s recent activity, publishing content to a group, looking up a user or community, and requesting statistics for a defined number of days.

How it works

The server sends requests to VK’s API base URL, https://api.vk.com/method/, using API version 5.199. Authentication is provided through the VK_ACCESS_TOKEN environment variable. The access token must have the permissions required by the VK operations the client asks it to perform.

By default, vk-mcp MCP server communicates over stdio, which suits local desktop and editor integrations. It can also start in Streamable HTTP mode with the --http argument. The default HTTP port is 3000; a different port can be selected with the PORT environment variable.

Requests have a 10-second timeout. The server retries up to three times when VK returns a rate-limit response or a server-side 5xx error, using increasing delays between attempts.

Setup and configuration

Install and run the package through npm or npx using @theyahia/vk-mcp. Configure the MCP client with the server command and set VK_ACCESS_TOKEN to a token obtained through VK’s developer site.

For local stdio use, the command is:

Terminal
npx -y @theyahia/vk-mcp

Pass --http to use Streamable HTTP instead:

Terminal
npx -y @theyahia/vk-mcp --http

The README includes configuration examples for Claude Desktop, Claude Code, VS Code, and Cursor. It also documents installation through Smithery for Claude.

Tools and capabilities

The eight exposed tools map to these VK API methods:

  • get_wall uses wall.get to retrieve wall posts.
  • post_wall uses wall.post to publish a wall entry.
  • search_posts uses newsfeed.search for keyword-based post searches.
  • get_user uses users.get for user information.
  • get_groups uses groups.getById for community information.
  • get_friends uses friends.get to list a user’s friends.
  • send_message uses messages.send to send a message.
  • get_stats uses stats.get for community statistics.

The package also lists post-wall and group-stats prompt skills for publishing to a VK group and requesting group statistics over a specified number of days.

Limitations and notes

Actions depend on a valid access token and the permissions granted to it. HTTP mode is available, but the documented default transport is stdio. The project is released under the MIT license.

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

vk-mcp is an MCP server that connects AI clients to the VK API and exposes tools for wall posts, post publishing, keyword search, user and group lookup, friends, messages, and community statistics. It uses a VK access token and can run over stdio or Streamable HTTP.

Install it with npx by running `npx -y @theyahia/vk-mcp` and set `VK_ACCESS_TOKEN` in the MCP client configuration. The README also provides setup examples for Claude Desktop, Claude Code, VS Code, and Cursor.

Yes, vk-mcp works with Cursor through an MCP server configuration using the npx command and the `VK_ACCESS_TOKEN` environment variable. The README includes a Cursor-compatible JSON example.

Run vk-mcp with the `--http` argument, such as `npx -y @theyahia/vk-mcp --http`. Streamable HTTP uses port 3000 by default, or the port specified through the `PORT` environment variable.

vk-mcp supports eight operations: reading and publishing wall posts, searching posts, retrieving users and groups, listing friends, sending messages, and getting community statistics. These map to VK API methods including `wall.get`, `wall.post`, and `stats.get`.

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 AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/vk-mcp?style=directory)](https://allmcps.com/mcp/vk-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/vk-mcp"><img src="https://allmcps.com/api/badge/vk-mcp?style=directory" alt="Vk MCP on AllMCPs" /></a>