Skip to main content
Glama

set_watched_groups

Idempotent

Replace a telegram_mtproto userbot's watched-groups list — the chats it monitors. Requires the manage_settings permission. SET semantics: send the COMPLETE desired list every time (call list_watched_groups first and include existing entries you want to keep — omitting one removes it). Each entry needs a chatId (e.g. "-100…") or a public username/t.me link, and it must be a chat the account has JOINED: only joined chats can be watched. Watching a public chat without joining it is not available — an entry for a chat the account is not in is saved but never produces a message, so join the chat with the account first. The running userbot picks the change up within a few minutes, no restart. An empty list means "watch every joined chat" — NOT "watch nothing".

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
botIdNoThe telegram_mtproto bot. Omit when the application has exactly one userbot.
groupsYesThe complete replacement list. Empty array = watch every joined chat.
applicationIdNoApplication (workspace) id. Optional: an application-scoped key (app_...) defaults to its own application, but a personal key (usr_...) has no default and omitting it fails with MCP_APPLICATION_REQUIRED. Call list_applications to get the id.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • changedInput schema / properties / groups / items / properties / mode / description
      Previous value: -"\"joined\" (default) = passive updates for a chat the account is in; \"public_peek\" = poll a public chat without joining (max 10)."New value: +"Always \"joined\" (the default, may be omitted): a chat the account is a member of. No other mode exists."
    • changedInput schema / properties / groups / items / properties / mode / enum
      Previous value: -[
      -  "joined",
      -  "public_peek"
      -]New value: +[
      +  "joined"
      +]
    • changedInput schema / properties / groups / items / properties / username / description
      Previous value: -"Public @username or t.me link. Required for public_peek entries."New value: +"Public @username or t.me link of a chat the account is in. Supply this or chatId."
  2. Added

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.