{"$schema":"https://verifymcp.io/schemas/trust-report.json","schemaVersion":1,"license":{"name":"CC BY-NC 4.0","url":"https://creativecommons.org/licenses/by-nc/4.0/"},"generatedAt":"2026-11-21T23:20:05.692Z","url":"https://verifymcp.io/servers/kay0k1-telegram-dev/telegram-dev","markdownUrl":"https://verifymcp.io/servers/kay0k1-telegram-dev/telegram-dev.md","server":{"slug":"kay0k1-telegram-dev","name":"Telegram Dev","registryName":"io.github.Kay0k1/telegram-dev","description":"Current official Telegram and TON docs: Bot API, Mini Apps, MTProto, TDLib, TON Connect, Tolk","registryStatus":"active","deletedAt":null,"statusMessage":null,"liveness":"live","publisher":{"class":"unknown","claimed":false}},"component":{"slug":"telegram-dev","type":"pypi","identifier":"telegram-dev","withdrawn":false,"url":"https://verifymcp.io/servers/kay0k1-telegram-dev/telegram-dev","version":"0.9.0","transport":"stdio","scoredAt":"2026-11-21T06:59:30.170Z"},"score":{"total":79,"tier":"medium","status":"scored","weekDelta":15,"history":[{"date":"2026-11-21","total":79},{"date":"2026-11-20","total":79},{"date":"2026-11-19","total":79},{"date":"2026-11-18","total":64},{"date":"2026-11-17","total":79},{"date":"2026-11-16","total":64},{"date":"2026-11-15","total":64},{"date":"2026-11-14","total":64},{"date":"2026-11-13","total":64},{"date":"2026-11-12","total":79},{"date":"2026-11-11","total":64},{"date":"2026-11-10","total":64}]},"categories":[{"name":"Supply Chain Security","score":100,"verdict":"pass","reasons":["No malware found by supply-chain analysis.","No known CVEs affecting this package version or its production dependencies.","Runs setuptools.build_meta at install time, a recognised build step with no custom scripting around it.","0 of 33 dependencies flagged as unhealthy."],"codes":[{"code":"supplychain.malware_clean","args":{}},{"code":"cve.none","args":{}},{"code":"installscript.allowlisted","args":{"tool":"setuptools.build_meta","hooks":"build_backend"}},{"code":"dephealth.assessed","args":{"deps":"33","unhealthy":"0"}}]},{"name":"Provenance & Transparency","score":97,"verdict":"fail","reasons":["Source repository is publicly reachable at the declared URL.","Cryptographically verified build provenance (signed, bound to Kay0k1/telegram-dev).","Clear OSI-approved license (MIT).","Actively maintained (last published 10 days ago).","Disclosure check failed: no security disclosure policy was found in the source repository."],"codes":[{"code":"provenance.repo_verified","args":{}},{"code":"provenance.verified","args":{"repo":"Kay0k1/telegram-dev"}},{"code":"license.osi","args":{"spdx":"MIT"}},{"code":"maintenance.recent","args":{"age_days":"10"}},{"code":"disclosure.absent","args":{}}]},{"name":"Schema Quality & AI Usability","score":66,"verdict":"fail","reasons":["AI-judged instruction clarity (excellent).","Context-footprint check failed: tool/resource definitions use about 2376 tokens (~237/item across 10 items; 10 tools + 0 resources), over budget; trim descriptions and params.","Usage-examples check failed: none of the tools include examples."],"codes":[{"code":"schema.ai_quality","args":{"band":"excellent"}},{"code":"schema.footprint_heavy","args":{"avg":"237","items":"10","tools":"10","tokens":"2376","resources":"0"}},{"code":"schema.examples_absent","args":{}}]},{"name":"Stability & Change Management","score":0,"verdict":"unverified","reasons":["Stability not yet verified: not enough scan history yet (needs a 30-day window)."],"codes":[{"code":"stability.insufficient_history","args":{}}]},{"name":"Tool Coverage","score":100,"verdict":"pass","reasons":["100% of tools have a non-trivial description (not blank, and not just the tool's name).","100% of tool parameters carry a description."],"codes":[{"code":"toolquality.descriptions","args":{"pct":"100"}},{"code":"toolquality.param_docs","args":{"pct":"100"}}]},{"name":"Tool Safety","score":100,"verdict":"pass","reasons":["No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.","We read all 10 captured tool definition(s), and no name or description among them implies an irreversible operation.","An AI judge read all 11 captured unit(s) of tool text and found none that tries to manipulate the model reading it."],"codes":[{"code":"toolsafety.injection_clean","args":{}},{"code":"toolsafety.destructive_none","args":{"tools":"10"}},{"code":"toolsafety.manipulation_clean","args":{"units":"11","judged":"11"}}]},{"name":"Capabilities","score":100,"verdict":"pass","reasons":["Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28."],"codes":[{"code":"protocol.supported","args":{"latest":"2026-07-28","version":"2025-11-25"}}]}],"inconclusive":["Stability not yet verified: not enough scan history yet (needs a 30-day window)."],"malware":[],"components":[{"slug":"telegram-dev","type":"pypi","identifier":"telegram-dev","withdrawn":false,"score":79,"current":true,"url":"https://verifymcp.io/servers/kay0k1-telegram-dev/telegram-dev","markdownUrl":"https://verifymcp.io/servers/kay0k1-telegram-dev/telegram-dev.md"}],"facts":[{"label":"Registry","value":"pypi"},{"label":"Package","value":"telegram-dev"},{"label":"Version","value":"0.9.0"},{"label":"Transport","value":"stdio"}],"install":{"available":true,"bundleSha256":null},"tools":[{"name":"search_telegram_docs","title":"Search Telegram and TON docs","description":"Find the official documentation sections that answer a Telegram or TON development question.\n\nUse it before writing or reviewing code that calls the Bot API, Mini Apps JS, Telegram API/MTProto, TDLib, TON Connect, Tolk contracts or the aiogram, python-telegram-bot and grammY libraries. Returns up to `limit` sections with page URL, heading, excerpt, `document_offset` and freshness. Excerpts are partial: open the page with `get_telegram_document` at `document_offset` before relying on details. Stale matching pages are re-fetched first. An empty result is not proof that a feature does not exist; if the cache is empty, the response suggests pages to fetch.","inputs":[{"name":"area","type":"string","required":false,"description":"Limit results to one documentation area; empty searches all areas. Core Telegram docs rank above library docs unless the query names a library."},{"name":"limit","type":"integer","required":false,"description":"Maximum number of matching sections to return."},{"name":"query","type":"string","required":true,"description":"Exact API names or short English keywords work best, e.g. 'InlineKeyboardButton style', 'sendVideoNote', 'ton_proof', 'jetton transfer', 'aiogram Router callback_query'. Common Russian feature words…"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":266},{"name":"get_telegram_document","title":"Read an official documentation page","description":"Read the text of an official Telegram, TON or bot-library documentation page, one window at a time.\n\nUse it to read requirements, parameters and limits in full after `search_telegram_docs` found the page, or to load an entry page from `list_telegram_sources` into an empty cache. Do not use it to find which page answers a question: search first. Pages missing from the cache or older than the freshness limit (6 hours by default) are fetched first. Returns title, URL, Markdown `body` for the requested window, `next_offset` (null at the end), `total_characters`, content hash and freshness. If the live source fails, the cached text is returned with `freshness.stale` and `refresh_error` set. The observation date is when this installation read the page, not when Telegram changed it.","inputs":[{"name":"length","type":"integer","required":false,"description":"Number of characters to return."},{"name":"offset","type":"integer","required":false,"description":"Character offset to start from; use a search result's document_offset or the previous next_offset."},{"name":"refresh","type":"boolean","required":false,"description":"Force a live check of the source even if the cached copy is fresh."},{"name":"url","type":"string","required":true,"description":"Official page URL from search results or list_telegram_sources, e.g. https://core.telegram.org/bots/api or https://docs.ton.org/applications/ton-connect/overview. Pages outside the official sources a…"}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":293},{"name":"get_telegram_corpus_status","title":"Cache coverage and freshness","description":"Report how complete and how current the local documentation cache is, as totals.\n\nUse it at the start of a task or when search results look incomplete. Returns `pages`, per-area counts (`families`), crawl queue state (`frontier`), `stale_pages`, last and oldest successful checks, `refresh_policy` and up to 15 recent source `errors`. For the configured entry points use `list_telegram_sources`; for the individual cached pages use `list_telegram_cached_pages`; to answer a question use `search_telegram_docs`. Refreshing is automatic (on read, on search and in a background cycle), so there is no refresh command. Returns page counts per area, crawl queue state, stale page count, last and oldest successful checks, refresh policy and the latest source errors. Indexed pages are not all of Telegram's knowledge: absence from the cache is not evidence that a feature does not exist.","inputs":[],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":198},{"name":"list_telegram_document_revisions","title":"Observed revisions of a page","description":"List the revisions of one documentation page that this installation has observed, newest first.\n\nUse it to see whether a page changed since an earlier read. To read the current text use `get_telegram_document`. Returns `revisions`: a list of {sha, captured_at, characters}, newest first. A page that this installation has never fetched returns an empty list; a URL outside the official sources is rejected with an error. It does not reconstruct history before the page was first fetched here; for Telegram release history use `list_bot_api_changes` or the changelogs (area `releases` or `ton-releases`).","inputs":[{"name":"url","type":"string","required":true,"description":"Official page URL, the same form accepted by get_telegram_document."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":159},{"name":"list_telegram_sources","title":"Official documentation entry points","description":"List the official entry points this server crawls, each with its documentation area.\n\nUse it to find where to start reading for an unfamiliar area (for example the Bot API index, docs.ton.org/llms.txt or a library's docs) and pass the URL to `get_telegram_document`. If you already know the feature or API name, use `search_telegram_docs` instead. Returns `sources`: a list of {url, area} in the configured order (Telegram core docs, then TON, then bot libraries), and a short `scope` note. This is the source configuration, not the cache: `list_telegram_cached_pages` shows what is already stored.","inputs":[],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":149},{"name":"list_telegram_cached_pages","title":"List cached documentation pages","description":"List the documentation pages already stored in the local cache, sorted by URL.\n\nUse it to see which pages of an area are available offline or to pick a page to open with `get_telegram_document`. Filter with `area`, page through results with `offset` and `limit`. Returns `pages` (url, title, area, checked_at, freshness), `total` matching pages and `next_offset` to pass back for the next page (null at the end). It lists stored pages only; to find content by topic use `search_telegram_docs`, and for totals and errors use `get_telegram_corpus_status`.","inputs":[{"name":"area","type":"string","required":false,"description":"Only pages from this documentation area; empty lists all areas."},{"name":"limit","type":"integer","required":false,"description":"Maximum number of pages to return."},{"name":"offset","type":"integer","required":false,"description":"Number of pages to skip, for paging through long lists; use the previous next_offset."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":194},{"name":"get_bot_api_definition","title":"Bot API method or type definition","description":"Return the current definition of one Bot API method or type as structured data.\n\nUse it instead of reading the whole Bot API page when you need a method's parameters or a type's fields: each entry has its type, whether it is required, the description and any allowed values or length limits stated by Telegram, plus the changelog entries that mention it. For behaviour explained in prose elsewhere (formatting, payments, limits pages) use `search_telegram_docs` and `get_telegram_document`. Returns `kind` (method or type), `name`, `url`, `description`, then `params` (methods; with `returns`) or `fields` (types; or `one_of` for union types), plus `changes`, `bot_api_version`, `source`, `checked_at` and `freshness`. An unknown name returns `kind: null` with close-match `suggestions`. Built from the cached official page, refreshed when stale.","inputs":[{"name":"name","type":"string","required":true,"description":"Exact Bot API method or type name, e.g. 'sendMessage', 'InlineKeyboardButton', 'ReplyParameters'. Case-insensitive; close matches are suggested."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":242},{"name":"check_bot_api_call","title":"Check a Bot API call","description":"Check a Bot API request against the current official schema before running or shipping code.\n\nReports errors (unknown method or parameter with suggestions, missing required parameters, wrong types, values outside the documented list, a wrong `type` in union objects such as InputMedia) and warnings (lengths outside documented limits, parameters retired in an older Bot API version with the changelog entry that replaced them, numbers or booleans sent as strings). It does not call Telegram and cannot check permissions, chat state or file contents. Returns `valid` (true when there are no errors), `errors` and `warnings` as lists of {path, message} where path points into params (for example `reply_markup.inline_keyboard[0][0].style`), plus `url`, `bot_api_version` and freshness. An unknown method returns `valid: false` with suggestions. Use `get_bot_api_definition` to read the definitions it checks against.","inputs":[{"name":"method","type":"string","required":true,"description":"Bot API method name, e.g. 'sendMessage'."},{"name":"params","type":"object","required":true,"description":"The request parameters exactly as your code sends them, as a JSON object. Nested objects such as reply_markup may be objects or JSON strings."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":252},{"name":"list_bot_api_changes","title":"Bot API changes by version","description":"List official Bot API changelog entries as structured releases: version, date, link and the individual changes.\n\nUse it when upgrading a bot or a library (\"what changed since 9.0?\"), when a field seems new or missing, or to find when a method or field was added, replaced or removed. Returns `current_version` and `releases`, newest first: each has `version`, `date`, `url` and `changes` ({text, topic, refs: linked methods and types, terms: field and parameter names}). A name that no change mentions returns an empty list. For the full current definition use `get_bot_api_definition`; for TON or library changelogs use `search_telegram_docs` with area `ton-releases` or the library area.","inputs":[{"name":"limit","type":"integer","required":false,"description":"Maximum number of releases when since_version is empty."},{"name":"name","type":"string","required":false,"description":"Only changes that mention this method, type, field or parameter, e.g. 'InlineKeyboardButton' or 'reply_parameters'."},{"name":"since_version","type":"string","required":false,"description":"Only releases newer than this Bot API version, e.g. '9.0'. Empty returns the latest releases."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":247},{"name":"check_telegram_project","title":"Check a bot project","description":"Check every Bot API call in a Python bot project (aiogram, python-telegram-bot, pyTelegramBotAPI, raw HTTP requests) against the current official schema in one run.\n\nUse it after changing an existing bot, before an upgrade, or when asked to review a bot: it reads the whole project locally and returns only findings, so the documentation does not have to enter the context. Errors: values outside the documented list (for example `style=\"red\"`), unknown methods or parameters in raw API requests. Warnings: parameters Telegram retired, with the Bot API version and changelog entry that replaced them; keyword arguments that are neither Bot API parameters nor known library options; bot methods with no Bot API counterpart. It does not run code, follow variables or check required parameters. Returns `findings` ({file, line, severity, call, message}), `errors`, `warnings`, `files_scanned`, declared `libraries` with versions and `bot_api_version`. To check one request instead use `check_bot_api_call`. The same check runs in a shell or CI as `telegram-dev check PATH`.","inputs":[{"name":"exclude","type":"array","required":false,"description":"Glob patterns relative to path to skip, e.g. ['tests/*', 'migrations/*']."},{"name":"max_findings","type":"integer","required":false,"description":"Maximum number of findings to return; totals always count everything."},{"name":"path","type":"string","required":true,"description":"Absolute path to the bot project directory or a single Python file on this machine."}],"outputs":[],"hasOutputSchema":false,"hasExamples":false,"tokenEstimate":305}],"toolsTruncatedAtCapture":false,"diagnostics":{"capturedAt":"2026-11-21T06:59:30.000Z","track":"package","endpoint":null,"declaredUrl":null,"truncated":false,"tls":null,"dnssec":null,"auth":null,"httpsRedirect":null,"transports":[],"provenance":{"outcome":"verified","label":"Verified","reason":"verified","reasonLabel":"Verified","discovery":"attestation_endpoint","discoveryLabel":"Registry attestation endpoint","sourceRepo":null,"attestationSkipped":null,"attestationSkippedLabel":null},"installScripts":[{"hook":"build_backend","tier":"allowlisted"}],"installScriptsTotal":null,"vulnerabilities":[],"vulnerabilitiesTotal":null,"dependencies":{"nodes":33,"partial":false,"deprecated":null,"stale":null,"noRepo":null}},"mismatches":[],"changelog":{"trackingSince":"2026-11-10","recent":[{"id":"chg_01a1f25e-6482-7762-b715-b4ff5d6ad4ff","kind":"check.reverified","summary":"Malware scan (unverified → pass)","materiality":"security","direction":"improvement","scoreDelta":null,"occurredOn":"2026-11-19","url":"https://verifymcp.io/servers/kay0k1-telegram-dev/telegram-dev#chg-chg_01a1f25e-6482-7762-b715-b4ff5d6ad4ff"},{"id":"chg_01a1f25e-6483-7bf6-9f09-0569fceae397","kind":"score.total_changed","summary":"Trust score (64 → 79)","materiality":"functional","direction":"improvement","scoreDelta":15,"occurredOn":"2026-11-19","url":"https://verifymcp.io/servers/kay0k1-telegram-dev/telegram-dev#chg-chg_01a1f25e-6483-7bf6-9f09-0569fceae397"},{"id":"chg_01a1eda4-446f-744e-879e-efe273dcbd9c","kind":"check.unverifiable","summary":"Malware scan (pass → unverified)","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-18","url":"https://verifymcp.io/servers/kay0k1-telegram-dev/telegram-dev#chg-chg_01a1eda4-446f-744e-879e-efe273dcbd9c"},{"id":"chg_01a1eda4-4470-78e9-b47e-445e45ad05c7","kind":"score.total_changed","summary":"Trust score (79 → 64)","materiality":"functional","direction":"regression","scoreDelta":-15,"occurredOn":"2026-11-18","url":"https://verifymcp.io/servers/kay0k1-telegram-dev/telegram-dev#chg-chg_01a1eda4-4470-78e9-b47e-445e45ad05c7"},{"id":"chg_01a1e943-aa67-714e-b787-e2caab115092","kind":"check.reverified","summary":"Malware scan (unverified → pass)","materiality":"security","direction":"improvement","scoreDelta":null,"occurredOn":"2026-11-17","url":"https://verifymcp.io/servers/kay0k1-telegram-dev/telegram-dev#chg-chg_01a1e943-aa67-714e-b787-e2caab115092"},{"id":"chg_01a1e943-aa69-7507-a064-ee6bc4e611e0","kind":"score.total_changed","summary":"Trust score (64 → 79)","materiality":"functional","direction":"improvement","scoreDelta":15,"occurredOn":"2026-11-17","url":"https://verifymcp.io/servers/kay0k1-telegram-dev/telegram-dev#chg-chg_01a1e943-aa69-7507-a064-ee6bc4e611e0"},{"id":"chg_01a1d3ea-5ae5-7c77-91d2-cd5a1a2a0ca4","kind":"check.unverifiable","summary":"Malware scan (pass → unverified)","materiality":"security","direction":"regression","scoreDelta":null,"occurredOn":"2026-11-13","url":"https://verifymcp.io/servers/kay0k1-telegram-dev/telegram-dev#chg-chg_01a1d3ea-5ae5-7c77-91d2-cd5a1a2a0ca4"},{"id":"chg_01a1d3ea-5ae7-7203-a013-4ca50172ee5d","kind":"score.total_changed","summary":"Trust score (79 → 64)","materiality":"functional","direction":"regression","scoreDelta":-15,"occurredOn":"2026-11-13","url":"https://verifymcp.io/servers/kay0k1-telegram-dev/telegram-dev#chg-chg_01a1d3ea-5ae7-7203-a013-4ca50172ee5d"},{"id":"chg_01a1cdec-3da2-7082-8709-faa7803f7d8c","kind":"check.reverified","summary":"Malware scan (unverified → pass)","materiality":"security","direction":"improvement","scoreDelta":null,"occurredOn":"2026-11-12","url":"https://verifymcp.io/servers/kay0k1-telegram-dev/telegram-dev#chg-chg_01a1cdec-3da2-7082-8709-faa7803f7d8c"},{"id":"chg_01a1cdec-3da2-7ad8-9d5d-413d8fde1190","kind":"score.total_changed","summary":"Trust score (64 → 79)","materiality":"functional","direction":"improvement","scoreDelta":15,"occurredOn":"2026-11-12","url":"https://verifymcp.io/servers/kay0k1-telegram-dev/telegram-dev#chg-chg_01a1cdec-3da2-7ad8-9d5d-413d8fde1190"},{"id":"chg_01a1c79e-a10d-743f-8b1c-e5d8bb312932","kind":"score.first_scored","summary":"First indexed and scored","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-10","url":"https://verifymcp.io/servers/kay0k1-telegram-dev/telegram-dev#chg-chg_01a1c79e-a10d-743f-8b1c-e5d8bb312932"},{"id":"chg_01a1c6f9-d385-7e2d-9fab-e56cc1c74c93","kind":"score.first_scored","summary":"First indexed and scored","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-10","url":"https://verifymcp.io/servers/kay0k1-telegram-dev/telegram-dev#chg-chg_01a1c6f9-d385-7e2d-9fab-e56cc1c74c93"},{"id":"chg_01a1c68b-e283-7e7a-8e22-1f3ed02995dd","kind":"score.first_scored","summary":"First indexed and scored","materiality":"functional","direction":"neutral","scoreDelta":null,"occurredOn":"2026-11-10","url":"https://verifymcp.io/servers/kay0k1-telegram-dev/telegram-dev#chg-chg_01a1c68b-e283-7e7a-8e22-1f3ed02995dd"}],"truncated":false,"feedUrl":"https://verifymcp.io/servers/kay0k1-telegram-dev/telegram-dev/changelog.json"},"links":{"html":"https://verifymcp.io/servers/kay0k1-telegram-dev/telegram-dev","markdown":"https://verifymcp.io/servers/kay0k1-telegram-dev/telegram-dev.md","changelogJson":"https://verifymcp.io/servers/kay0k1-telegram-dev/telegram-dev/changelog.json","changelogRss":"https://verifymcp.io/servers/kay0k1-telegram-dev/telegram-dev.xml","external":[{"label":"PyPI project","href":"https://pypi.org/project/telegram-dev/"},{"label":"Socket report","href":"https://socket.dev/pypi/package/telegram-dev"},{"label":"Repository","href":"https://github.com/Kay0k1/telegram-dev"}]}}