search
Find cited messages across allowed Telegram chats by keywords, sender, chat, date, or media, returning hits with context and tg:// citations.
Instructions
Find messages in the owner's allowed Telegram chats: hits ('>') with sender, time, context around them and tg:// citations, in one call.
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": {
"query": "<query>"
},
"name": "search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| from | No | Sender name fragment, user id, or 'me'. | |
| chats | No | Id, title fragment, or a list. Default: all allowed. | |
| limit | No | Max hits (default 10). | |
| media | No | ||
| query | Yes | Words (all must match, then any); a | b = either (synonyms, other languages); "exact phrase"; -word excludes. | |
| since | No | ISO, 7d, 24h, today, yesterday (local). | |
| until | No | ||
| budget | No | Max output tokens. | |
| context | No | Messages around each hit (default 2, max 8). |