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
MCP server

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
All reasons and checks
Russian stack

igor1000rr/smm-mcp

Install

Services

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/smm-mcp

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended 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 wall

MCP

Transport
http
Authentication
API key

Environment variables

MCP_SECRET required, secret
The URL-path secret protecting access to the worker.
VK_TOKEN required, secret
The VK API access token.
TG_BOT_TOKEN required, 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.

Russian stack

A 4-tool MCP server that pulls VK wall posts, filters them by rules and publishes them to Telegram via the Bot API

MCP serverBroad access
Russian stack

Remote MCP server for VK communities: 50 tools, posts, comments, dialogs, photos, video and products, with writing off by default

MCP serverBroad access
Russian stack

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 serverBroad access
Russian stack

MCP server for the VK API: profiles, walls, communities, photos, likes and stats, with confirmable post publishing

MCP serverBroad access17Repository stars
Russian stack

A VK API MCP server for business: community shop, posts, ads, stats, messages and lead forms with write confirmation

MCP serverBroad access3Repository stars

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.

README badge

Report a problem