Telegram Dev
Current Telegram Bot API and TON docs for coding agents, plus a bot-code checker
- 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-devAdd to claude_desktop_config.json
{
"mcpServers": {
"telegram-dev": {
"command": "uvx",
"args": [
"telegram-dev"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"telegram-dev": {
"command": "uvx",
"args": [
"telegram-dev"
]
}
}
}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.


