Skip to content
Agentmart
Submit a tool

Tdl MCP

Read-only Telegram MCP server wrapping the tdl CLI: list chats, read messages, download media.

Connector by rixile9999 · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/rixile9999-tdl-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Read-only Telegram MCP server wrapping the tdl CLI: list chats, read messages, download media.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
2 read · 3 write · 0 delete
Secrets
None asked for
Install scripts
Not scanned yet
Runs as
Node.js package

Tools by what they do 5

Read from the source code; the running server may list different tools.

Read 2 · Look things up without changing anything.

  • tg_chats
  • tg_status

Write 3 · Create, change, send or run things.

  • tg_download
  • tg_download_url
  • tg_messages

Secrets and settings it asks for

Other settings (environment variables or headers).

  • TDL_BIN
  • TDL_NS

Files it touches

  • Any path the agent passes to its tools

Tools (5)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • tg_chatsList Telegram chats

    List the Telegram dialogs (chats/channels/groups/users) visible to the logged-in session, as [{id, type, name, username}]. Use it to find the chat id or @username to pass as `chat` to tg_messages / tg_download. Optional `filter` does a case-insensitive substring match on name/username/id.

  • tg_downloadDownload Telegram media from a chat

    Download media files from one chat (by id or @username) to a local directory and return the absolute paths of newly downloaded files. Use extensions (csv, e.g. 'xlsx,pdf') to fetch only certain file types; since_id for 'everything new after message X'; last_n for 'the latest N media messages' (default 100). Already-present files are skipped (--skip-same).

  • tg_download_urlDownload Telegram media by t.me link

    Download the media of specific Telegram messages given their t.me links (e.g. https://t.me/channel/123) and return the absolute paths of newly downloaded files. Use when you already have message links rather than a chat to scan. Already-present files are skipped (--skip-same).

  • tg_messagesRead recent Telegram messages

    Export recent media messages from one chat (by id or @username) and return them as compact {id, date, file, text} objects — newest range exported via tdl. Use last_n for 'the last N media messages', or since_id to fetch only messages after a known message id (incremental reads). Read-only.

  • tg_statusTelegram session status

    Check whether the local tdl Telegram session is logged in and usable. Call this first if another tg_* tool fails or before starting Telegram work. Never errors — returns {logged_in:false, hint} when the session is missing.

Signals

Stars
0
Forks
0
Open issues
0
Last commit
Oct 16, 2026 (13 days ago)
Last release
Oct 16, 2026 (13 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name
io.github.rixile9999/tdl-mcp
Version
1.1.0
Auth
No auth
Packages
npm tdl-mcp
License
MIT
Repository
github.com/rixile9999/tdl-mcp
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql
Cite this page

Tdl MCP. Agent Mart. https://agentmart.dev/connectors/rixile9999-tdl-mcp (last updated 2026-10-24)