# Telegram Dev

> Telegram Dev is a free MCP server for communication. Current Telegram Bot API and TON docs for coding agents, plus a bot-code checker. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI
- **Repository:** https://github.com/kay0k1/telegram-dev
- **MCP Registry name:** io.github.Kay0k1/telegram-dev
- **Categories:** [communication](https://ai-powered.com/categories/communication), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add telegram-dev -- uvx telegram-dev
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

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

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/telegram-dev
