MCP, MCP server
Telegram Read Mcp
A minimal read-only MCP server that exposes Telegram chat and forum-topic reading via Streamable HTTP.
Compatibility: Not stated.
Grade B
Minor issues only, no Medium or High. Worth a quick look at the findings below before installing.
Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.
SECRETS_PATH_DOTENV
Why this grade
- SECRETS_PATH_DOTENV Low
Mentions a .env file.
scripts/first-login.py, line 73
print("Error: TG_API_ID and TG_API_HASH must be set in .env or environment.")
Any High, or two or more Medium findings, give D. One Medium gives C. Low findings or a security Note give B. Each code names a finding behind the letter.
Grades are a hygiene check of the source at the commit shown, on the date checked, not a security audit or a guarantee. The free directory grades are automated. Before release, a PlugVet engineer reviews every paid report and any grade we hold back, including all F grades, against the source code and the evidence we quote.
What was checked
Plain notes from the hygiene checks.
Permissions
Pass
No shell or command execution found, and no extra permission was declared.
Install and update
Pass
No install-time script found, and dependencies are pinned or absent.
Network
Pass
No network call found.
Secrets
Concern
reads a credential or environment file.
SECRETS_PATH_DOTENV
scripts/first-login.py, line 73
print("Error: TG_API_ID and TG_API_HASH must be set in .env or environment.")
scripts/run-http.sh, line 3
# Reads config from .env in the project root.
.gitignore, line 8
*.session-journal
Show more
AGENTS.md, line 10
- `.env` and `*.session` files are credentials (a session file grants full account access). Never commit, print, or copy them.
AGENTS.md, line 23
Run `uv run pytest`. The unit tests need no credentials. The integration test (`tests/test_get_message_image_integration.py`) needs a running server and IDs from environment variab
AGENTS.md, line 29
`.env` and the session file (`TG_SESSION_PATH`, default `telegram_read_mcp`) are resolved relative to the working directory, so run from the repo root.
AGENTS.md, line 39
- Conventional Commits (`feat:`, `fix:`, `docs:`, `build:`), one focused change per commit. PR descriptions list user-visible changes, any `.env` or deployment changes, and the man
README.md, line 23
1. Copy `.env.example` to `.env` and fill in your credentials:
Agent instructions
Pass
No instruction to ignore earlier instructions or to hide a step.
Obfuscation
Pass
No encoded or minified payload found.
Licence
Pass
A licence file is present (LICENSE).
Maintainer activity
Pass
The latest commit is within the last 365 days.
Note
Hygiene check of commit 4008b36a67cf. reads a credential or environment file.
Date and source
Date checked:
github.com
Commit graded: 4008b36a67cf178f05dc0d9de245f32e33ecb7d2
This link goes to the original host. PlugVet does not host or check what you download from there, and installing it is your own decision and risk.