telegram-mcp@1.0.0
CAUTION· install onlyPublisher claims: "Connects AI assistants to a Telegram bot so the model can message the user, send files, ask questions and wait for button answers, and read or search chats, groups and forum topics. It also lets the assistant reply as the user in connected personal chats, within the permissions granted in Telegram." Observed in sandbox: no network, touches nothing outside the project, writes no memory.
Coverage
Nothing executable in the bundle ran; the trace covers the install step only.- Tested
- every file read, file written and host contacted by what ran
- Not tested
- use of the skill by an agent
What this means for the label: Caution here covers what ran. The server's tools were not exercised with a real credential, so nothing about their behavior is asserted; the credential summary below says what to do with that.
Before you give it your token
- It will ask for
AUTH_LIMITBOT_TOKENRELAY_TOKENWEBHOOK_PATHConfiguration, not credentials: ALLOWED_USER_IDS, DEV_SKIP_IP_CHECK, FILE_LIMIT, MCP_LIMIT, RETENTION_DAYS- Where it talks to
- no vendor host named in the codeAlso t.me, claude.ai, telegram.org, workers.dev, claude.com, chatgpt.com — not the publisher's domain; check what for before connecting.
- What the honeypot saw
- no credential files read · no network
- What we could not test
- use of the skill by an agent
Connect it with a scoped credential, under the guard, and read the third-party hosts first. The code names t.me, claude.ai, telegram.org, workers.dev, claude.com, chatgpt.com as well as its own vendor. The guard injects AUTH_LIMIT, BOT_TOKEN, RELAY_TOKEN, WEBHOOK_PATH only into requests to the host you bind (and its subdomains) and refuses the rest.
Never paste a credential into a chat, a ticket or a report, including ours. How the guard holds it.
Is [email protected] safe to install?
KillerSkills ran it in the KillerSkills honeypot sandbox (1 scenario; nothing executable in the bundle ran; the trace covers the install step only) on 2026-11-12 and scored it 62/100 (Caution). It is not known to be malicious, but it has behaviour or code a security policy should decide on before install. Notable findings: Privileged sudo command; Credential pass-through configuration; Privileged sudo command. Summary: no network, touches nothing outside the project, writes no memory.
Behavior trace
Honeypot run · 0 s · 1 scenarios · 0 deviationsStatic findings
elif have dnf; then sudo dnf install -y -q curl jq </dev/nullFix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.const token = relayToken();Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.if have apt-get; then sudo apt-get update -qq </dev/null && sudo apt-get install -y -qq curl jq </dev/nullFix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.export const relayToken = () => `relay_${randomId(24)}`;Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.import { fallBack, relayState, relayToken, tokenHash } from "../relay";Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose."<code>claude</code>, затем /login, затем <code>sudo systemctl restart tg-relay</code>. В команде токен " +Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell."<code>claude</code>, then /login, then <code>sudo systemctl restart tg-relay</code>. This command holds the " +Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell."⚠️ Слетел вход в Claude. На машине: <code>claude</code>, затем /login, затем <code>sudo systemctl restart tg-relay</code>.",Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell."⚠️ Its Claude sign-in expired. On the machine: <code>claude</code>, then /login, then <code>sudo systemctl restart tg-relay</code>.",Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.if (!relay) return new Response("unknown relay token\n", { status: 401 });Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose."⚠️ The relay's Claude sign-in expired, so replies to sessions start new sessions instead. On the machine: <code>claude</code>, then /login, then <code>sudo systemctl restart tg-relay</code>.",Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.<summary>Or from a terminal</summary> ```bash bun install ``` ```bash bunx wrangler login ``` ```bash bun run deploy ``` ```bash bunx wrangler secret put BOT_TOFix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.if ! have claude; then curl -fsSL https://claude.ai/install.sh | bash </dev/null; fiFix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.const result = await h.tool(alice, "send_message", { text: "x", session: "../etc/passwd" });Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.elif have yum; then sudo yum install -y -q curl jq </dev/nullFix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.file: { filename: "a.txt", text: "a", upload: true },Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.async function relayToken(): Promise<string> {Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.sudo tee /etc/systemd/system/tg-relay.service >/dev/null <<UNITFix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.{ chat: "Anna", file: { filename: "a.txt", upload: true } },Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.file: { filename: "a.txt", upload: true },Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.this.db.prepare("DELETE FROM upload_nonces WHERE expires_at < ?").bind(nowSeconds()),Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.if ! have claude; then curl -fsSL https://claude.ai/install.sh | bash </dev/null; fiFix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.await relayToken();Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.**ChatGPT** (needs Developer mode: Pro, Business, Enterprise, Edu): Settings → Apps & Connectors →Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.Advanced → Developer mode on, then **Create** with the same URL and **OAuth** authentication.Fix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.Advanced → Developer mode on, then **Create** with the same URL and **OAuth** authentication.Fix: Keep SKILL.md to visible, descriptive text. Remove comments and encoded text that address the agent.… 😱 🎉 🤩 🙏 👌 🕊 🤡 🥱 😍 🐳 💯 🤣 ⚡ 🏆 💔 🤨 😐 🍓 🍾 💋 🖕 😈 😴 😭 🤓 👻 👨💻 👀 🎃 🙈 😇 😨 🤝 ✍ 🤗 🫡 🎅 🎄 ☃ 💅 🤪 🗿 🆒 💘 🙉 🦄 😘 💊 🙊 😎 👾 🤷 😡. …Fix: Keep SKILL.md to visible, descriptive text. Remove comments and encoded text that address the agent.chmod 700 "$DIR/relay.sh"Fix: Request the narrowest permission that works; replace wildcards with the exact paths or hosts.**ChatGPT** (needs Developer mode: Pro, Business, Enterprise, Edu): Settings → Apps & Connectors →Fix: Keep SKILL.md to visible, descriptive text. Remove comments and encoded text that address the agent.["create_upload_url", { chat: "Anna", filename: "a.txt" }, "send_as_user"],Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.["send_file", { chat: "Anna", filename: "a.txt", text: "x" }, "send_as_user"],Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.const token = await relayToken();Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.mkdir -p "$DIR" && chmod 700 "$DIR"Fix: Request the narrowest permission that works; replace wildcards with the exact paths or hosts.chmod 600 "$DIR/env"Fix: Request the narrowest permission that works; replace wildcards with the exact paths or hosts.const token = await relayToken();Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.const token = await relayToken();Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.Cost to the agent
Tokens estimated at four characters each. Skills load their instruction text when triggered; the figure is what that costs.
Known vulnerabilities
Vulnerability advisories (OSV) cover npm and PyPI packages; this registry has no advisory database.
What would make this Verified
18 points to 80 · weights: behavior 45%, static 25%, prompt 15%, publisher 15%- Pipe-to-shell pattern≈ +9 on the totalBuild commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
- Unclaimed publisher≈ +8 on the totalClaim escolhaperfeitani: a verified publisher gets +50 on publisher trust. It is free and usually instant with GitHub sign-in.
- Hidden instructions≈ +6 on the totalRemove HTML comments, zero-width characters and white-on-white text that carry instructions. Everything the agent is meant to read should be visible to the person reading the file.
- Privileged sudo command≈ +4 on the totalBuild commands from fixed arguments; do not interpolate untrusted strings into a shell.
- Credential pass-through configuration≈ +4 on the totalStop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
- Hidden zero-width characters detected≈ +4 on the totalKeep SKILL.md to visible, descriptive text. Remove comments and encoded text that address the agent.