The Telegram account this session is signed in as. Call it first when it matters whose messages you are about to read or send.

Turn a @username, phone number or numeric id into a chat you can act on. Use it before sending to someone you only know by handle.

Recent conversations, newest first. Returns a compact row per chat: id, name, kind, unread count and a short preview of the last message. Use fields to cut it down further.

Details of a single chat: name, kind, username, member count and description where the chat has them.

Messages from one chat, newest first. Bodies are truncated to a preview unless full is set, because a long chat returned whole is mostly wasted context.

Search message text, either inside one chat or across the whole account when no peer is given.

Send a message to a chat. This is visible to the recipient immediately and posts as you, so only send what was actually asked for.

Change the text of a message you sent. Telegram marks it edited.

Delete one or more messages. This cannot be undone, and with revoke it removes them for everyone in the chat, not only for you.

Clear the unread count on a chat.

Forward messages from one chat into another.

Save the photo, video, document or voice note attached to a message, and return the local path. The file is written to disk rather than returned inline, because a base64 image in a tool result is enormous and unreadable.

Send a local file to a chat, with an optional caption.