PyWA MCP Server

Instructions

Implementation Reference

• tools/messaging.py:463-511 (handler)

  The indicate_typing tool handler function that shows a typing indicator to WhatsApp users. It takes a message_id and optional sender parameter, calls wa_client.indicate_typing(), and returns a success status dictionary. The function includes comprehensive documentation about the typing indicator's behavior (max 25 seconds, dismissed on message send, best practices).

  @mcp.tool()
  async def indicate_typing(
      message_id: str,
      *,
      sender: Optional[str] = None,
  ) -> dict:
      """
      Show typing indicator to WhatsApp user.
      
      This marks a message as read and displays a typing indicator to show
      the user that you are preparing a response. Best practice when it will
      take a few seconds to respond.
      
      IMPORTANT NOTES:
      - Typing indicator lasts max 25 seconds or until you send a message
      - Only use if you are actually going to respond  
      - Will be dismissed when you send the next message
      - Improves user experience for delayed responses
      
      EXAMPLE:
      {
        "message_id": "wamid.HBgNMjc2NTY4NjY5MDUVAgARGBI5QTNDMEM3RjVBMzY2Q0Y4AA=="
      }
      
      Args:
          message_id: The WhatsApp message ID to respond to (from incoming message)
          sender: Optional phone ID (defaults to client's phone ID)
      
      Returns:
          Dictionary with success status
      """
      try:
          result = wa_client.indicate_typing(
              message_id=message_id,
              sender=sender,
          )
          
          logger.info(f"Typing indicator shown for message {message_id}")
          # SuccessResult has a success boolean attribute
          success_status = getattr(result, 'success', bool(result))
          
          return {
              "success": True, 
              "typing_indicated": success_status,
              "message_id": message_id
          }
      except Exception as e:
          logger.error(f"Failed to indicate typing: {str(e)}")
          return {"success": False, "error": str(e)}