aiogram-mcp

Instructions

Implementation Reference

• aiogram_mcp/tools/messaging.py:191-220 (handler)

  The delete_message tool handler implementation, decorated with @mcp.tool, handles the deletion of a message via the Telegram Bot API within a chat.

  @mcp.tool
  async def delete_message(chat_id: int, message_id: int) -> OkResult:
      """Delete a message from a chat."""
      if not ctx.is_chat_allowed(chat_id):
          result = OkResult(ok=False, error=f"Chat {chat_id} is not allowed.")
          if ctx.audit_logger:
              ctx.audit_logger.log(
                  "delete_message",
                  {"chat_id": chat_id, "message_id": message_id},
                  result.ok,
                  result.error,
              )
          return result
  
      try:
          if ctx.rate_limiter:
              await ctx.rate_limiter.acquire()
          await ctx.bot.delete_message(chat_id=chat_id, message_id=message_id)
          result = OkResult(ok=True)
      except (TelegramBadRequest, TelegramForbiddenError) as exc:
          result = OkResult(ok=False, error=str(exc))
  
      if ctx.audit_logger:
          ctx.audit_logger.log(
              "delete_message",
              {"chat_id": chat_id, "message_id": message_id},
              result.ok,
              result.error,
          )
      return result