Telegram MCP server for AI agents
Send, edit and delete messages and photos and read incoming updates through a Telegram bot.
- Auth
- Access token
- Tools
- 8
- Triggers
- 0
- Category
- Communication
Tools and triggers
Get the bot
TELEGRAM_GET_ME
Returns the bot's id, name and username.read-only
Send a message
TELEGRAM_SEND_MESSAGE
Sends a text message to a chat, group or channel the bot can write to.
Send a photo from a URL
TELEGRAM_SEND_PHOTO
Sends a picture to a chat. Telegram downloads it from the public URL (JPEG, PNG, GIF; up to 5 MB).
Send a file from a URL
TELEGRAM_SEND_DOCUMENT
Sends a file to a chat. Telegram downloads it from the public URL (up to 20 MB).
Get incoming updates
TELEGRAM_GET_UPDATES
Fetches new messages and events sent to the bot. Pass offset = last update_id + 1 to confirm earlier ones. Fails while a webhook is set.read-only
Get a chat
TELEGRAM_GET_CHAT
Returns a chat's type, title or name, description and pinned message.read-only
Edit a message
TELEGRAM_EDIT_MESSAGE_TEXT
Changes the text of a message the bot sent earlier.
Delete a message
TELEGRAM_DELETE_MESSAGE
Deletes a message. Bots can delete their own messages, and others' where they are admins, within 48 hours.destructive
Connect via MCP
Create an MCP server for Telegram in the dashboard, then add its URL to your client. This is the Claude Code command; the client guide has the others.
claude mcp add --transport http telegram \
"https://www.prompt-tm.com/mcp/<server id>?user_id=<your user>" \
--header "x-api-key: ptm_…"Connect via REST
Run a tool with one request. The response is { data, error, successful, log_id } for every tool.
curl -X POST https://www.prompt-tm.com/api/v3/tools/execute/TELEGRAM_GET_ME \
-H "x-api-key: $PROMPT_TM_KEY" -H "content-type: application/json" \
-d '{ "user_id": "alice", "arguments": {} }'
