Skip to content
Agentmart
Submit a tool

Telethon Plus

Self-hosted MCP server: Telegram userbot control (Telethon) via HTTP and MCP.

Connector by psyb0t · GitHub account verified by the MCP Registry

IndexedWTFPLRemote (HTTP)★ 4
Write a review

Install

Pick your client. Read the repository before you give any tool access to your data.

No install instructions from the source yet. Check the repository for setup steps.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Self-hosted MCP server: Telegram userbot control (Telethon) via HTTP and MCP.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
13 read · 14 write · 4 delete · 3 not yet classified
Secrets
None asked for
Install scripts
None found
Runs as
Docker image

Tools by what they do 34

Read from the source code; the running server may list different tools.

Read 13 · Look things up without changing anything.

  • account_health
  • get_dialogs
  • get_entity
  • get_linked_chat
  • get_me
  • get_message
  • get_messages
  • get_participants
  • get_poll_results
  • join_chat
  • leave_chat
  • throttle_status
Show 1 more tools
  • vote_poll

Write 14 · Create, change, send or run things.

  • bulk_resolve
  • create_group
  • create_poll
  • download_media
  • edit_message
  • forward_messages
  • join_via_invite
  • mark_read
  • pin_message
  • promote_user
  • send_file
  • send_message
Show 2 more tools
  • set_reaction
  • unpin_message

Delete 4 · Delete, drop, revoke or wipe things.

  • ban_user
  • delete_chat
  • delete_messages
  • remove_reaction

Not yet classified 3 · We could not tell from the name and description.

  • demote_user
  • kick_user
  • unban_user

Network hosts it talks to 3

  • github.com · found in code
  • glama.ai · found in code
  • t.me · found in code

Files it touches

  • /tmp/telethon-plus

Tools (34)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • account_health

    Account-level health: are we connected, what's our flood-risk tier based on recent FLOOD_WAITs and the adaptive multiplier.

  • ban_user

    Ban a user from a supergroup/channel. until_seconds=0 = permanent.

  • bulk_resolve

    Resolve many chat references in one call, honoring the resolve-username rate limit. Returns per-handle success/error and populates the entity cache.

  • create_group

    Create a new supergroup or broadcast channel.

  • create_poll

    Create a poll in a chat. Set quiz=true with correct_option for quiz-style polls.

  • delete_chat

    Delete a supergroup or channel you own.

  • delete_messages

    Delete messages by ID.

  • demote_user

    Strip admin rights from a user.

  • download_media

    Download the media attachment of a message. Returns the file as base64-encoded bytes. Reject files larger than max_bytes.

  • edit_message

    Edit a message you sent.

  • forward_messages

    Forward one or more messages between chats.

  • get_dialogs

    List your dialogs (chats, groups, channels).

  • get_entity

    Resolve a chat reference (username, phone, link, or ID) to a profile.

  • get_linked_chat

    Resolve a channel's linked discussion group (if any). Returns linked_chat_id and the linked entity profile.

  • get_me

    Return the authorized account profile.

Show 19 more tools
  • get_message

    Fetch a single message by ID from a chat.

  • get_messages

    Read recent messages from a chat (newest first).

  • get_participants

    List members of a group or channel.

  • get_poll_results

    Fetch current results of a poll message.

  • join_chat

    Join a public channel or supergroup.

  • join_via_invite

    Join a private chat via t.me/+hash invite link.

  • kick_user

    Kick a user from a chat (ban + immediate unban — they can rejoin via invite).

  • leave_chat

    Leave a channel or supergroup.

  • mark_read

    Mark messages in a chat as read.

  • pin_message

    Pin a message in a chat.

  • promote_user

    Grant admin rights to a user in a supergroup/channel. Each boolean toggles a specific permission. Pass title for the custom rank.

  • remove_reaction

    Remove your reaction from a message.

  • send_file

    Download a file from an HTTP(S) URL and send it to a chat. Use force_document=true to send as a generic file instead of letting Telegram pick a media type.

  • send_message

    Send a text message to a chat.

  • set_reaction

    React to a message with an emoji.

  • throttle_status

    Return current throttling state: bucket usage, adaptive multiplier, recent flood events, cache stats, safety flags.

  • unban_user

    Lift a ban on a user in a supergroup/channel.

  • unpin_message

    Unpin a previously pinned message.

  • vote_poll

    Vote on a poll by 0-based option index/indices.

Signals

Stars
4
Forks
1
Open issues
0
Last commit
Oct 19, 2026 (9 days ago)
Last release
Aug 1, 2026 (2 months ago)
Last package publish
Oct 17, 2026 (12 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.psyb0t/telethon-plus
Version
0.5.7
Auth
No auth
Packages
oci docker.io/psyb0t/telethon-plus:v0.5.7
License
WTFPL
Repository
github.com/psyb0t/docker-telethon-plus
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql

More from psyb0t

Cite this page

Telethon Plus MCP server. Agent Mart. https://agentmart.dev/connectors/psyb0t-telethon-plus (last updated 2026-10-24)