Telegram send video

Instructions

Implementation Reference

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

  The `tg_send_video` async function that executes the tool logic. It accepts a video URL or base64 data URI, optional cover, chat_id, caption, parse_mode, and reply_to_message_id. It handles base64 decoding, 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:81-84 (registration)

  The `@mcp.tool()` decorator registering the tool with title 'Telegram send video' and description 'Send video via telegram bot'.

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

• mcp_notify/tgbot.py:86-92 (schema)

  Pydantic Field definitions for the tool's parameters: video (str), cover (str), chat_id (str), caption (str), parse_mode (str), reply_to_message_id (int).

      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/__init__.py:20-20 (registration)

  Registration call `tgbot.add_tools(mcp)` which adds all telegram tools including tg_send_video to the MCP server.

  tgbot.add_tools(mcp)