bulatko avatar

Vk

bulatko/vk-mcp-server

Connects Claude to VKontakte's social network through their v5.199 API with token authentication. You get read operations for profiles, wall posts, groups, friends, newsfeeds, and photos, plus write capabilities for posting to walls and adding comments. Also exposes community stats for admins. Built on the stdio transport with comprehensive test coverage. Useful if you're building social media workflows around VK or need to query Russian social network data programmatically. Installation is straightforward through npm or npx, and setup requires a VK access token from their developer portal with appropriate scopes.

tools
28
auth
Secret needed
transport
STDIO
env vars
2
last updated
Oct 10, 2026

Tools

28 tools

Public tool metadata for what this MCP can expose to an agent.

vk_users_getGet user profiles by IDs or screen names

Get user profiles by IDs or screen names

No parameter schema in public metadata yet.

vk_users_searchSearch users by name, city, age and other criteria

Search users by name, city, age and other criteria

No parameter schema in public metadata yet.

vk_wall_getGet posts from user/community wall

Get posts from user/community wall

No parameter schema in public metadata yet.

vk_wall_get_by_idGet specific posts by `{owner_id}_{post_id}`

Get specific posts by `{owner_id}_{post_id}`

No parameter schema in public metadata yet.

vk_wall_postPublish a new post

Publish a new post

No parameter schema in public metadata yet.

vk_wall_editEdit an existing post

Edit an existing post

No parameter schema in public metadata yet.

vk_wall_deleteDelete a post

Delete a post

No parameter schema in public metadata yet.

vk_wall_create_commentAdd comment to a post

Add comment to a post

No parameter schema in public metadata yet.

vk_groups_getGet user's communities list

Get user's communities list

No parameter schema in public metadata yet.

vk_groups_get_by_idGet community info by ID

Get community info by ID

No parameter schema in public metadata yet.

vk_groups_searchSearch communities by name and criteria

Search communities by name and criteria

No parameter schema in public metadata yet.

vk_groups_get_membersGet community members

Get community members

No parameter schema in public metadata yet.

vk_groups_joinJoin a community or request to join

Join a community or request to join

No parameter schema in public metadata yet.

vk_photos_getGet photos from albums

Get photos from albums

No parameter schema in public metadata yet.

vk_photos_upload_wallUpload a photo and get an attachment string for `vk_wall_post` — needs a full user token; VK refuses community tokens here

Upload a photo and get an attachment string for `vk_wall_post` — needs a full user token; VK refuses community tokens here

No parameter schema in public metadata yet.

vk_stories_post_photoPublish a photo story, personal or on behalf of a community

Publish a photo story, personal or on behalf of a community

No parameter schema in public metadata yet.

vk_stories_post_videoPublish a video story, personal or on behalf of a community

Publish a video story, personal or on behalf of a community

No parameter schema in public metadata yet.

vk_messages_get_conversationsList the inbox, newest first; `filter: "unread"` shows what waits for a reply

List the inbox, newest first; `filter: "unread"` shows what waits for a reply

No parameter schema in public metadata yet.

vk_messages_get_historyRead one conversation

Read one conversation

No parameter schema in public metadata yet.

vk_messages_sendReply as the community — reaches a real person, so clients should ask first

Reply as the community — reaches a real person, so clients should ask first

No parameter schema in public metadata yet.

vk_messages_mark_as_readMark a conversation as read

Mark a conversation as read

No parameter schema in public metadata yet.

vk_events_listenStart receiving new comments (text and ID), likes, posts and reposts, joins and leaves, messages

Start receiving new comments (text and ID), likes, posts and reposts, joins and leaves, messages

No parameter schema in public metadata yet.

vk_events_getRead them by cursor; `wait` holds up to 25 s for the next one, so an agent can answer each new comment in a loop

Read them by cursor; `wait` holds up to 25 s for the next one, so an agent can answer each new comment in a loop

No parameter schema in public metadata yet.

vk_friends_getGet user's friends list

Get user's friends list

No parameter schema in public metadata yet.

vk_newsfeed_getGet user's newsfeed

Get user's newsfeed

No parameter schema in public metadata yet.

vk_likes_getGet users who liked an object, with reaction counts

Get users who liked an object, with reaction counts

No parameter schema in public metadata yet.

vk_stats_getGet community statistics (admin only)

Get community statistics (admin only)

No parameter schema in public metadata yet.

vk_token_infoWhich token is connected, which tools work with it, and what would open the rest

Which token is connected, which tools work with it, and what would open the rest

No parameter schema in public metadata yet.

Sponsors

Configuration

VK_ACCESS_TOKENsecret

The token tools act with. To post, use a community token: Manage -> API usage -> Access tokens -> Create token (wall, photos, stories, messages, manage) — no app needed, tied to neither a browser nor an IP. It posts, comments and publishes stories, but VK refuses it wall reads; s

VK_SERVICE_KEYsecret

Optional service key from your VK app's settings page. Reads public profiles and walls; reads the access token is refused are made with it. Never used for writes.

Readme

VK MCP Server

VK Logo

npm version npm downloads CI license

Model Context Protocol (MCP) server for VK (VKontakte) social network API

English · Русский · Сайт (RU)

Enables AI assistants like Claude to interact with VK through a standardized interface.


View the full README on GitHub

Details

Repository
github.com/bulatko/vk-mcp-server
Package
vk-mcp-server
Transport
STDIO
Auth
Required
Registry
MCP registry, active