Telegram send video

Instructions

Implementation Reference

• mcp_notify/tgbot.py:85-114 (handler)

  The tg_send_video function is the handler that sends a video via Telegram bot. It accepts video (URL or base64 data URI), cover, chat_id, caption, parse_mode, and reply_to_message_id. It handles base64 decoding for data URIs, then calls bot.send_video() and returns the result as JSON.

  async def tg_send_video(
      video: str = Field(description="Video URL or base64 data URI (e.g., data:video/mp4;base64,..."),
      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)
  
      if video.startswith("data:"):
          match = re.match(r"data:video/([^;]+);base64,(.*)", video)
          if not match:
              return {"error": "Invalid base64 data URL format"}
          try:
              datas = base64.b64decode(match.group(2))
              video = InputFile(io.BytesIO(datas), f"video.{match.group(1)}")
          except Exception as e:
              return {"error": f"Failed to decode base64: {str(e)}"}
  
      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/tgbot.py:85-91 (schema)

  The function signature uses Pydantic Field annotations that serve as the input schema/validation for the tool, defining types, defaults, and descriptions for video, cover, chat_id, caption, parse_mode, and reply_to_message_id.

  async def tg_send_video(
      video: str = Field(description="Video URL or base64 data URI (e.g., data:video/mp4;base64,..."),
      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:81-84 (registration)

  The tool is registered via the @mcp.tool() decorator with title 'Telegram send video' and description 'Send video via telegram bot'. This is inside the add_tools() function which is called from __init__.py.

  @mcp.tool(
      title="Telegram send video",
      description="Send video via telegram bot",
  )