Read recent Telegram messages
tg_messagesExport recent media messages from a Telegram chat by id or @username as compact {id,date,file,text} objects; use last_n or since_id for recent or incremental reads.
Instructions
Export recent media messages from one chat (by id or @username) and return them as compact {id, date, file, text} objects — newest range exported via tdl. Use last_n for 'the last N media messages', or since_id to fetch only messages after a known message id (incremental reads). Read-only.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"chat": "<chat>"
},
"name": "tg_messages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chat | Yes | Chat id or @username/domain (as shown by tg_chats) | |
| last_n | No | How many recent media messages to export (default 50, max 500) | |
| since_id | No | Only messages with id > since_id (overrides last_n; for incremental reads) | |
| with_text | No | Include message text content (default true) |