Telegram MCP by usefulapi

io.usefulapi由 usefulapi.io 發布官方發布者v1.3.4更新於 Nov 7, 2026

Read chats and members; send, edit and delete messages with a bot in Telegram.

發布方自己的服務:Ably MCP by usefulapi

已驗證Streamable HTTP可網頁執行效率與工作流溝通與協作

概覽

AI 產生的概覽

託管式 Telegram 機器人伺服器,讓助理讀取聊天與成員資訊,並透過 Bot API 傳送、編輯或刪除訊息。

可以做什麼
  • 檢視機器人自身資料及其所屬聊天的類型、標題、描述與權限
  • 統計聊天成員數量並查詢單一成員的狀態與權限
  • 列出群組或頻道的管理員
  • 讀取排隊等待機器人的訊息與事件,並以 offset 確認
  • 以機器人身分傳送、編輯和刪除訊息
  • 查看當月用量、提出功能請求,以及升級或取消付費方案
適用情境
適合讓助理監控或回覆傳到 Telegram 機器人的訊息、回報頻道或群組的成員與管理員狀況,或在團隊群組、頻道中發布與管理訊息,而不必自行撰寫 Bot API 程式碼。
執行需求
透過 streamable HTTP 連線的遠端 MCP 端點,無需本機安裝。以 OAuth 登入,登入頁要求填寫從 BotFather 取得的 Telegram 機器人權杖,伺服器會驗證並依使用者儲存。用戶端設定不需要 API 金鑰或 Authorization 標頭。需要能連線至該託管端點的網路。
安裝前請注意
機器人權杖屬於憑證,須在服務商登入頁輸入並由其伺服器保存。傳送、編輯和刪除會作用於真實聊天且他人可見;刪除無法復原,且僅限機器人有權刪除的訊息,多數情況下限於 48 小時內的訊息。帶 offset 讀取更新會不可回復地刪除 Telegram 中較早的更新。付費方案需付費,透過 Stripe 結帳連結付款;免費額度為每月 50 次呼叫。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Telegram MCP by usefulapi,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.usefulapi%2Ftelegram/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "telegram-by-usefulapi": {
      "type": "http",
      "url": "https://telegram.usefulapi.io/mcp"
    }
  }
}

README

Telegram MCP by usefulapi

Use your Telegram account from Claude, Cursor, or any MCP client. Read chats, members and administrators of your bot, and send, edit and delete messages with the bot. Hosted, no local install: connect with your own credentials.

Live endpoint: https://telegram.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://telegram.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http telegram https://telegram.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "telegram": {      "url": "https://telegram.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Telegram credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/telegram/

On first connect you provide a Telegram bot token (open @BotFather in Telegram, send /newbot or /mybots, then API Token). The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
telegram_get_mereadGet the bot
telegram_get_chatreadGet a chat
telegram_get_chat_member_countreadCount chat members
telegram_get_chat_memberreadGet a chat member
telegram_get_chat_administratorsreadList chat administrators
telegram_get_updateswriteGet pending updates
telegram_send_messagewriteSend a message
telegram_edit_message_textwriteEdit a message
telegram_delete_messagewriteDelete a message
telegram_usage_statusmetaUsage status (free-tier meter)
telegram_request_featuremetaRequest a missing feature
telegram_upgrademetaUpgrade to Pro or Pro+
telegram_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with telegram_upgrade (it returns a Stripe Checkout link). Cancel any time with telegram_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running telegram_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

來源:servers/telegram/README.md,提交 4046075

工具

9

telegram_get_me

Get the bot

Return the bot's own profile (id, name, username, group-join and inline settings). Use it to confirm the token works. Bot API: getMe.

無需輸入參數。

telegram_get_chat

Get a chat

Get the details of a chat the bot belongs to: type, title, username, description, pinned message, permissions. Bot API: getChat.

輸入參數chat_id必填

telegram_get_chat_member_count

Count chat members

Get the number of members in a chat. Bot API: getChatMemberCount.

輸入參數chat_id必填

telegram_get_chat_member

Get a chat member

Get one member of a chat: status (creator, administrator, member, restricted, left, kicked) and rights. Bot API: getChatMember.

輸入參數chat_id必填user_id必填

telegram_get_chat_administrators

List chat administrators

List the administrators of a group or channel (not other bots' hidden admins). Bot API: getChatAdministrators.

輸入參數chat_id必填

telegram_get_updates

Get pending updates

Read the messages and events that users sent to the bot and that wait in Telegram's queue (short poll, no wait). Without offset the same updates return again. A positive offset above an update_id, or a negative offset, deletes older updates in Telegram (this cannot be undone). allowed_updates changes the bot's saved update filter. Fails with HTTP 409 if the bot has a webhook. Bot API: getUpdates.

輸入參數limitoffsetallowed_updates

telegram_send_message

Send a message

WRITE: send a text message from the bot to a chat. The message is visible to real people and cannot be unsent except with telegram_delete_message. Bot API: sendMessage.

輸入參數text必填chat_id必填parse_modemessage_thread_idreply_to_message_iddisable_notification

telegram_edit_message_text

Edit a message

WRITE: change the text of a message that the bot sent. This replaces the old text. Bot API: editMessageText.

輸入參數text必填chat_id必填message_id必填parse_mode

telegram_delete_message

Delete a message

WRITE: delete a message. This cannot be undone. A bot can delete its own messages and incoming private-chat messages. In groups it needs the delete-messages admin right for other messages. Telegram allows deletion only for messages up to 48 hours old in most cases. Bot API: deleteMessage.

輸入參數chat_id必填message_id必填

版本歷史

6
  1. v1.3.4最新Nov 7, 2026
  2. v1.2.3Nov 5, 2026
  3. v1.2.2Nov 5, 2026
  4. v1.2.1Nov 4, 2026
  5. v1.2.0Nov 3, 2026
  6. v1.1.1Nov 3, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Usefulapi 整合