Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TELEGRAM_BOT_TOKEN | Yes | Telegram Bot API token from @BotFather | |
| TELEGRAM_DEFAULT_CHAT_ID | No | Default chat ID for tool calls | |
| TELEGRAM_DEFAULT_THREAD_ID | No | Default topic/thread ID for forum supergroups |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| send_message | Send a text message to a Telegram chat. Supports Markdown and HTML formatting. If chat_id is omitted, sends to the default log group. |
| send_photo | Send a photo to a Telegram chat. Can send from URL or local file path. If chat_id is omitted, sends to the default log group. |
| send_document | Send a file/document to a Telegram chat. Can send from URL, file_id or local file path. If chat_id is omitted, sends to the default log group. |
| send_video | Send a video to a Telegram chat. Can send from URL or local file path. If chat_id is omitted, sends to the default log group. |
| send_audio | Send an audio file to a Telegram chat. Can send from URL or local file path. If chat_id is omitted, sends to the default log group. |
| send_voice | Send a voice message to a Telegram chat. Can send from URL or local file path. If chat_id is omitted, sends to the default log group. |
| send_animation | Send an animation (GIF) to a Telegram chat. Can send from URL or local file path. If chat_id is omitted, sends to the default log group. |
| send_video_note | Send a video note (round video message) to a Telegram chat. Can send from URL or local file path. If chat_id is omitted, sends to the default log group. |
| send_media_group | Send a group of photos or videos as an album. If chat_id is omitted, sends to the default log group. |
| send_location | Send a location point to a Telegram chat. If chat_id is omitted, sends to the default log group. |
| send_venue | Send a venue location to a Telegram chat. If chat_id is omitted, sends to the default log group. |
| send_contact | Send a contact to a chat. If chat_id is omitted, sends to the default log group. |
| send_poll | Send a poll to a Telegram chat. If chat_id is omitted, sends to the default log group. |
| send_dice | Send a dice roll animation to a chat. If chat_id is omitted, sends to the default log group. |
| send_sticker | Send a sticker to a Telegram chat. Can send from URL, file_id or local file path. If chat_id is omitted, sends to the default log group. |
| send_paid_media | Send paid media to a chat. |
| send_checklist | Send a checklist message to a chat. |
| send_message_draft | Send a draft message that can be updated progressively. |
| send_chat_action | Send a chat action (typing, upload_photo, etc.) to show the bot is doing something. |
| send_business_message | Send a text message on behalf of a business account. Requires business_connection_id. |
| edit_message | Edit a previously sent text message. If chat_id is omitted, targets the default log group. |
| edit_message_caption | Edit caption of a previously sent message with media. If chat_id is omitted, targets the default log group. |
| edit_message_media | Edit media content of a previously sent message. Pass a JSON string as media parameter with InputMedia object. |
| edit_message_reply_markup | Edit only the reply markup (inline keyboard) of a previously sent message. If chat_id is omitted, targets the default log group. |
| edit_message_live_location | Edit a live location message. The location must be live (sent with live_period). If chat_id is omitted, targets the default log group. |
| stop_message_live_location | Stop updating a live location message. If chat_id is omitted, targets the default log group. |
| edit_message_checklist | Edit a checklist message. |
| edit_business_message_text | Edit a text message sent on behalf of a business account. |
| edit_business_message_caption | Edit caption of a media message sent on behalf of a business account. |
| edit_business_message_media | Edit media content of a message sent on behalf of a business account. |
| forward_message | Forward a message from one chat to another. If chat_id is omitted, forwards to the default log group. |
| forward_messages | Forward multiple messages from one chat to another. |
| copy_message | Copy a message from one chat to another. Can copy any message type. If chat_id is omitted, copies to the default log group. |
| copy_messages | Copy multiple messages from one chat to another. |
| delete_message | Delete a message from a chat. Bot must have delete permissions. If chat_id is omitted, targets the default log group. |
| delete_messages | Delete multiple messages in a chat (up to 100 at once). |
| pin_message | Pin a message in a chat. Bot must have pin permissions. If chat_id is omitted, targets the default log group. |
| unpin_message | Unpin a message in a chat. If message_id is not specified, unpin the last pinned message. If chat_id is omitted, targets the default log group. |
| unpin_all_chat_messages | Unpin all messages in a chat. If chat_id is omitted, targets the default log group. |
| set_message_reaction | Set a reaction on a message. |
| get_file | Get information about a file stored on Telegram servers. Returns file path for downloading. |
| stop_poll | Stop a poll and mark it as closed. If chat_id is omitted, targets the default log group. |
| get_chat_info | Get info about a chat (title, type, members count, description, etc). If chat_id is omitted, returns info about the default log group. |
| get_chat_member | Get information about a member of a chat. If chat_id is omitted, targets the default log group. |
| get_chat_member_count | Get the number of members in a chat. If chat_id is omitted, targets the default log group. |
| get_chat_administrators | Get a list of administrators in a chat. If chat_id is omitted, targets the default log group. |
| leave_chat | Leave a chat. The bot will no longer receive updates from this chat. |
| set_chat_title | Set a new title for a chat. If chat_id is omitted, targets the default log group. |
| set_chat_description | Set a new description for a chat. If chat_id is omitted, targets the default log group. |
| set_chat_photo | Set a new profile photo for a chat. If chat_id is omitted, targets the default log group. |
| delete_chat_photo | Delete the chat profile photo. If chat_id is omitted, targets the default log group. |
| set_chat_permissions | Set default chat permissions for all members. If chat_id is omitted, targets the default log group. |
| set_chat_menu_button | Set the menu button for a private chat or all chats. |
| get_chat_menu_button | Get the current menu button for a private chat or default. |
| export_chat_invite_link | Export the primary invite link for a chat. If chat_id is omitted, targets the default log group. |
| create_chat_invite_link | Create a new invite link for a chat. If chat_id is omitted, targets the default log group. |
| edit_chat_invite_link | Edit an existing invite link for a chat. If chat_id is omitted, targets the default log group. |
| revoke_chat_invite_link | Revoke an invite link for a chat. If chat_id is omitted, targets the default log group. |
| create_chat_subscription_invite_link | Create a subscription invite link for a channel chat. |
| edit_chat_subscription_invite_link | Edit a subscription invite link. |
| ban_chat_member | Ban a user from a chat. If chat_id is omitted, targets the default log group. |
| unban_chat_member | Unban a previously banned user in a chat. If chat_id is omitted, targets the default log group. |
| restrict_chat_member | Restrict a user's permissions in a chat. If chat_id is omitted, targets the default log group. |
| promote_chat_member | Promote a user to admin in a chat. If chat_id is omitted, targets the default log group. |
| set_chat_administrator_custom_title | Set a custom title for an admin in a chat. If chat_id is omitted, targets the default log group. |
| set_chat_member_tag | Set a tag for a chat member. |
| ban_chat_sender_chat | Ban a channel chat in a supergroup or channel. The owner of the sender chat won't be able to send messages on behalf of their chat. |
| unban_chat_sender_chat | Unban a previously banned channel chat in a supergroup or channel. |
| approve_chat_join_request | Approve a user's join request to a chat. |
| decline_chat_join_request | Decline a user's join request to a chat. |
| verify_user | Verify a user on behalf of the bot. |
| verify_chat | Verify a chat on behalf of the bot. |
| remove_user_verification | Remove verification from a user. |
| remove_chat_verification | Remove verification from a chat. |
| approve_suggested_post | Approve a suggested post. |
| decline_suggested_post | Decline a suggested post. |
| unpin_all_general_forum_topic_messages | Unpin all messages in the General forum topic. |
| get_me | Get info about the bot (username, name, id). Use to verify the bot is working. |
| log_out | Log out the bot from Telegram Bot API. |
| close_bot | Close the bot instance (can be restarted later). |
| get_updates | Get recent incoming messages and updates. Returns latest messages sent to the bot. |
| set_my_commands | Set the bot's commands for the given scope. |
| delete_my_commands | Delete the bot's commands for the given scope. |
| get_my_commands | Get the current list of bot commands. |
| get_my_name | Get the current bot name. |
| set_my_name | Set the bot name (max 64 chars). Empty string removes the name. |
| get_my_description | Get the current bot description. |
| set_my_description | Set the bot description (max 512 chars). |
| get_my_short_description | Get the current bot short description. |
| set_my_short_description | Set the bot short description (max 120 chars). |
| set_my_default_administrator_rights | Set the bot's default administrator rights. |
| get_my_default_administrator_rights | Get the bot's default administrator rights. |
| get_user_chat_boosts | Get boosts added by a user to a chat. |
| get_business_connection | Get info about a business connection. |
| answer_callback_query | Answer a callback query from an inline button press. Must be called after receiving a callback_query update. |
| answer_inline_query | Answer an inline query with results. |
| answer_web_app_query | Answer a Web App query sent via a Web App integration. |
| set_passport_data_errors | Report errors in Telegram Passport data. |
| get_user_profile_photos | Get a user's profile pictures. |
| get_user_profile_audios | Get audios added to a user's profile. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |