# Telegram MCP server > Connect Claude, ChatGPT or Cursor to your Telegram channel or group. Your agent posts albums, polls and link buttons, with no bot token or BotFather. Canonical: https://omnisocials.com/telegram-mcp | Channel page: https://omnisocials.com/telegram.md | Telegram API: https://omnisocials.com/telegram-api.md | Pricing: https://omnisocials.com/pricing.md | 14-day free trial: https://app.omnisocials.com/signup This is the machine-readable version of [omnisocials.com/telegram-mcp](https://omnisocials.com/telegram-mcp), maintained for AI agents. Facts checked against the OmniSocials app on October 17, 2026. - **Server URL:** https://mcp.omnisocials.com - **Auth:** OAuth sign-in, or an API key for agents that run on their own - **Discovery file:** https://omnisocials.com/.well-known/mcp.json - **Docs:** https://docs.omnisocials.com/mcp-server - **With your AI agent:** Connect Claude, ChatGPT or any MCP client to your Telegram channel or group with the OmniSocials MCP server. Your agent posts albums, polls and link buttons and reads your reactions, with no bot of your own and no bot token. - **With your coding agent:** Claude Code and Codex add the OmniSocials MCP server with one command, and agents that run on their own use an API key. Or call the Telegram API from your own code. ## What your agent does Ask in plain words. Your agent picks the MCP server's tools, and the OmniSocials bot posts to your channel or group. - **Posts with link buttons.** Up to 3 buttons under a post, sent silently and pinned in your channel. (`create_post`, `get_post`) - **Native Telegram polls.** Your text is the question, with 2 to 12 answers, open for up to 30 days. (`create_post`, `get_best_times`) - **Albums with the whole story.** 2 to 10 photos and videos. Text over 1,024 characters follows as a reply. (`create_post`, `upload_media`) - **Know what worked.** The reactions on each post and the best time for the next one. Views stay in Telegram. (`get_posts_analytics`, `get_best_times`) ## Setup Connected in a minute. One URL and one sign-in. No API key for chat apps. 1. **Connect Telegram in OmniSocials.** Press Start in the OmniSocials bot and pick your channel or group. No bot token. 2. **Add the server to your agent.** Paste one URL as a custom connector, or run one command. 3. **Sign in and pick a workspace.** OAuth in the browser. Agents that run on their own use an API key. - **Claude:** Customize > Connectors > Add custom connector > Paste the URL. Claude sends you to OmniSocials to sign in. No API key needed. Guide: https://omnisocials.com/claude - **Claude Code:** `claude mcp add --transport http omnisocials https://mcp.omnisocials.com`. Then type /mcp in Claude Code and sign in to OmniSocials. Guide: https://omnisocials.com/claude-code - **Codex:** `codex mcp add omnisocials --url https://mcp.omnisocials.com`. Then run codex mcp login omnisocials to sign in. Guide: https://omnisocials.com/codex - **API key:** `claude mcp add --transport http omnisocials https://mcp.omnisocials.com --header "Authorization: Bearer YOUR_API_KEY"`. For agents that run on their own. Create the key in Settings, API Keys. Docs: https://docs.omnisocials.com/mcp-server ## Tools 19 tools in 4 groups. Your agent picks them from a plain request. ### Publishing Posts, albums and polls, now or on a schedule, with every Telegram option. Try asking: "Post the alt text news on our Telegram channel Thursday at 9 AM, with a Read the guide button. Pin it." - create_post: Schedule a post, album or poll, with link buttons, a pin, silent sending and the other Telegram options. - create_and_publish_post: Post to Telegram right away, with the same options. - update_post: Change the text, the Telegram options or the time of a draft or scheduled post. - get_post: A post's Telegram options and, once it's out, whether it was pinned and its link. - upload_media: Upload photos or a video from a URL or the chat. - check_media_compatibility: Check a file's size and format first. Videos go up to 50 MB. - retry_post: Publish a failed post again. ### Insights The reactions on each post, and when to post the next one. Try asking: "Which Telegram posts got the most reactions last month, and when should I post next?" - get_post_analytics: The reactions on one post. Telegram gives bots no views. - get_posts_analytics: The reactions on many posts at once, to compare them. - get_account_analytics: Your channel's subscribers or your group's members. - get_best_times: Your best days and hours from your own posts, or industry defaults until you have 15. ### Approvals Your team or client signs off before a post goes out. Try asking: "Approve the Telegram posts that are waiting for me." - list_approval_workflows: The review steps a post can go through. - approve_post: Approve a post that waits for you. - reject_post: Send a post back with what to change. - get_post_approval: Where a post stands in its review. ### Accounts and setup Which chat, which workspace, which events. Try asking: "Which Telegram chat is connected, and how many subscribers does it have?" - list_accounts: The accounts connected to the workspace, your Telegram chat among them. - get_account: Your Telegram chat's type, its subscribers and its link. - switch_workspace: Work in another workspace. - create_webhook: Get an event when a post is scheduled, published, approved, rejected or fails. ## FAQ ### Is there an official Telegram MCP server? OmniSocials runs a hosted MCP server at https://mcp.omnisocials.com that posts to Telegram channels and groups through Telegram's Bot API. You don't host anything or create a bot: you connect your chat in OmniSocials, add the server to your agent, and the same tools post to your other channels too. ### Can Claude post to my Telegram channel? Yes. Once your channel is connected in OmniSocials and the MCP server is added to Claude, ask in plain words. Claude schedules the post, album or poll with the Telegram options, or posts it right away, and gets its link once it's out. ChatGPT, Cursor and other MCP clients work the same way. ### Do I need to create a Telegram bot? No. There is no bot token and no BotFather. In OmniSocials, open Channels, pick Telegram and press Connect. The OmniSocials bot opens in Telegram: press Start, tap Choose a channel or Choose a group, and pick your chat in Telegram's own picker. OmniSocials checks that you are an admin of that chat. Each workspace connects one Telegram channel or group. ### Can my agent post to a Telegram group? Yes, to a group or a supergroup. In a group, posts appear as the OmniSocials bot, which joins as a member. In a channel, they appear as your channel. To pin posts in a group, or to get the reactions on them, make the bot an admin of the group yourself, with the Pin messages right for pinning. In a channel, both work right away. ### Can an agent create Telegram polls? Yes. The post text is the question, up to 300 characters, with 2 to 12 answers of up to 100 characters. Your agent sets one answer or several per person, and keeps the poll open until it's closed or for up to 30 days. Polls are anonymous, and go out without media or buttons. ### Can it read views or messages? No views: Telegram gives bots no view counts, so your agent reads the reactions on each post and your subscriber count instead. The votes of a poll show on the post's page in OmniSocials. The bot doesn't read the messages in your chat, so there are no replies, comments or DMs for your agent to answer. Telegram isn't in the Social Inbox. ### Can the agent edit a sent Telegram post? No. Your agent can change drafts and scheduled posts, but a sent Telegram post can't be edited from OmniSocials. Within 48 hours of sending, Delete from Telegram on the post's page in OmniSocials removes it from the chat. ### Is it safe to let an agent post to Telegram? Yes. Your agent only works through your OmniSocials workspace and the one chat you connected, and never gets a Telegram login or a bot token. Send its posts through an approval workflow and nothing goes out before a teammate or client approves it, or ask it to save drafts for you to check. ### Is the Telegram MCP server included in my plan? Yes. Telegram and the MCP server come with the one plan, like every other channel and feature, with no credits per post. The plan is $10 per seat per month billed annually, or $12 billed monthly. The server needs an active plan or the 14-day free trial; without one, it turns the connection down. The trial needs a card to start. ### How do I connect Claude, ChatGPT or Cursor to Telegram? Connect your Telegram channel or group in OmniSocials first. In Claude, open Customize, then Connectors, click Add, choose Add custom connector and paste https://mcp.omnisocials.com. In ChatGPT, add the same URL as a custom MCP server under Plugins; in Cursor, put it in ~/.cursor/mcp.json. Each one sends you to OmniSocials to sign in and pick a workspace. ## Related ### Set up your agent - [Claude](https://omnisocials.com/claude) - [ChatGPT](https://omnisocials.com/chatgpt) - [Claude Code](https://omnisocials.com/claude-code) - [Codex](https://omnisocials.com/codex) - [Cursor](https://omnisocials.com/cursor) - [Every agent](https://omnisocials.com/mcp) ### Telegram - [Telegram scheduler](https://omnisocials.com/telegram) - [Connect Telegram](https://omnisocials.com/help-center/integrations/telegram) ### For developers - [MCP server docs](https://docs.omnisocials.com/mcp-server) - [Telegram API reference](https://docs.omnisocials.com/platforms/telegram) - [Telegram API](https://omnisocials.com/telegram-api) ## More machine-readable pages - [Telegram](https://omnisocials.com/telegram.md) - [Telegram API](https://omnisocials.com/telegram-api.md) - [All channels](https://omnisocials.com/channels.md) - [MCP server](https://omnisocials.com/mcp.md) - [REST API](https://omnisocials.com/api.md) - [Pricing](https://omnisocials.com/pricing.md) - [llms.txt](https://omnisocials.com/llms.txt)