Tlgrm MCP Server

tlgrm PyPI v0.3.2

Published by ali-commits — no publish provenance, so origin is unverified, but the source is public: the repository link below is self-declared yet readable, so you can inspect the code before adopting it.

An unofficial, feature-rich command-line client, MCP server, and webhook daemon for Telegram, built on Telethon

Trust grade
A
93/100
Last scanned get badge →
Trust
A · 93/100
Adoption risk for you: the threat score, then adjusted down for blast radius, publisher verification and how much the scan could see. Deterministic; every point is auditable.
Capability
High
Blast radius if it went rogue — what the server’s tools could reach. Independent of trust.
Coverage
Source
How much the scan could actually inspect. Shallow coverage is stated, never hidden.
Share this Trust Score
𝕏 Share LinkedIn Reddit
A Why this grade threat 100 − adoption risk = 93/100

The grade answers one question — how safe is this server for you to adopt — so it is computed in two auditable stages. Nothing below is an opinion or an LLM's guess; every line is a real term the deterministic engine applied, and the same input always yields the same number.

1. Threat score — 100 − 0 = 100. What the published surface and source actually contain:

The deterministic scan raised no scored threat in the surface it inspected — the threat score stayed at 100. Capability observations and advisory notes are recorded but never lower it.

2. Client adoption risk — 100 − 7 = 93. Three small, subtract-only factors that reflect your risk in adopting it — a clean scan proves less on a powerful, unverified or barely-inspectable package, so the grade says so plainly:

PointsAdoption-risk factor
−6 capability blast radius (high) — client exposure if the model is manipulated
−1 publisher verification (public source) — no provenance, but the source is public and inspectable

Capability observations and info notes are shown under Findings but never scored. Open any row's finding below for the file, line and evidence behind a deduction.

Findings 3

high Shell/command execution in server code (src/tlgrm/daemon.py)MTC-SRC-002

In the server's implementation (`src/tlgrm/daemon.py:111`): Spawning a shell/process is command-execution capability; with unsanitized tool input it is command injection / RCE. This is read from the code itself — not from the tool description — so a poisoned server cannot hide it behind honest-looking metadata.

Evidence: try: result = subprocess.run( ["systemctl", "--user"] + args, capture_output=True, text=True, chec

Fix: Review this call path: confirm it never receives unsanitized tool input, constrain it, or remove it. Treat a server whose code reaches these sinks as high-capability regardless of what its tools claim.

Location: server src/tlgrm/daemon.py

high Shell/command execution in server code (src/tlgrm/serverctl.py)MTC-SRC-002

In the server's implementation (`src/tlgrm/serverctl.py:21`): Spawning a shell/process is command-execution capability; with unsanitized tool input it is command injection / RCE. This is read from the code itself — not from the tool description — so a poisoned server cannot hide it behind honest-looking metadata.

Evidence: d) else sys.argv[0] subprocess.Popen( [exe, "server", "start", "--foreground"], stdout=subprocess.DE

Fix: Review this call path: confirm it never receives unsanitized tool input, constrain it, or remove it. Treat a server whose code reaches these sinks as high-capability regardless of what its tools claim.

Location: server src/tlgrm/serverctl.py

medium Untrusted input can drive an external actionMTC-FLOW-005

Untrusted-input tools ([download_media]) co-exist with external-action tools ([send_message, forward_messages]). A prompt injection could cause unwanted external actions, though no direct sensitive-data leak path was found.

Evidence: untrusted [download_media] → sinks [send_message, forward_messages]

Fix: Require confirmation for state-changing/egress actions triggered after processing untrusted content.

Location: flow download_media → send_message

Tools 24

Each tool and what it can reach — statically extracted from the published source.

  • download_mediaingests untrusted input
  • forward_messagesnetwork egress
  • send_messagenetwork egress
  • add_membersno sensitive capability
  • chat_infono sensitive capability
  • create_groupno sensitive capability
  • delete_messagesno sensitive capability
  • edit_messageno sensitive capability
  • get_historyno sensitive capability
  • get_membersno sensitive capability
Show 14 more tools ↓
  • leave_chatno sensitive capability
  • list_chatsno sensitive capability
  • mark_readno sensitive capability
  • muteno sensitive capability
  • pinno sensitive capability
  • reactno sensitive capability
  • remove_membersno sensitive capability
  • schedule_messageno sensitive capability
  • search_messagesno sensitive capability
  • send_pollno sensitive capability
  • unmuteno sensitive capability
  • unpinno sensitive capability
  • user_infono sensitive capability
  • whoamino sensitive capability

Toxic flows 1

Cross-tool combinations that form a data-exfiltration primitive (untrusted input → sensitive source → external sink).

What this scan could not see

Versions 1

Scan history per published version. The engine is deterministic — the same version always yields the same score, so a changed score means the package itself changed.

VersionScoreFindingsEngineScanned
v0.3.2 latest A 93/100 3 1.13.0 2026-08-25

Embed this score

Show this server's live Trust Score in your README, docs or website. The badge is served straight from the registry and updates automatically after every rescan — no API key needed. It links back to this page, so anyone who sees the grade can also read the findings behind it instead of taking a number on faith.

MCP Trust Score: A · 93/100
Markdown (GitHub README)
[![MCP Trust Score](https://mcptrustchecker.com/registry/tlgrm/badge.svg)](https://mcptrustchecker.com/registry/tlgrm)
HTML
<a href="https://mcptrustchecker.com/registry/tlgrm"><img src="https://mcptrustchecker.com/registry/tlgrm/badge.svg" alt="MCP Trust Score" height="20"></a>
Prefer shields.io styling? Point it at https://mcptrustchecker.com/registry/tlgrm/badge.json via https://img.shields.io/endpoint?url=…

Verify this score yourself

The score above is reproducible: the same package version always yields the same result. Run it locally or over the free API — no account, no LLM, fully deterministic.

npx mcptrustchecker scan tlgrm --online --registry pypi

Use the free API → How scoring works

More in Web, Search & Scraping