MCP Telegram
← Back to Quickstart

Telegram Stories in your AI

Stories that contacts and channels you follow have posted, viewer lists for the stories you posted, and tools to post, pin, edit and delete your own — all available as AI tools.

1

Read stories from your feed

Say: "Show me active stories from people I follow." The AI calls telegram-get-all-stories and returns compact metadata (id, date, expire date, caption, media type, counters) for each story currently in your feed. Pagination is supported — ask for more to load older items.

2

See who viewed your story

Say: "List viewers of my latest story." The AI calls telegram-get-story-views and returns viewers with their reaction emoji (if any) and view date, plus totals for views, forwards and reactions. Note: non-Premium accounts may not get a full viewer list, and very old stories may have lost their viewer data.

3

Post a new story

Upload an image or short video first (open mcp-telegram.com/my/upload, drop the file, copy the uploadId) or pass an https:// URL the cloud can fetch. Then say: "Post a new story to my profile from this uploadId." The AI calls telegram-send-story. Privacy rules (everyone / contacts / close friends) are passed explicitly.

4

Pin highlights or edit captions

Say: "Pin story 12345 to my profile." The AI calls telegram-toggle-story-pinned (up to 3 stories can be pinned). To edit a caption: "Change the caption of story 12345 to 'New caption'" — the AI calls telegram-edit-story. Replacing the media file is not supported in the cloud; post a fresh story instead.

Try these prompts

"Show me active stories from contacts, then read them aloud"

"Who viewed my last story? Group viewers by reaction emoji."

"List my pinned stories and ask if I want to unpin any"

Troubleshooting

Empty viewer list on my story

Two common causes: (1) Telegram only retains the full viewer list for a limited time and very old stories may have lost it; (2) some accounts (non-Premium) do not get the full list at all. The totals (viewsCount, reactionsCount) are still returned.

Can't change the media file in an existing story

telegram-edit-story can update caption and privacy rules, but the cloud explicitly refuses to replace the media file (it would require re-uploading bytes through filesystem). Delete the old story and post a fresh one instead.