Notify MCP Server

Instructions

Implementation Reference

• mcp_notify/tgbot.py:129-145 (handler)

  The handler function that implements the tg_send_file tool logic. It processes the caption if MarkdownV2 is specified and sends the file as a document via the Telegram bot.

  async def tg_send_file(
      url: str = Field(description="File URL"),
      chat_id: str = Field("", description="Telegram chat id, Default to get from environment variables"),
      caption: str = Field("", description="File 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_document(
          chat_id=chat_id or TELEGRAM_DEFAULT_CHAT,
          document=url,
          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:125-128 (registration)

  Registers the tg_send_file tool with the FastMCP server using the @mcp.tool decorator, providing title and description.

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

• mcp_notify/tgbot.py:130-134 (schema)

  Pydantic Field definitions providing input schema, descriptions, and defaults for the tg_send_file tool parameters.

  url: str = Field(description="File URL"),
  chat_id: str = Field("", description="Telegram chat id, Default to get from environment variables"),
  caption: str = Field("", description="File 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)

  Top-level registration call that invokes add_tools from tgbot module to register all Telegram tools, including tg_send_file.

  tgbot.add_tools(mcp)

• mcp_notify/tgbot.py:24-28 (helper)

  Creates the Telegram Bot instance shared by all tg_* tools, including tg_send_file.

  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