Telegram MCP server: let Claude or any agent post to your Telegram channel

Set it up and post, step by step

1. Add PostWire's MCP server to your agent

   In Claude, open PostWire in the connector directory and press Connect. Anywhere else, add the remote server https://postwire.io/api/mcp (Streamable HTTP; OAuth sign-in or an API key) — in Claude Code: claude mcp add --transport http postwire https://postwire.io/api/mcp. Cursor, VS Code, Windsurf, Codex and Gemini CLI configs: MCP client configs.

2. Sign in with your email

   The first time the agent uses a PostWire tool, a sign-in window asks for your email and a 6-digit code; that also creates a free PostWire account if you have none. No password and no card. Agents that cannot do OAuth send an API key instead (dashboard → API & MCP → Copy key).

3. Create a bot and add it to your channel

   In Telegram, message @BotFather, send /newbot, pick a name and copy the token it gives you. Then open your channel or group and add that bot as an admin, so it is allowed to post there. The bot only posts where you add it.

4. Connect Telegram

   Ask "connect my Telegram channel". create_connect_link gives you a one-hour link; choose Telegram there and paste the token and your channel as @yourchannel (for a private channel or group, its numeric id, which starts with -100). There is no sign-in screen. Before saving, PostWire asks Telegram whether that bot can reach that chat, so a mistyped channel or a bot that is not an admin yet is caught on that page, with the fix, and not at the first post.

5. Let PostWire write the message

   "Write today's Telegram post about the new pricing page, and a Bluesky post for it." generate_posts returns one draft per network and publishes nothing. Telegram's draft is clear and direct, with light formatting, links welcome and no hashtags; it stays under 4,000 characters. Bluesky's is a conversational post of up to 300.

6. Post it, or schedule it

   After you approve, the agent calls post_to_social (or schedule_post with a run_at time, or "next_slot" for your next free queue slot). Add photo_url or video_url — a public https link — and the text becomes the caption of that photo or video:

   {
     "name": "post_to_social",
     "arguments": {
       "platforms": ["telegram", "bluesky"],
       "per_platform": {
         "telegram": { "text": "New pricing page is live 🎉 Plans start free, and every plan now includes the API. Details: https://example.com/pricing" },
         "bluesky": { "text": "we rewrote our pricing page so you can read it in ten seconds. tell me if we failed https://example.com/pricing" }
       },
       "photo_url": "https://postwire.io/m/…/pricing.png"
     }
   }

7. Open the message

   The result lists each network with ok, the id of the Telegram message and its link: https://t.me/yourchannel/123 for a public channel, https://t.me/c/…/123 for a private one (it opens for members). get_post_status returns the same link later; list_scheduled_posts shows what is still queued and cancel_scheduled_post removes one before it goes out.

A photo or a video from your phone or laptop gets there through create_upload_link: a 24-hour page where you pick the file (up to 100 MB on the free plan and 1 GB on paid plans), then get_uploaded_file returns its media_url. The same post from your own code: POST /api/post with {"platforms": ["telegram"], "text": "…"} and your API key, or the PostWire node in n8n. Prefer to set it up by hand first? Open the dashboard, connect the account under Accounts and copy your key under API & MCP.