Skip to content
MCP server

Telegram Dev

Current Telegram Bot API and TON docs for coding agents, plus a bot-code checker

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI
Runs
Locally
Version
0.9.0
Listing updated
today

Similar MCP servers

About Telegram Dev

Telegram Dev is a free MCP server for communication. It runs locally on your machine and is started by your AI client.

Telegram changes the Bot API every month or two, and models trained earlier tend to write code against retired fields. This project gives agents the current official pages to read before writing, and adds a command that checks existing bots.

The checker, telegram-dev check, scans a Python bot using aiogram, python-telegram-bot, pyTelegramBotAPI or raw HTTP calls and reports retired parameters and invalid values, such as a button style outside the documented list. It reads code without running it, so it does not follow variables or check required parameters. It also runs in CI as a GitHub Action with line annotations.

The documentation server searches Bot API, Mini Apps, MTProto, TDLib, TON Connect and Tolk docs from a local SQLite cache that refreshes automatically. The README notes it steers agents to Stars for digital goods in Mini Apps and TON for blockchain features. No Telegram account, bot token or API key is needed.

Install

Run in a terminal

claude mcp add telegram-dev -- uvx telegram-dev

Add to claude_desktop_config.json

{
  "mcpServers": {
    "telegram-dev": {
      "command": "uvx",
      "args": [
        "telegram-dev"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "telegram-dev": {
      "command": "uvx",
      "args": [
        "telegram-dev"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "telegram-dev": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "telegram-dev"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "telegram-dev": {
      "command": "uvx",
      "args": [
        "telegram-dev"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "telegram-dev": {
      "command": "uvx",
      "args": [
        "telegram-dev"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • TELEGRAM_KNOWLEDGE_DBPath to the SQLite documentation cache (default: the user cache directory)
  • TELEGRAM_DOC_AUTO_SYNCSet to 0 to disable the background refresh cycle

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

check_telegram_project
Checks a Python bot project for retired or invalid Bot API usage.
get_telegram_corpus_status
Reports the state of the documentation cache.
search_telegram_docs
Searches the official Telegram and TON docs.
get_telegram_document
Fetches a documentation page.

What it does

Bot code checker
Finds retired parameters and invalid values in Python bots.
Official docs search
Searches Telegram and TON docs across several areas.
Changelog by version
Reports changes between Bot API versions.
GitHub Action
Runs the checker on pull requests with annotations.
One-command install
Adds the server and skill to Claude, Codex or Cursor.

Good for

  • Upgrade a bot to a newer Bot API version
  • Stop an agent using retired parameters
  • Look up Mini Apps or TON Connect docs
  • Fail CI when a bot uses invalid Bot API values

Pricing

Free

More servers for the same service

Telegram Dev FAQ

Do I need a bot token?

No token, account or API key is needed.

Which libraries are checked?

aiogram, python-telegram-bot, pyTelegramBotAPI and raw HTTP calls.

Does it run my bot?

No, it reads code without running it.

How do I install it?

uvx telegram-dev install --agent claude, codex or cursor.

Is Telegram Dev free?

Yes. Telegram Dev is free to use.

How do I add Telegram Dev to Claude Code?

Run this command in your terminal: claude mcp add telegram-dev -- uvx telegram-dev

What are the best alternatives to Telegram Dev?

The closest alternatives to Telegram Dev are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers