Telegram MCP server

What an agent can do on Telegram

• Post. create_post sends text to your Telegram connection now. Limit: 4,096 characters (1,024 when the post carries an image, because the text becomes the caption).
• Schedule and queue. The same tool takes scheduledFor for a set time, or queue for the connection's next free slot. set_connection_queue sets the weekly slots.
• Drafts. Save a draft for the user to review, then publish_draft sends it, or update_post edits it first.
• Image cards. render_image and draw_card make an image card in the connection's look, and upload_media stores your own picture. Telegram images: Up to 5 per post, png and jpeg only. Several images go out as one album.
• Threads. Yes, up to 24 replies under the head message. Send the follow-ups in the thread field of create_post.
• Delete. delete_post removes a draft, cancels a scheduled post, or takes a sent post down. Yes, within 48 hours of sending (the head message, its album and the replies).

Not available on Telegram: a first comment, metrics (No, the Bot API reports nothing back).

Example prompts

• post this to my Telegram channel: build 412 is live, changelog in the pinned message
• Queue this for my Telegram for the next free slot, then show me what is waiting.
• Save a draft for Telegram so I can review it first.

Set up your client

The server URL is https://api.yeetpost.com/api/v2/mcp. Step by step for: Claude, Cursor, Codex, n8n, Windsurf, VS Code. The tool list is on the MCP docs page.

FAQ

Can an AI agent post to Telegram?

Yes. Add the yeetpost MCP server to your AI client, connect Telegram once in the yeetpost console, and the agent posts to it with create_post.

How do I connect Telegram?

Create a bot with @BotFather, add it to your channel as an admin that can post (or to your group as a member), then paste the bot token in the yeetpost dashboard. The chat is detected for you.

What does posting to Telegram cost?

Posting to Telegram is free. Billing is per connected account: the first 2 are free.