posterly

MCP connector

Telegram MCP server

Send Telegram posts, polls, and albums to a channel or group from Claude or ChatGPT.

This is the posterly MCP server, used for Telegram. The same connection works from Claude, ChatGPT, Cursor, and other MCP clients. It is not a separate Telegram-only download.

Get Starter + API · $10/moHow to connect the MCP server

What you can do on Telegram

Telegram posts go to a channel or group through a bot you control. Your AI client can send text up to 4,096 characters, images, videos, GIFs, and albums of up to 10 items, with rich caption formatting. A caption on media is capped at 1,024 characters.

Telegram has native features the assistant can use. A poll takes a question and 2 to 10 options, can allow multiple answers, and cannot include media. Up to 3 inline buttons can link out to a page, though albums cannot carry buttons. Videos can have a custom cover and a start time, and a still image plus a short video can be sent together as a live photo.

To connect, create a bot with BotFather and give posterly its token along with the chat ID of the channel or group you want to post to. The connection is credential based, so there is no browser sign-in. The MCP server does not read Telegram analytics.

  • Text posts
  • Images
  • Video
  • Multi-image
  • Custom cover
  • Polls

Post types: text, image, video, media group. Analytics are not read for this platform.

Tools

These are the tools your AI client uses for Telegram. Ask it to call list_platforms with view=schema and the account_id before it sets anything specific to Telegram.

Account and connection

  • whoamiWho am I

  • list_accountsConnected accounts

  • list_platformsPlatforms

  • create_connect_sessionStart a connect session

  • connect_accountConnect with credentials

Posts

  • validate_postValidate a post

  • create_postCreate a post

    Show the caption, account, and time, then wait for confirmation before confirm=true.

  • create_posts_batchCreate posts in bulk

    1 to 25 posts in one confirmed request.

  • update_postEdit a post

    Show the caption, account, and time, then wait for confirmation before confirm=true.

  • list_postsPosts

  • get_postOne post

  • delete_postDelete posts

    Live removal needs an eligible connection and confirm_published. A refusal keeps the posterly record.

  • find_available_slotFind a free slot

  • generate_captionsGenerate captions

Media

  • upload_mediaUpload media

    Hosted requests are about 4MB, so this path is for small files. Large files use create_signed_upload or create_media_drop.

  • create_signed_uploadSigned upload link

  • create_media_dropMedia drop link

  • list_mediaMedia library

How to connect

  1. Add the hosted server in Claude, ChatGPT, Cursor, or another MCP client. Server URL: https://www.poster.ly/api/mcp. Sign in with posterly OAuth and press Allow. Use the www host. In ChatGPT, write actions need a Business, Enterprise, or Edu plan.
  2. Or, in a client that can run a local process (Cursor, Claude Code, Windsurf, and similar), use npx -y posterly-mcp-server@latest with a POSTERLY_API_KEY placeholder in that client's MCP config.
  3. Call whoami and list_accounts so you know which workspace the client is using.
  4. Connect Telegram with the method below, then call list_platforms with view=schema and the account_id.

Telegram

Paste your credentials into the dashboard form. You can also give them to your AI client, but anything you type into a chat becomes part of that chat history.

  • Bot token (required): Telegram bot token from BotFather.
  • Chat ID (required): Target channel or group chat ID.
Connect Telegram in the dashboard

Example prompts

  • Post this announcement to our Telegram channel tomorrow at 9am with a button that links to the signup page.
  • Send these six photos to Telegram as one album with a short caption.
  • Create a Telegram poll asking which feature to build next, with four options, and post it on Friday at noon.

Telegram limits

Caption or text
4,096 characters.
Media count
Up to 10 media items.
Platform rule
Plain text can use 4,096 characters. A caption on media is capped at 1,024 characters, with at most 10 media items.

Request rates depend on your plan. The posterly MCP page lists them.

Pricing

API and MCP access is an add-on to any posterly plan. Starter plus API is $10 a month, charged now with no free trial on this checkout.

Get Starter + API · $10/moSee every plan

FAQ

What is the Telegram MCP server?

It is the posterly MCP server, not a separate product. Connect it once and the same connection covers Telegram and 17 other platforms, from Claude, ChatGPT, Cursor, and other MCP clients.

How do I connect Telegram?

Add the hosted server at https://www.poster.ly/api/mcp and sign in with posterly, or run npx -y posterly-mcp-server@latest in a client that can start a local process. Telegram: Paste your credentials into the dashboard form. You can also give them to your AI client, but anything you type into a chat becomes part of that chat history.

Can Claude post to a Telegram channel or group?

Yes. The connection takes a bot token from BotFather and the chat ID of the channel or group you want to post to. Connect once per destination, then name the one you want in your request.

Can I add buttons or polls to a Telegram post?

Yes. A post can carry up to 3 inline link buttons, or you can send a native poll with 2 to 10 options. Polls cannot include media, and albums of up to 10 items cannot include buttons.

Keep reading

MCP

posterly MCP server

Hosted OAuth setup, the local npm package, and the full tool list.

Scheduler

Telegram scheduler

Schedule Telegram from the posterly calendar and composer.

Guide

Telegram guide

Read the long Telegram guide, then come back to connect it.

Pricing

posterly pricing

Compare plans, then add API and MCP at checkout.

Other platform MCP servers