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

MCP serverRussian stack

igor1000rr/smm-mcpAuthor:igor1000rr

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/smm-mcp

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

Assembled automatically, review before installing.

Run in a terminal

claude mcp add --transport http smm-mcp 'https://smm-mcp.<ACCOUNT value>.workers.dev/<your MCP_SECRET>/mcp'

Or add to the file .mcp.json, in the project

{
  "mcpServers": {
    "smm-mcp": {
      "type": "http",
      "url": "https://smm-mcp.<ACCOUNT value>.workers.dev/<your MCP_SECRET>/mcp"
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

ACCOUNTrequired: Cloudflare account for workers deployment
MCP_SECRETsecret, required: Secret path token for MCP connector
VK_TOKENsecret, required: VK API token
TG_BOT_TOKENsecret, required: Telegram bot token

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Install in Cursor

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Add to the file ~/.cursor/mcp.json, for all projects

{
  "mcpServers": {
    "smm-mcp": {
      "url": "https://smm-mcp.<ACCOUNT value>.workers.dev/<your MCP_SECRET>/mcp"
    }
  }
}

If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.

Keys and settings

ACCOUNTrequired: Cloudflare account for workers deployment
MCP_SECRETsecret, required: Secret path token for MCP connector
VK_TOKENsecret, required: VK API token
TG_BOT_TOKENsecret, required: Telegram bot token

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Install in VS Code

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Run in a terminal

code --add-mcp '{"name":"smm-mcp","type":"http","url":"https://smm-mcp.<ACCOUNT value>.workers.dev/<your MCP_SECRET>/mcp"}'

Or add to the file .vscode/mcp.json, in the project

{
  "servers": {
    "smm-mcp": {
      "type": "http",
      "url": "https://smm-mcp.<ACCOUNT value>.workers.dev/<your MCP_SECRET>/mcp"
    }
  }
}

If the file already exists, add the server inside the servers key.

Keys and settings

ACCOUNTrequired: Cloudflare account for workers deployment
MCP_SECRETsecret, required: Secret path token for MCP connector
VK_TOKENsecret, required: VK API token
TG_BOT_TOKENsecret, required: Telegram bot token

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

codex mcp add smm-mcp --url 'https://smm-mcp.<ACCOUNT value>.workers.dev/<your MCP_SECRET>/mcp'

Or add to the file ~/.codex/config.toml, for all projects

[mcp_servers.smm-mcp]
url = "https://smm-mcp.<ACCOUNT value>.workers.dev/<your MCP_SECRET>/mcp"

If the file already exists, append the block to the end.

Keys and settings

ACCOUNTrequired: Cloudflare account for workers deployment
MCP_SECRETsecret, required: Secret path token for MCP connector
VK_TOKENsecret, required: VK API token
TG_BOT_TOKENsecret, required: Telegram bot token

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

gemini mcp add -s user -t http smm-mcp 'https://smm-mcp.<ACCOUNT value>.workers.dev/<your MCP_SECRET>/mcp'

Or add to the file ~/.gemini/settings.json, for all projects

{
  "mcpServers": {
    "smm-mcp": {
      "httpUrl": "https://smm-mcp.<ACCOUNT value>.workers.dev/<your MCP_SECRET>/mcp"
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

ACCOUNTrequired: Cloudflare account for workers deployment
MCP_SECRETsecret, required: Secret path token for MCP connector
VK_TOKENsecret, required: VK API token
TG_BOT_TOKENsecret, required: Telegram bot token

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/devin/mcp_config.json, for all projects

{
  "mcpServers": {
    "smm-mcp": {
      "serverUrl": "https://smm-mcp.<ACCOUNT value>.workers.dev/<your MCP_SECRET>/mcp"
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.

Keys and settings

ACCOUNTrequired: Cloudflare account for workers deployment
MCP_SECRETsecret, required: Secret path token for MCP connector
VK_TOKENsecret, required: VK API token
TG_BOT_TOKENsecret, required: Telegram bot token

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Formerly Windsurf.

Add to the file cline_mcp_settings.json, for all projects

{
  "mcpServers": {
    "smm-mcp": {
      "type": "streamableHttp",
      "url": "https://smm-mcp.<ACCOUNT value>.workers.dev/<your MCP_SECRET>/mcp"
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.

Keys and settings

ACCOUNTrequired: Cloudflare account for workers deployment
MCP_SECRETsecret, required: Secret path token for MCP connector
VK_TOKENsecret, required: VK API token
TG_BOT_TOKENsecret, required: Telegram bot token

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .roo/mcp.json, in the project

{
  "mcpServers": {
    "smm-mcp": {
      "type": "streamable-http",
      "url": "https://smm-mcp.<ACCOUNT value>.workers.dev/<your MCP_SECRET>/mcp"
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

ACCOUNTrequired: Cloudflare account for workers deployment
MCP_SECRETsecret, required: Secret path token for MCP connector
VK_TOKENsecret, required: VK API token
TG_BOT_TOKENsecret, required: Telegram bot token

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

A fork of Roo Code, same .roo folders.

Add to the file opencode.json, in the project

{
  "mcp": {
    "smm-mcp": {
      "type": "remote",
      "url": "https://smm-mcp.<ACCOUNT value>.workers.dev/<your MCP_SECRET>/mcp"
    }
  }
}

If the file already exists, add the server inside the mcp key.

Keys and settings

ACCOUNTrequired: Cloudflare account for workers deployment
MCP_SECRETsecret, required: Secret path token for MCP connector
VK_TOKENsecret, required: VK API token
TG_BOT_TOKENsecret, required: Telegram bot token

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/zed/settings.json, for all projects

{
  "context_servers": {
    "smm-mcp": {
      "url": "https://smm-mcp.<ACCOUNT value>.workers.dev/<your MCP_SECRET>/mcp"
    }
  }
}

If the file already exists, add the server inside the context_servers key.

Keys and settings

ACCOUNTrequired: Cloudflare account for workers deployment
MCP_SECRETsecret, required: Secret path token for MCP connector
VK_TOKENsecret, required: VK API token
TG_BOT_TOKENsecret, required: Telegram bot token

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Checked against the repository on Sep 25, 2026, commit 357f973.

Text for your agent

Deploy the worker with wrangler deploy, set the MCP_SECRET, VK_TOKEN and TG_BOT_TOKEN secrets, and connect your MCP client to https://<worker>.workers.dev/<MCP_SECRET>/mcp.

Other ways from the author

wrangler deploy

Deploying the Cloudflare worker after configuring the MCP_SECRET, VK_TOKEN and TG_BOT_TOKEN secrets.

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

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.

MCP

Transport: http
Authentication: API key

Environment variables
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.

Security check

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

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.

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.

Humanizer

Editors’ pick

A skill that strips AI writing tells from text using Wikipedia's list, without adding invented facts

SkillLow riskNo VPN needed52.7K

Marketing Skills for AI agents

Marketing Skills for AI Agents

Editors’ pick

About fifty skills for CRO, copywriting, SEO, analytics, ads and launches, built for coding agents

SkillLow risk51.8K

SendPulse MCP server

SendPulse MCP

Official

SendPulse's official remote MCP server: statistics, campaigns and user data through an agent chat

MCP serverHigh riskRussian stack1

Yandex Direct MCP generated from a machine-readable schema

yandex-direct-mcp

Editors’ pick

An MCP server and CLI covering all 113 Yandex Direct API v5 methods generated from WSDL, exposing 9 read tools by default and writes only on demand

MCP serverHigh riskRussian stackNo VPN needed1

Install

What it does

Good fit when

Not a fit when

Example request

Limitations

MCP

Security check

README in short

FAQ

Related

Humanizer

Marketing Skills for AI agents

SendPulse MCP server

Yandex Direct MCP generated from a machine-readable schema