tg_send_audio
Send audio files to Telegram chats using a bot, supporting captions, reply threads, and multiple parsing modes for notifications.
Instructions
Send audio via telegram bot
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| audio | Yes | Audio URL | |
| chat_id | No | Telegram chat id, Default to get from environment variables | |
| caption | No | Audio 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:145-154 (handler)Executes the tool logic: optionally processes caption with MarkdownV2 using telegramify_markdown, sends audio via bot.send_audio with appropriate parameters, and returns the JSON response.if parse_mode == TELEGRAM_MARKDOWN_V2: caption = telegramify_markdown.markdownify(caption) res = await bot.send_audio( chat_id=chat_id or TELEGRAM_DEFAULT_CHAT, audio=audio, 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:138-144 (schema)Input schema defined using Pydantic Field annotations for the tool parameters: audio URL, chat_id, caption, parse_mode, and reply_to_message_id.async def tg_send_audio( audio: str = Field(description="Audio URL"), chat_id: str = Field("", description="Telegram chat id, Default to get from environment variables"), caption: str = Field("", description="Audio 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:134-137 (registration)Registers the tg_send_audio tool with FastMCP using the @mcp.tool decorator inside the add_tools function.@mcp.tool( title="Telegram send audio", description="Send audio via telegram bot", )
- mcp_notify/__init__.py:20-20 (registration)Top-level registration call in the main MCP server setup, invoking tgbot.add_tools(mcp) to register the tg_send_audio tool.tgbot.add_tools(mcp)
- mcp_notify/tgbot.py:56-60 (helper)Initializes the shared Telegram Bot instance used by tg_send_audio and other tg_ tools, configured with environment variables for token and base URLs.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