tg_send_video
Send video notifications through Telegram bots by providing a video URL, optional caption, and chat ID. This tool enables automated video sharing within the MCP notification server.
Instructions
Send video via telegram bot
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| video | Yes | Video URL | |
| cover | No | Cover for the video in the message. Optional | |
| chat_id | No | Telegram chat id, Default to get from environment variables | |
| caption | No | Video caption, 0-1024 characters after entities parsing | |
| parse_mode | No | Mode for parsing entities in the caption. [text/MarkdownV2] | |
| reply_to_message_id | No | Identifier of the message that will be replied to |
Implementation Reference
- mcp_notify/tgbot.py:81-99 (handler)The core handler function for the 'tg_send_video' tool. It processes the input parameters, handles MarkdownV2 parsing for captions if specified, and uses the Telegram Bot API's send_video method to send the video to the specified chat.async def tg_send_video( video: str = Field(description="Video URL"), cover: str = Field("", description="Cover for the video in the message. Optional"), chat_id: str = Field("", description="Telegram chat id, Default to get from environment variables"), caption: str = Field("", description="Video caption, 0-1024 characters after entities parsing"), parse_mode: str = Field("", description=f"Mode for parsing entities in the caption. [text/MarkdownV2]"), reply_to_message_id: int = Field(0, description="Identifier of the message that will be replied to"), ): if parse_mode == TELEGRAM_MARKDOWN_V2: caption = telegramify_markdown.markdownify(caption) res = await bot.send_video( chat_id=chat_id or TELEGRAM_DEFAULT_CHAT, video=video, cover=cover or None, caption=caption or None, parse_mode=parse_mode if parse_mode in [TELEGRAM_MARKDOWN_V2] else None, reply_to_message_id=reply_to_message_id or None, ) return res.to_json()
- mcp_notify/__init__.py:20-20 (registration)Registers all tools from the tgbot module, including 'tg_send_video', by calling add_tools on the FastMCP instance.tgbot.add_tools(mcp)
- mcp_notify/tgbot.py:82-88 (schema)Pydantic Field definitions providing input schema validation and descriptions for the tg_send_video tool parameters.video: str = Field(description="Video URL"), cover: str = Field("", description="Cover for the video in the message. Optional"), chat_id: str = Field("", description="Telegram chat id, Default to get from environment variables"), caption: str = Field("", description="Video caption, 0-1024 characters after entities parsing"), parse_mode: str = Field("", description=f"Mode for parsing entities in the caption. [text/MarkdownV2]"), reply_to_message_id: int = Field(0, description="Identifier of the message that will be replied to"), ):
- mcp_notify/tgbot.py:77-80 (registration)The @mcp.tool decorator registers the tg_send_video function as an MCP tool with its title and description.@mcp.tool( title="Telegram send video", description="Send video via telegram bot", )
- mcp_notify/tgbot.py:24-28 (helper)Initializes the shared Telegram Bot instance used by tg_send_video and other tg_send_* tools, reading configuration from environment variables.bot = Bot( TELEGRAM_BOT_TOKEN, base_url=f"{TELEGRAM_BASE_URL}/bot", base_file_url=f"{TELEGRAM_BASE_URL}/file/bot", ) if TELEGRAM_BOT_TOKEN else None