A TypeScript implementation of a simple MCP server that exposes datetime information to agentic systems and chat REPLs
Nothing to run from here
Telegram Context is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
94/100
trust score
21
downloads a day
local
runs on your machine
241
downloads in 30d
What it does
Read permitted Telegram chats, retrieve original posts and files, and track changes locally.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user telegram-context-mcp '--' uvx --python 3.12 telegram-context-mcp serve
# 2 — ask your agent for something these tools do
# create_watch, list_watches, get_watch_changes and 33 more
Telegram Context costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Publisher
Installation
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. This one runs on your machine: your client starts Telegram Context as a process under your own user, with your files and your network, so the tool surface below is what it can do to your computer rather than to a server somewhere else. Its scan result is on the Security tab — read the surface before you approve it.
Claude Codedeclared by this listing
This is a public server: you run it yourself and this marketplace is not in the path. You need uv (docs.astral.sh/uv): uvx comes with it. Claude Code registers it in one command; --scope user makes it available in every project. The '--' is in quotes so that PowerShell passes it on.
claude mcp add --scope user telegram-context-mcp '--' uvx --python 3.12 telegram-context-mcp serveReconnect, or start a new session, and the tools appear in the model’s tool list.
Free on mcprush, and it runs from its publisher’s own package: this marketplace is not in the path, so there is no key of ours to hold and no card to add.
What it writes
One config entry your client uses to start the process locally. A local server runs with your file system and your network, which is why it is priced without metering.
What you approve
36 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
Read from its source code. A server that builds its tool list when it starts can list more tools than this.
Create a named on-demand subscription with exactly one source selector.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | yes | — |
| chat_refs | array | no | — |
| folder_ids | no | — | |
| date_from | no | — |
Find saved subscription names, source counts and pending batches after a new session.
Takes no parameters.
Poll a named subscription without managing per-chat tokens.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | yes | — |
| limit | no | — | |
| ack_batch_id | string | no | — |
| save | boolean | no | — |
Confirm a processed batch and atomically advance its subscription positions.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | yes | — |
| batch_id | string | yes | — |
Explicitly delete a subscription, positions and any unacknowledged batch.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | yes | — |
Poll one selected chat for new messages and available recent revisions.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| chat_ref | string | no | — |
| checkpoint | string | no | — |
| limit | no | — | |
| output | no | — | |
| save | boolean | no | — |
Export one selected chat's original history as JSONL or Markdown.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| chat_ref | string | no | — |
| date_from | no | — | |
| date_to | no | — | |
| checkpoint | string | no | — |
| format | no | — | |
| save | boolean | no | — |
Download one explicitly selected attachments[].id, up to 20 MiB.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| attachment_id | string | yes | — |
| save | boolean | no | — |
Check fresh Telegram authorization, connection, discovery policy and read scope.
Takes no parameters.
Find public broadcast channels by a trimmed query of 1..1000 characters.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | yes | — |
| limit | no | — |
Find similar public channels for a required public broadcast source.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| chat_ref | string | yes | — |
| limit | no | — |
Discover folder IDs, names, order and rules. Optional case-insensitive name substring.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | no | — |
List permitted chats, optionally from a union of folders. Page through all results.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | no | — |
| chat_type | no | — | |
| folder_ids | no | — | |
| limit | no | — | |
| cursor | string | no | — |
Read permitted chat metadata by numeric ID, exact @username or t.me[/s]/username URL.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| chat_ref | string | yes | — |
List topics in a permitted forum supergroup by ID, @username or t.me[/s] link.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| chat_ref | string | yes | — |
| query | string | no | — |
| limit | no | — | |
| cursor | string | no | — |
Read a chat's pinned messages, newest first, by ID, @username or t.me[/s] link.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| chat_ref | string | yes | — |
| limit | no | — | |
| cursor | string | no | — |
| topic_id | no | — |
Search permitted chats with early results, sorted within each page by default.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | yes | — |
| chat_ids | no | — | |
| folder_ids | no | — | |
| date_from | no | — | |
| date_to | no | — | |
| sender_id | no | — | |
| content_type | no | — | |
| has_link | boolean | no | — |
| limit | no | — | |
| cursor | string | no | — |
| order | string | no | — |
| ordering | string | no | — |
Read history over [date_from, date_to), or a chat's recent messages if dates are omitted.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| chat_id | no | — | |
| date_from | no | — | |
| date_to | no | — | |
| order | string | no | — |
| limit | no | — | |
| cursor | string | no | — |
| chat_ref | string | no | — |
| topic_id | no | — | |
| chat_ids | no | — | |
| folder_ids | no | — | |
| ordering | string | no | — |
| max_sources | no | — | |
| max_messages | no | — |
Fetch posts by Telegram URL, 'chat_id:message_id', or {chat_id, message_id}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| refs | array | yes | — |
| text_offset | integer | no | — |
| text_limit | integer | no | — |
Read messages from one album around a member's Telegram URL or message reference.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ref | yes | — | |
| scan_limit | integer | no | — |
Read a message, chronological neighbors, and a bounded chain of parent replies.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ref | yes | — | |
| before | integer | no | — |
| after | integer | no | — |
| reply_depth | integer | no | — |
Read replies to a group thread root or comments on a channel post, newest first.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ref | yes | — | |
| limit | no | — | |
| cursor | string | no | — |
No parameter schema on file.
No parameter schema on file.
No parameter schema on file.
No parameter schema on file.
No parameter schema on file.
No parameter schema on file.
No parameter schema on file.
No parameter schema on file.
No parameter schema on file.
No parameter schema on file.
No parameter schema on file.
No parameter schema on file.
No parameter schema on file.
No parameter schema on file.
Free
$0 forever
- Every tool, no call limit
- No card, and mcprush charges nothing for it
- Source published under MIT
- Runs on your machine — nothing of it reaches our gateway
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install Telegram Context or to call it, at any volume.
Call allowance · this installenforced at the gateway
Monthly allowance, in calls
—
—
Alert at 80% · then the tool returns a normal MCP error
Used this month: —
ATrust score 94 / 100
Release 0.8.0 · scanned 6 Nov 2026
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
Threat score100
Client score94
Findings10 threat · 1 capability
Capabilityhigh
Coveragesource
Verificationsource
Surface digestac5283770433ea84b9ac35469a025650a42d3f15778932239498926b7f24d530
Score vectorthreat 100 → client 94
| Term | Level | What it prices | Points |
|---|---|---|---|
| capability-exposure | high | capability blast radius (high) — client exposure if the model is manipulated | −6 |
| verification-discount | source | publisher verification (provenance) — cryptographic build provenance ties the artifact to its source | −0 |
| coverage-honesty | source | inspection depth (source) — how much of the target the scan could see | −0 |
score = clamp(round(threatScore − E_cap − E_ver − E_cov), 0, 100). No model, no opinion, no network call at scoring time: the same methodology version against the same bytes always produces this number, and every line above is a field of the report rather than a summary of it.
What the scan could actually read
A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.
Tool surfaceread
Implementation sourceread
Package metadataread
Live transportnot available
Tools were statically extracted from the published source (36 recovered), not enumerated from a running server. Tool-poisoning, Unicode-smuggling, capability and toxic-flow analysis ran on this inferred surface, but a mis-parsed registration could be missed or mis-attributed, so tool-derived findings are capped below “confirmed”. To grade the real runtime surface, scan the running server: --command "npx -y <package>".
Capability — what it could do if the model were manipulated
Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. high is the level these add up to.
| Tool | Capability tags | Why the tag was assigned |
|---|---|---|
| download_attachment | untrusted-input | untrusted-input: keyword "download" |
| extract_attachment_text | no tags | |
| list_folders | no tags | |
| list_chats | no tags | |
| get_chat | no tags | |
| list_topics | no tags | |
| get_changes | no tags | |
| export_history | no tags | |
| search_public_channels | no tags | |
| get_similar_channels | no tags | |
| get_pinned_messages | no tags | |
| search_messages | untrusted-input | untrusted-input: keyword "fetch" |
| get_history | no tags | |
| get_messages | untrusted-input | untrusted-input: keyword "fetch" |
| get_album | untrusted-input | untrusted-input: keyword "read_message" |
| get_context | no tags | |
| get_thread | untrusted-input | untrusted-input: keyword "fetch" |
| register_file | untrusted-input | untrusted-input: keyword "download" |
| list_files | sensitive-source | sensitive-source: keyword "list_files" |
| get_draft | no tags | |
| list_drafts | no tags | |
| create_draft | no tags | |
| update_draft | no tags | |
| send_message | external-sink | external-sink: keyword "send_message" |
| send_file | no tags | |
| get_send_status | no tags | |
| resolve_recipient | no tags | |
| verify_sent_message | no tags | |
| list_operations | no tags | |
| invoke_button | no tags | |
| get_status | no tags | |
| create_watch | no tags | |
| list_watches | no tags | |
| get_watch_changes | no tags | |
| ack_watch_changes | no tags | |
| delete_watch | no tags |
Toxic-flow graph
The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.
download_attachment → list_files → send_message
A cross-tool exfiltration chain exists: download_attachment → list_files ⇒ send_message.
Supply chain and provenance
Integrityfirst-seen
Surface digestac5283770433ea84
Scanned2026-11-06
This is the first scan of this surface here, so there is nothing yet to compare it against.
Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.
Release history
Always latest — the install command names no version, so it installs the newest release when it runs; the current release on file is 0.8.0. Pin a release below and the command asks for exactly that one.
0.8.0
5 Nov 2026
latestNo release note was published with this version.
0.7.0
5 Nov 2026
No release note was published with this version.
0.6.0
29 Oct 2026
No release note was published with this version.
0.5.1
28 Oct 2026
No release note was published with this version.
0.5.0
undated
- The version this listing was on when mcprush began following its releases. The registry was not asked when it shipped, so this row carries no date.
—
no reviews yet
Who can review
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Sign in to write one
Any signed-in account that does not publish Telegram Context can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
No reviews yet
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.