VK and Telegram MCP server on Cloudflare Workers
smm-mcp
A Cloudflare Workers MCP server combining the VK API and Telegram Bot API: community stats, the wall, members, posts and broadcasts
- 0 ★ on the repository
- Last commit
Extended access
Why this level
- It can send messages via the Telegram Bot API as the bot
- VK and Telegram tokens are stored as worker secrets and are accessible to the server code
Install
- Works in
- Services
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/smm-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- It can send messages via the Telegram Bot API as the bot
- VK and Telegram tokens are stored as worker secrets and are accessible to the server code
This is third-party code. Review the repository files before installing.
What it does
The server hand-implements MCP protocol version 2025-06-18 on Cloudflare Workers with no ready-made SDK, providing tools for both platforms at once: VK community statistics, wall posts, member lists via the VK API, and sending messages and posts via the Telegram Bot API. It deploys as a worker and answers at an address like https://<worker>.workers.dev/<MCP_SECRET>/mcp, where the secret in the path acts as simple access protection.
Who it is for. For SMM specialists who run a VK community and a Telegram channel at once and want a single entry point for an agent.
Good fit when
- You need one server for both VK and Telegram instead of two separate ones
- You need a serverless deploy on Cloudflare Workers with no hosting of your own
- Protection via a path secret instead of full authorization works for you
Not a fit when
- You need to publish posts to a VK community: the code mostly implements reads (stats, wall, members)
- You need stronger protection than a secret in the worker's URL path
- You have no Cloudflare account to deploy the worker
Example request
Show the statistics for the VK community apiclub and the latest posts from its wallMCP
- Transport
- http
- Authentication
- API key
Environment variables
MCP_SECRETrequired, secret- The URL-path secret protecting access to the worker.
VK_TOKENrequired, secret- The VK API access token.
TG_BOT_TOKENrequired, secret- The Telegram bot token from @BotFather.
Limitations
The project is small, seven files, and the MCP protocol is hand-implemented with no official SDK, which raises the risk of incompatibility as the spec evolves. Protection relies on a secret in the URL path, simpler than a header token and notably weaker than full authorization. The VK part of the README and code focuses on reading data (stats, wall, members); post publishing is not clearly described.
How to disable. Delete the worker from Cloudflare or remove it from your MCP client configuration.
FAQ
Is an official MCP SDK required?
No, the protocol is hand-implemented directly in src/index.js on Cloudflare Workers.
How is the server address protected?
With the MCP_SECRET secret directly in the URL path, rather than a header token.
Discussion
No questions or reviews yet.
Related
All VK toolsVK 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
vk-mcp (alexfisenkov)
vk-mcp
Remote MCP server for VK communities: 50 tools, posts, comments, dialogs, photos, video and products, with writing off by default
A remote MCP server on Cloudflare Workers that combines Yandex Direct and VK Ads in one connector
mcp-vkontakte (ailenreiko1977-tech)
mcp-vkontakte
MCP for VK on your own server: a VK API method catalog, reading walls and communities, community comparison and writes only after a human approves
MCP server for the VK API: profiles, walls, communities, photos, likes and stats, with confirmable post publishing
A VK API MCP server for business: community shop, posts, ads, stats, messages and lead forms with write confirmation
README in short
The README is short and states this is a social-media MCP combine on Cloudflare Workers, combining the VK API and Telegram Bot API, with a connection address like /<MCP_SECRET>/mcp and three secrets: MCP_SECRET, VK_TOKEN and TG_BOT_TOKEN. The code in src/index.js describes the tools in more detail than the README: community statistics, wall posts and members for VK.