{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_vvyfete5qzu9","handle":"slim-tg-mcp","url":"https://wellknown.network/agents/slim-tg-mcp","links":{"self":"https://wellknown.network/agents/slim-tg-mcp/record.json","html":"https://wellknown.network/agents/slim-tg-mcp","markdown":"https://wellknown.network/agents/slim-tg-mcp/record.md","api":"https://wellknown.network/api/v1/agents/slim-tg-mcp","status":"https://wellknown.network/api/v1/agents/slim-tg-mcp/status","claim":"https://wellknown.network/agents/slim-tg-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/slim-tg-mcp/claim.json","badge":"https://wellknown.network/agents/slim-tg-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/slim-tg-mcp/history","tools":"https://wellknown.network/api/v1/agents/slim-tg-mcp/tools"},"ard":{"identifier":"urn:air::server:slim-tg-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"slim-tg-mcp","summary":"Slim Telegram MCP server with skill-based lazy loading, encrypted sessions, and prompt-injection defense","description":"# slim-tg-mcp\n\n[![CI](https://github.com/haoyu-haoyu/slim-tg-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/haoyu-haoyu/slim-tg-mcp/actions/workflows/ci.yml)\n[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](https://github.com/haoyu-haoyu/slim-tg-mcp/blob/main/LICENSE)\n[![Python](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12-blue.svg)](https://www.python.org)\n\nA slim, security-hardened **Telegram MCP server** for [Claude Code](https://claude.com/claude-code) and any MCP-compatible client.\n\n> 一个精简、安全加固的 **Telegram MCP 服务器**，专为 Claude Code 与任何兼容 MCP 的客户端设计。\n\n---\n\n## English\n\n### Why slim-tg-mcp?\n\nThe popular `chigwell/telegram-mcp` exposes **73 tools** — that's roughly\n**11 000 tokens** permanently consumed in every conversation. This project\nkeeps only **8 search/read tools** as MCP and ships every write/admin\noperation as a **lazy-load Skill**. Same capabilities (now with feature\nparity at v0.4.0 across **11 Skills**), **~87 % less context overhead**,\nand a security model designed from day one to survive prompt injection.\n\n### Architecture at a glance\n\n```\n┌───────────────────────┐\n│ Claude Code / Desktop │\n└───────────┬───────────┘\n            │\n   ┌────────┴─────────┐\n   ▼                  ▼\n[Slim MCP — 8 tools]  [Skills — 11 lazy-loaded]\n  search/read           messaging / group-admin (13 ops)\n  download              contacts / media-upload\n  resolve               polls (incl. edit) / scheduling (incl. edit)\n                        profile (incl. 2FA) / export\n                        privacy / folders / stickers-gifs\n   │                  │\n   └─────────┬────────┘\n             ▼\n   [TG Daemon (Unix socket)]\n     ├─ multi-account session pool\n     ├─ AES-GCM session storage + Keychain\n     ├─ prompt-injection sanitizer\n     ├─ flock-based singleton + audit log\n     └─ Telethon (MTProto)\n             ▼\n        Telegram\n```\n\n### What's in the box (v0.4.0)\n\n**Always-loaded MCP tools** (~1.5 k tokens):\n\n| Tool |…","publisher":null,"homepage":null,"repository":null,"version":"0.5.1","license":"Apache-2.0","protocols":["mcp"],"tags":["claude","mcp","skills","telegram","telethon"],"pricing":null,"endpoints":[{"url":"pypi:slim-tg-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"communication.sms-voice","name":"SMS & Voice","confidence":1,"provenance":"declared"}],"categories":["communication"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"slim-tg-mcp","registry":"pypi","observedAt":"2026-10-28T22:24:40.307Z","publishedAt":"2026-04-28T22:06:53.524097Z","latestVersion":"0.5.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"slim-tg-mcp","url":"https://pypi.org/project/slim-tg-mcp/","firstSeenAt":"2026-09-10T12:22:33.671Z","fetchedAt":"2026-10-28T22:23:54.851Z","normalizedAt":"2026-10-28T22:23:54.851Z"}]},"firstSeenAt":"2026-09-10T12:22:33.671Z","updatedAt":"2026-10-28T22:24:40.307Z"}