Telegram Bot API
Official Telegram Bot API message-management profile. Create a bot with @BotFather, place the bot token in the documented URL form `https://api.telegram.org/bot<TOKEN>/<method>`, and grant the bot the required chat or channel permissions. The API supports receiving updates, sending messages, editing messages, and deleting messages; access is limited by bot membership, administrator rights, and Telegram method rules.
Connect this API to an AI agent Browse all specs
What you can do with Telegram Bot API via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| POST | /getUpdates |
get_telegram_updates | Get bot updates Method: POST Path: /getUpdates IMPORTANT: This function has 0 REQUIRED parameter(s) and 3 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Request Body: OPTIONAL: - offset: offset parameter from application/json - limit: limit parameter from application/json - timeout: timeout parameter from application/json |
| POST | /sendMessage |
send_telegram_message | Send a message Method: POST Path: /sendMessage IMPORTANT: This function has 2 REQUIRED parameter(s) and 1 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Request Body: REQUIRED: - chat_id: Unique chat ID or channel username. - text: Text content. OPTIONAL: - parse_mode: parse_mode parameter from application/json |
| POST | /editMessageText |
edit_telegram_message | Edit a message Method: POST Path: /editMessageText IMPORTANT: This function has 1 REQUIRED parameter(s) and 3 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Request Body: REQUIRED: - text: Text content. OPTIONAL: - chat_id: chat_id parameter from application/json - message_id: message_id parameter from application/json - inline_message_id: inline_message_id parameter from application/json |
| POST | /deleteMessage |
delete_telegram_message | Delete a message Method: POST Path: /deleteMessage IMPORTANT: This function has 2 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Request Body: REQUIRED: - chat_id: chat_id parameter from application/json - message_id: message_id parameter from application/json |
Usage guide
## Authentication Official Telegram Bot API message-management profile. Create a bot with @BotFather, place the bot token in the documented URL form `https://api.telegram.org/bot<TOKEN>/<method>`, and grant the bot the required chat or channel permissions. The API supports receiving updates, sending messages, editing messages, and deleting messages; access is limited by bot membership, administrator rights, and Telegram method rules. ## Endpoint coverage This listing contains 4 documented path(s) and 4 operation(s). Review each operation's required OAuth scope or token type before use. ## Official documentation [Telegram developer documentation](https://core.telegram.org/bots/api)
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “Telegram Bot API” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.