Skip to main content
tgcloud-mcp

tgcloud-mcp#

Русский · 中文 · العربية · Deutsch · Français

An MCP server that teaches an AI assistant to manage Telegram serverless bots (the @tgcloud platform, core.telegram.org/bots/serverless): project scaffolding, bot linking, handlers and endpoints, deploys, DB migrations, webhooks.

Works with any MCP client: opencode, Claude Code, Cursor, Claude Desktop, VS Code (Copilot), Windsurf, Zed. The same server and skill also ship as one Agent Plugin for Codex, Cursor, Copilot, Kiro, and VS Code.

Quickstart

From a CLI access token to a live bot in one dialogue

Install

npm, curl | bash, Docker, or a manual client config

16 tools

Scaffold, deploy, migrations, and webhooks

Resources

tgcloud://docs/* — layout, SDK, CLI, limits

Security

confirm: true, masked tokens, unofficial status

Cookbook

A bot with a database, buttons, and a Mini App

Features#

  • 16 tools — the tgcloud CLI, including upgrade (pre-0.2.0 layout) and deploy (build, then push)
  • Resources tgcloud://docs/* — built-in platform reference, in English, aligned with the official docs
  • Guardrails — destructive operations require confirm: true; tokens are masked
  • Multi-project — every tool takes an absolute project_dir

Quick start#

Next: Installation → Quickstart → Cookbook.