MCP for sending files to a VK bot
mcp-vk-files
A small Go MCP server that sends files and audio messages to VK Messenger via a long-lived VK bot token
- 0 ★ on the repository
- Last commit
Extended access
Why this level
- Sends files and audio on behalf of the bot into a VK chat
- Stores the bot's long-lived token in the config
Install
- Works in
- Services
Manual install
go build -o mcp-vk-files . && ./mcp-vk-files mcpBuild the binary and run the MCP server; config is read from config.json alongside it.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Sends files and audio on behalf of the bot into a VK chat
- Stores the bot's long-lived token in the config
This is third-party code. Review the repository files before installing.
What it does
The server gives an agent two tools: send_file attaches a file as a document to a VK chat, and send_audio sends an audio file as an audio message using VK's audio_message attachment type so it plays back in VK Messenger instead of showing as a plain file. The recipient can be preset in the config under two named keys (typically a main and a fallback chat) or passed as an arbitrary numeric id in the call itself. The server builds into a single Go binary and runs locally over stdio.
Who it is for. For people who want an agent to send finished files or voice messages into a specific VK chat.
Good fit when
- You want an agent to deliver a generated report or file into a VK chat
- You need audio sent as a playable voice message rather than a plain file
- You want a small server with minimal scope, just sending files
Not a fit when
- You need text messages, reading a chat or bot management, the server only sends files
- You need the VK wall, community management or ads, there are no tools for that
Example request
Send the file report.pdf to the default chat with the caption "Weekly report"MCP
- Transport
- stdio
- Authentication
- API key
Environment variables
VK_TOKENrequired, secret- A long-lived VK bot token with message-sending rights, an alternative to the vk_token field in config.json.
Limitations
It needs a VK bot token with message-sending rights and a known recipient peer_id. The project is very small, has no releases, and the README does not document file size limits or VK API error handling.
How to disable. Remove the server from your MCP client configuration and revoke the bot's long-lived token in the VK community settings.
FAQ
How do I find a chat's peer_id?
The README does not explain this; the id must be obtained separately, for example via the VK API or your own bot.
How does send_audio differ from send_file for audio?
send_audio uploads via VK's audio_message attachment type, so it shows up as a playable audio clip rather than a plain document attachment.
Discussion
No questions or reviews yet.
Related
All VK toolsvk-mcp (alexfisenkov)
vk-mcp
Remote MCP server for VK communities: 50 tools, posts, comments, dialogs, photos, video and products, with writing off by default
full MCP for VK API
full-vk-mcp
MCP server auto-generated from the VK API schema: over 180 tools with filters by read, write, money modes and API sections
MCP server for the VK API: profiles, walls, communities, photos, likes and stats, with confirmable post publishing
VK to Telegram bridge MCP
vk-tg-bridge
A 4-tool MCP server that pulls VK wall posts, filters them by rules and publishes them to Telegram via the Bot API
A VK API MCP server for business: community shop, posts, ads, stats, messages and lead forms with write confirmation
VK community management MCP
vk-community-mcp
An MCP server for running a VKontakte community: settings, wall, cover and avatar, photo albums, market items and monitoring in 28 tools
README in short
The README is short and to the point: it covers configuration via config.json or the VK_TOKEN variable, a config field table (bot token, default and fallback recipient id), Go build commands, and two tools with their parameters. It states an MIT license.