Get bounded Telegram media
telegram_get_mediaFetches one anchored photo, PDF, audio item, or video thumbnail from a Telegram chat by chat_id and message_id, with preview and full size limits.
Instructions
Fetch one explicitly anchored photo, PDF document, audio item, or video thumbnail.
Preview transfers are capped at 2 MiB and full transfers at 12 MiB. Protected, self-destructing, secret, unsupported, and oversized media are rejected.
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_id": "<chat_id>",
"message_id": "<message_id>"
},
"name": "telegram_get_media"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chat_id | Yes | Exact native chat_id returned by telegram_list_chats or message/search results. Keep its sign; pass the ID, not a title, @username or Telegram link. | |
| quality | No | preview returns media up to 2 MiB; full returns supported full media up to 12 MiB. Video is thumbnail-only here; use telegram_download_file to save full video. | preview |
| message_id | Yes | Exact positive native TDLib message_id from a Telegram MCP result in the specified chat. Reuse the chat/message pair unchanged; do not convert Bot API IDs or IDs from Telegram URLs. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| width | No | ||
| height | No | ||
| chat_id | Yes | ||
| quality | Yes | ||
| file_name | No | ||
| mime_type | Yes | ||
| is_preview | No | ||
| media_kind | Yes | ||
| message_id | Yes | ||
| size_bytes | Yes | ||
| content_type | Yes | ||
| trust_boundary | No |