Skip to content

Conversation

@iqdoctor
Copy link
Contributor

@iqdoctor iqdoctor commented Oct 14, 2025

Add new list_topics() MCP tool to retrieve forum topics from Telegram supergroups with forum feature enabled.

Features:

  • Validates chat is a supergroup with forum enabled
  • Supports pagination via offset_topic parameter
  • Supports search filtering via search_query parameter
  • Returns comprehensive topic metadata:
    • Topic ID and title
    • Total messages and unread count
    • Status flags (closed, hidden)
    • Last activity timestamp
  • Proper error handling and logging

Documentation:

  • Added list_topics to README Messaging tools list

Uses Telethon's GetForumTopicsRequest API for reliable forum topic retrieval from supergroups.

Add new list_topics() MCP tool to retrieve forum topics from Telegram
supergroups with forum feature enabled.

Features:
- Validates chat is a supergroup with forum enabled
- Supports pagination via offset_topic parameter
- Supports search filtering via search_query parameter
- Returns comprehensive topic metadata:
  * Topic ID and title
  * Total messages and unread count
  * Status flags (closed, hidden)
  * Last activity timestamp
- Proper error handling and logging

Documentation:
- Added list_topics to README Messaging tools list
- Added complete code example with implementation
- Added example output showing typical usage

Uses Telethon's GetForumTopicsRequest API for reliable forum topic
retrieval from supergroups.
@iqdoctor
Copy link
Contributor Author

@chigwell Evgenii, new PR ready to review!

@chigwell chigwell merged commit e7995ae into chigwell:main Oct 16, 2025
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants