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
Medium risk
We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.
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
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.
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"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.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| VK_TOKEN required, secret | A long-lived VK bot token with message-sending rights, an alternative to the vk_token field in config.json. |
Security check
- Sends files and audio on behalf of the bot into a VK chat
- Stores the bot's long-lived token in the config
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.
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.
Related
A self-hosted knowledge base with block-level references and a built-in MCP server for connecting AI agents to your notes
A CLI for every Google Workspace API with JSON output and agent skills: Drive, Gmail, Calendar, Sheets and more
Local search over Markdown notes, docs and meeting transcripts: keywords, semantic search and reranking, with an MCP server
A task manager for AI-driven development: breaks a PRD into dependent tasks and guides the agent through them via MCP or CLI