tg-mcp-guarded
Dual-plane Telegram MCP server providing read-only analytics and guarded write actions with built-in rate limiting, anti-spam protection, and session management.
Limited view. Automated analysis covers part of this stack. Findings reflect what we verified. Grades reflect the full trust pyramid: code, verification depth, and reputation. New projects cap at C until adoption is earned.
Limited view: static analysis for Python is partially covered.
How we verified
Verified is a snapshot. Live keeps it current, and builds your track record.
⚡ Connect GitHub → continuous verification on every pushwhy connect →Who stands behind it
matskevich
Source: Glama
Claim it to get a verified publisher badge, a free copy of our full audit findings, and direct contact for any high-priority issues we find. Or connect your repo for our deepest verification, Live Monitored: read-only, revoke anytime. What we access →
Install from
The grade above is for the source repository. Registries can serve a different version, so we mark the ones we were not able to read.
TG_MCP_SERVER_NAMETG_ALLOW_SESSION_SWITCHTG_ACTIONS_ENABLEDTG_ACTIONS_REQUIRE_ALLOWLISTTG_ACTIONS_UNSAFE_OVERRIDEActionMCP is fail-closed by default: weakening core safe flags auto-disables actions unless =1.TG_ACTIONS_MAX_MESSAGE_LEN"": "2000",TG_ACTIONS_MAX_FILE_MBTG_ACTIONS_MIN_CONFIRM_TEXT_LENTG_ACTIONS_IDEMPOTENCY_WINDOW_SEC"": "86400",TG_ACTIONS_REQUIRE_CONFIRMATION_TEXTTG_ACTIONS_CONFIRMATION_PHRASENon-dry-run write actions require confirm=true and exact confirmation_text ().TG_ACTIONS_REQUIRE_APPROVAL_CODENon-dry-run write actions also require one-time approval_code from the matching dry_run preview (=1).TG_ACTIONS_IDEMPOTENCY_ENABLEDTG_ACTIONS_APPROVAL_TTL_SEC"": "1800",TG_ACTIONS_APPROVAL_MIN_AGE_SECapproval_code has minimum age (, default 30s): immediate execute right after dry_run is blocked.TG_ACTIONS_APPROVAL_FILE"": "data/anti_spam/action_approvals.json",TG_ACTIONS_BATCH_TTL_HOURS"": "168",TG_ACTIONS_BATCH_APPROVAL_LEASE_SEC"": "86400",TG_ACTIONS_BATCH_RUN_LEASE_SEC"": "1800",TG_ACTIONS_BATCH_FILE"": "data/anti_spam/action_batches.json",TG_ACTIONS_ALLOWED_GROUPSenv ="-1001234567890" \TG_WRITE_CONTEXTenv =read_mcp \TG_ENFORCE_ACTION_PROCESSIn strict mode (=1), write is allowed only when process entrypoint is mcp_server_actions.py.TG_EXPECTED_USERNAMEenv ="my_main_account" \TG_SESSION_CONFLICT_REGISTRY_FILEenv ="$REPO/data/anti_spam/session_registry.json" \TG_READ_SESSION_PATHenv ="$REPO/data/sessions/my_account_ro.session" \TG_ACTIONS_SESSION_PATHenv ="$REPO/data/sessions/my_account.session" \TG_SESSIONS_DIRenv ="$REPO/data/sessions" \TG_SESSION_PATH_CONFLICT_MODEenv =warn \TG_SESSION_PATHenv ="$REPO/data/sessions/my_account_ro.session" \SESSION_NAMETG_DISABLE_RATE_LIMIT_FOR_TESTSPYTEST_CURRENT_TESTRATE_RPSMAX_DM_PER_DAYMAX_JOINS_PER_DAYMAX_GROUP_MSGS_PER_DAYMAX_GROUPSTG_GLOBAL_RPS_MODEenv =shared \TG_FLOOD_CIRCUIT_THRESHOLD_SEC"": "300",TG_FLOOD_CIRCUIT_COOLDOWN_SEC"": "900",SESSION_DIRTG_SESSION_LOCK_MODEenv =shared \TG_RECEIVE_UPDATES0 (default) disables Telethon updates loop to reduce sqlite session lock contention.TG_BLOCK_DIRECT_TELETHON_WRITETG_ALLOW_DIRECT_TELETHON_WRITETG_AUTH_BOOTSTRAPTG_ACTION_PROCESSTG_DIRECT_TELETHON_WRITE_ALLOWED_CONTEXTSenv =actions_mcp \TG_SESSION_RUNTIME_MODEenv =copy \TG_SESSION_RUNTIME_PROFILETG_SECRET_PROVIDERenv (default): read plain env valuesTG_USE_KEYCHAINTG_API_IDEdit .env with your , TG_API_HASHTG_API_HASHEdit .env with your TG_API_ID,TG_KEYCHAIN_SERVICETG_KEYCHAIN_ACCOUNT_API_IDTG_KEYCHAIN_ACCOUNT_API_HASHTG_API_HASHTool annotations
No tools have read-only/destructive annotations
Add readOnlyHint or destructiveHint annotations to every tool so hosts can warn users before invoking.
All four hints declared on every tool
44/44 tools missing one or more hints — tg_create_private_group (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint); tg_list_sessions (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint); tg_use_session (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint), +41 more. OpenAI's directory rejects tools where any of the four hints are missing or non-boolean.
For every tool, set all four hints (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) to explicit true/false values that match the handler’s actual behaviour.
Tool inputs are validated
37/44 tool handlers declare input schemas (84%)
Declare an inputSchema with zod/joi/yup on every tool definition.
Tool handlers catch errors
Only 10/44 tool handlers wrap calls in try/catch (23%)
Wrap each tool handler body in try/catch and return a structured error response.
Tests exist
No test files found
Add tests that exercise each declared tool.
Claim the listing to review these findings one by one and send us a correction where you disagree, straight to the team. Claiming also means we tell you when the grade moves, and reach you first if we find anything urgent.
[](https://m8ven.ai/mcp/matskevich/tg-mcp-guarded)?variant=verified to the badge URL.Vetting this one by hand? Tool Check is an MCP that scores other MCPs. Add it once and ask Claude, ChatGPT, or any MCP client to grade a server, surface CVEs, check the publisher, and suggest safer alternatives — before you install.
https://m8ven.ai/api/mcp/tool-check