Summary:

When creating a main menu item for a custom entity you must make sure the tab group caption matches the entity name.

Symptoms:

If the tab group caption is different to the entity name then the right click context menu will not work on that menu item.

Solution:

Make sure the caption is the same as your entity name.