fast-mcp-telegram: Instructions file for Claude Code

CLAUDE.md

fast-mcp-telegram CLAUDE.md is an instructions file for Claude Code from alexeyleshchenko/fast-mcp-telegram. It costs 882 tokens per session, scanned A, a copy of fast-mcp-telegram CLAUDE.md, MIT.

Instructions for a Telegram server that connects coding agents to Telegram through the Model Context Protocol (MCP), a standard way for tools to communicate with agents. They cover setup, access rules, and development practices.

In plain words
What is it for?
Use them when configuring Telegram access, checking session behavior, or developing and testing the server.
Why use it?
They document the supported Telegram connection modes and help avoid using obsolete repository or setup details.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md.

This is alexeyleshchenko/fast-mcp-telegram's own configuration. It tells Claude Code how to work on fast-mcp-telegram itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything fast-mcp-telegram configures →

Reuse

Borrowing it

Nothing to install: this file belongs to alexeyleshchenko/fast-mcp-telegram. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/alexeyleshchenko/fast-mcp-telegram/master/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/alexeyleshchenko/fast-mcp-telegram

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for fast-mcp-telegram CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/alexeyleshchenko/fast-mcp-telegram/claude-md/github.svg)](https://agentmods.dev/instructions/alexeyleshchenko/fast-mcp-telegram/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/alexeyleshchenko/fast-mcp-telegram/claude-md"><img src="https://agentmods.dev/badge/instructions/alexeyleshchenko/fast-mcp-telegram/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for fast-mcp-telegram CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/alexeyleshchenko/fast-mcp-telegram/claude-md"><img src="https://agentmods.dev/badge/instructions/alexeyleshchenko/fast-mcp-telegram/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 882 This file is loaded in full into every session.
When invoked 882 The same file — it is already loaded in full.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin 100% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00882 $0.00882
Opus 5 $0.00441 $0.00441
Sonnet 5 $0.00176 $0.00176
Haiku 4.5 $0.00088 $0.00088

Measured 10d ago against content hash a8d9aa37aed3, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

fast-mcp-telegram CLAUDE.md scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- **Correct approach**: ACL is not viable through Cursor MCP (stdio has no ACL; URL MCP uses a fixed bearer; stale MCP subprocesses). Use `pytest tests/test_session_acl.py tests/test_mcp_tool_acl_integration.py`, HTTP cu
Origin

This is a copy

100% identical to fast-mcp-telegram CLAUDE.md — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

CLAUDE.md · 34 lines

How it starts

The opening of the file, as written. The whole thing — 34 lines — stays where its author put it; the contents beside it link to each section on GitHub.

fast-mcp-telegram

Canonical GitHub repository: https://github.com/alexeyleshchenko/fast-mcp-telegram

Canonical Python package: fast-mcp-telegram on PyPI (https://pypi.org/project/fast-mcp-telegram/).

Canonical MCP registry name: io.github.alexeyleshchenko/fast-mcp-telegram

The old GitHub URL https://github.com/leshchenko1979/fast-mcp-telegram is a public 404. Do not restore that owner in README links, pyproject.toml, server.json, glama.json, GHCR image names, or docs clone URLs. PyPI is the stable pointer.

Do not create a replacement repository under leshchenko1979/fast-mcp-telegram. If GitHub ever unsuspends that account and allows a transfer, keep the old name free so redirects can work.

Telegram MCP server (stdio, http-no-auth, http-auth). Full setup, ACL matrix, and dev workflow: CONTRIBUTING.md.

Session Corrections

2026-05-27

  • Issue: Tried ACL live testing via Cursor MCP (telegram-dev or http-auth URL with fixed Authorization)
    • Correct approach: ACL is not viable through Cursor MCP (stdio has no ACL; URL MCP uses a fixed bearer; stale MCP subprocesses). Use pytest tests/test_session_acl.py tests/test_mcp_tool_acl_integration.py, HTTP curl against a local http-auth server, and scripts/acl_mcp_smoke.sh (reads bearer tokens from acl.dev.yaml, not hardcoded placeholders) — see CONTRIBUTING.md § ACL development and testing
  • Issue: Started http-auth ACL server from wrong cwd, or source .env.local in zsh for MTPROTO_PROXY
    • Correct approach: Start the server from the project root so Python loads .env / .env.local via dotenv; do not source .env.local in zsh — proxy URLs with & break shell parsing
  • Issue: Assumed ACL applies in stdio or without per-bearer sessions
    • Correct approach: ACL enforces only with SERVER_MODE=http-auth and ACL_ENABLED=true; each bearer in acl.dev.yaml needs a matching {token}.session via http://127.0.0.1:8765/setup
  • Issue: Expected connection.py stdio fix without restarting Cursor MCP
    • Correct approach: After changing server code used by telegram-dev, restart telegram-dev in Cursor’s MCP panel — stale subprocess keeps old behavior
  • Issue: Risk of committing real ACL bearer tokens
    • Correct approach: Keep acl.dev.yaml gitignored; never commit real bearer tokens (template only: acl.dev.yaml.example)
  • Issue: "Repeat the sourcery-pr-cycle" interpreted as running another full PR → Sourcery → fix loop
    • Correct approach: User may mean publish/commit the skill to master, not re-execute the review cycle. Confirm intent when ambiguous.
  • Issue: Treated phase closeout as blocked until all follow-up PRs merge, or assumed phase 1 code cannot land on master while follow-ups are open
    • Correct approach: Phase 1 code can be on master while follow-up PRs (e.g. #56) remain open; closeout means merge all blocking follow-ups first, not every open PR.
  • Issue: Posted Telegram release announcement before release CI finished
    • Correct approach: After gh release create, verify CI/checks are green on the release tag or master commit (gh run list, gh release view); do not post Telegram until release is published and CI is green unless the user explicitly overrides — see release-notes skill

Read the full file on GitHub · 34 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago First seen · 34 lines · 882 tokens per session scan A a8d9aa37aed3

Subscribe to this mod's changes

fast-mcp-telegram CLAUDE.md is an instructions file published in the GitHub repository alexeyleshchenko/fast-mcp-telegram (2 stars, last pushed 20d ago), licensed MIT. It adds 882 tokens to every session, about $0.0044 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). It is 100% identical to fast-mcp-telegram CLAUDE.md, differing in 0 lines, and is treated as a copy.

Related

Other instructions, from other repositories

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,296 tokens

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,153 tokens

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 6,785 tokens

spec-kit AGENTS.md

AGENTS.md instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.

github/spec-kit · 7,104 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).

microsoft/vscode · 5,001 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,469 tokens