tg-mcp-send-files

Send local files to Telegram chats via MCP server with retries.

Updated Feb 3, 2026
One-click install
npx skills add https://github.com/kvcop/ai-kb-assistant --skill tg-mcp-send-files
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tg-mcp-send-files
Source: https://github.com/kvcop/ai-kb-assistant/tree/main/.codex/skills/tg-mcp-send-files
Command: npx skills add https://github.com/kvcop/ai-kb-assistant --skill tg-mcp-send-files

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables sending one or multiple local files to Telegram through an MCP server, offering asynchronous queuing and retry mechanisms for reliable delivery.

Core Features & Use Cases

  • Asynchronous File Sending: Files are queued and sent without blocking the main agent loop.
  • Batch Sending: Supports sending multiple files with a single caption, optionally as a Telegram album.
  • Retries & Error Handling: Built-in retries handle flaky network or upload issues.
  • Use Case: When you need to send a set of related documents or images to a Telegram chat, especially if the upload might be slow or interrupted, this skill ensures they get there eventually.

Quick Start

Use the tg-mcp-send-files skill to send the files located at /path/to/your/file1.txt and /path/to/your/file2.txt with the caption "Here are your files".

Frequently Asked Questions about tg-mcp-send-files

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send local files to a Telegram chat asynchronously?

To send local files to Telegram asynchronously, use the tg-mcp-send-files Skill to queue file transmissions through an MCP server. This prevents network interruptions from blocking your main agent loop while ensuring reliable delivery.

Can I send multiple files as a Telegram album with a single caption?

Yes, you can send multiple files to Telegram as an album with a single caption. The Skill supports batch sending of related documents or images, handling them together through the MCP server's send_files function.

What is the best way to handle network instability when uploading files to Telegram?

The best way to handle network instability during Telegram file uploads is using an asynchronous queue with automatic retries. This Skill queues files and retries failed transmissions, ensuring delivery even with flaky connections.

Does this Telegram file sending approach work with the MCP server protocol?

Yes, this approach works directly with the MCP server protocol by utilizing its send_files function. It integrates with the Model Context Protocol to transmit local files and optional captions to specified Telegram chats.

Why use an asynchronous queue for sending files to Telegram instead of direct uploads?

An asynchronous queue prevents large or slow file uploads from blocking your main agent process. By handling transmissions in the background with automatic retries, it guarantees robust file delivery without interrupting active workflows.