telegram-mcp CLAUDE.md

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

A set of deployment instructions for telegram-mcp, including its server, domain, containers, deployment steps, subdomain setup, and environment variables.

In plain words
What is it for?
Use it when deploying telegram-mcp to Hetzner, updating its version, configuring telegram.regiq.in, or setting the required environment.
Why use it?
It gives an agent the project-specific details needed to deploy and update the service consistently.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md. Also seen: mentions Claude Code.

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/globalion/telegram-mcp/claude-md
Clone the repo
git clone --depth 1 https://github.com/globalion/telegram-mcp

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 telegram-mcp CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/globalion/telegram-mcp/claude-md.svg)](https://agentmods.dev/instructions/globalion/telegram-mcp/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/globalion/telegram-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/globalion/telegram-mcp/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 808 This file is loaded in full into every session.
When invoked 808 The same file — it is already loaded in full.
Security scan A 1 finding. Scan, not verified.
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.00808 $0.00808
Opus 5 $0.00404 $0.00404
Sonnet 5 $0.00162 $0.00162
Haiku 4.5 $0.00081 $0.00081

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

Security

Grade A, and why

telegram-mcp 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 5d 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.

curl -X POST "https://api.cloudflare.com/client/v4/zones/$CLOUDFLARE_ZONE_ID/dns_records" \
Origin

This is a copy

100% identical to telegram-mcp 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 · 61 lines

How it starts

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

Deploying telegram-mcp to Hetzner + regiq.in

Deploy pattern for future Claude Code sessions working on this repo.

Server (shared with the rest of the Globalion MCP fleet)

  • SSH: [email protected]
  • Service directory: /opt/telegram-mcp/
  • Domain: telegram.regiq.in (Cloudflare-tunnelled to telegram-mcp-web:3000)
  • Container names: telegram-mcp-web, telegram-mcp-db
  • NEVER touch other people's folders under /opt/ — see shreyas-onboarding.md §7.

Deploy a new version

From this repo on your dev machine:

tar --exclude=node_modules --exclude=.next --exclude=.git -cf - . \
  | ssh [email protected] "mkdir -p /opt/telegram-mcp && tar -xf - -C /opt/telegram-mcp/"
ssh [email protected] "cd /opt/telegram-mcp && docker compose up -d --build"

First-time subdomain wiring (telegram.regiq.in)

  1. Add an ingress rule to /opt/platform/cloudflared/config.yml on the server, BEFORE the final catch-all rule:
    - hostname: telegram.regiq.in
      service: http://telegram-mcp-web:3000
    
  2. Restart the tunnel: ssh [email protected] "docker restart platform-cloudflared-1"
  3. Create the DNS CNAME (needs CLOUDFLARE_API_TOKEN + CLOUDFLARE_ZONE_ID from shreyas-onboarding.md):
    curl -X POST "https://api.cloudflare.com/client/v4/zones/$CLOUDFLARE_ZONE_ID/dns_records" \
      -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{"type":"CNAME","name":"telegram","content":"0caf1caf-59f6-4f36-9ea5-4aa9a9f41d0b.cfargotunnel.com","proxied":true}'
    

Env vars

Populated on the server via /opt/telegram-mcp/.env (NOT committed to git). Values live in shreyas-onboarding.md for shared secrets, per-app secrets are generated fresh:

  • GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET — created per-MCP in Google Cloud Console
  • NEXTAUTH_SECRETopenssl rand -base64 32
  • PUBLIC_BASE_URL=https://telegram.regiq.in
  • NEXTAUTH_URL=https://telegram.regiq.in

Health & debugging

Read the full file on GitHub · 61 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. 5d ago First seen · 61 lines · 808 tokens per session scan A 20e3ce5162d6

Subscribe to this mod's changes

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