Search messages globally
search_messages_globallyRead-onlyIdempotent
Search across all Telegram chats simultaneously using comma-separated terms, with optional filters for date range, chat type, and public username to find relevant messages.
Instructions
Search all Telegram chats at once (not scoped to one chat). Comma-separated query terms; optional filters by date, chat kind, and public username. Success: message list and metadata dict. Global search ignores include_total_count. Full documentation: https://github.com/leshchenko1979/fast-mcp-telegram/blob/main/docs/Tools-Reference.md
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search terms, comma-separated for multiple terms (OR-style global search). Required. | |
| limit | No | Maximum messages to return (recommended 50 or less). | |
| min_date | No | Inclusive minimum date filter (ISO 8601 date or datetime). Omit for no lower bound. | |
| max_date | No | Inclusive maximum date filter (ISO 8601 date or datetime). Omit for no upper bound. | |
| chat_type | No | Comma-separated chat kinds: private, bot, group, channel. Case-insensitive; extra spaces allowed. | |
| public | No | If true, prefer chats with a public username; if false, without. Does not apply to private DMs. Omit to skip this filter. | |
| auto_expand_batches | No | Extra search batches to run when filters narrow results. Higher values may return more matches at the cost of latency. | |
| include_total_count | No | If true, response may include total_count where supported (per-chat search; ignored for global search). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | ||
| error | No | ||
| operation | No | ||
| code | No | ||
| params | No | ||
| exception | No | ||
| action | No | ||
| error_code | No | ||
| messages | No | ||
| has_more | No | ||
| total_count | No | ||
| _warning | No |