> ## Documentation index
> Fetch the complete documentation index at: https://tgcloud.docs7.io/llms.txt
> Ask it with GET https://tgcloud.docs7.io/ask?q=<keywords or question>. Short keywords rank best.
> Use these to discover all available pages before exploring further.

# tgcloud-mcp

> MCP server for Telegram serverless bots (@tgcloud)

# tgcloud-mcp

[Русский](index.ru) · [中文](index.zh) · [العربية](index.ar) · [Deutsch](index.de) · [Français](index.fr)

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](https://agent-plugins.org) for Codex, Cursor, Copilot, Kiro, and VS Code.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart.en">
    From a CLI access token to a live bot in one dialogue
  </Card>
  <Card title="Install" icon="download" href="/installation.en">
    npm, curl | bash, Docker, or a manual client config
  </Card>
  <Card title="16 tools" icon="list" href="/tools.en">
    Scaffold, deploy, migrations, and webhooks
  </Card>
  <Card title="Resources" icon="book" href="/resources.en">
    tgcloud://docs/* — layout, SDK, CLI, limits
  </Card>
  <Card title="Security" icon="shield" href="/security.en">
    confirm: true, masked tokens, unofficial status
  </Card>
  <Card title="Cookbook" icon="utensils" href="/cookbook.en">
    A bot with a database, buttons, and a Mini App
  </Card>
</CardGroup>

## 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

```bash
npm install -g tgcloud-mcp && tgcloud-mcp setup
```

Next: [Installation](installation.en) → [Quickstart](quickstart.en) →
[Cookbook](cookbook.en).