overpod/mcp-telegram

What's new

7 new Star Gifts tools, all gated behind MCP_TELEGRAM_ENABLE_STARS=1 (same environment variable as the existing stars tools).

| Tool | Description |
|------|-------------|
| telegram-get-available-star-gifts | List all available Star Gift catalog items: gift ID, cost in Stars, conversion value, limited-edition availability (remaining/total), and upgrade cost. |
| telegram-get-saved-star-gifts | List received Star Gifts for a user or chat (me for self). Supports pagination (offset/nextOffset), filter flags (excludeUnsaved, excludeSaved, excludeUnlimited, excludeLimited, excludeUnique), and sortByValue. Returns gift kind (regular/unique), from-peer, date, and upgrade eligibility. |
| telegram-save-star-gift | Show or hide a received gift on your profile. For personal gifts (received in DM) pass msgId. For chat/channel gifts pass chatId + savedId. Set unsave=true to hide, omit/false to show. |
| telegram-convert-star-gift | Convert a received gift into Stars (non-reversible — gift is removed from profile). Same addressing: msgId for personal, chatId+savedId for chat gifts. |
| telegram-get-stars-topup-options | List available Stars top-up tiers with star count, currency, price amount (in smallest currency units), and whether it is an extended/premium tier. |
| telegram-get-stars-subscriptions | List active Stars subscriptions for a peer (me for self or a bot/channel you own). Returns subscription ID, peer ID, renewal date, billing period in seconds, price in Stars, canceled status, and title. Pagination via offset. |
| telegram-change-stars-subscription | Cancel or restore a Stars subscription by ID. canceled=true to cancel before next renewal; canceled=false to restore a previously canceled subscription. |

Notes

• All tools require MCP_TELEGRAM_ENABLE_STARS=1 environment variable — they are not registered otherwise.
• save-star-gift and convert-star-gift use InputSavedStarGiftUser (msgId) for personal gifts and InputSavedStarGiftChat (peer + savedId) for chat/channel gifts.
• savedId fields are validated as numeric strings to prevent injection.