Skip to main content

Indexer

The Indexer tool lists Magento indexers with their status, mode, last update time, and backlog, and can invalidate indexers to schedule an asynchronous rebuild.

Access control

Visibility of this tool is controlled by the MCP Tools -> Built in -> System -> Indexer ACL resource. Enable or disable it in System -> Permissions -> User Roles -> [Role] -> Role Resources.

The invalidate action is gated by both of the following:

  1. The store-configuration Allow Index Invalidation switch (disabled by default), see Tools Settings.
  2. The role's core System -> Index Management -> Invalidate index permission.

The status action is always available.


When to use

The AI assistant uses this tool to answer questions like "which indexers are out of date?" or to act on requests such as "invalidate the product price index".


Parameters

ParameterDescriptionTypeRequired
actionAction to perform: status or invalidate.stringYes
indexer_idstatus only. Limit the report to a single indexer.stringNo
indexer_idsinvalidate only. Non-empty array of indexer ids to invalidate.arrayYes (for invalidate)

Asynchronous by design

The invalidate action does not rebuild indexes directly. It marks the requested indexes as invalid; Magento cron then rebuilds them on its next run. To track progress, call action=status again and watch the mode and backlog.

note

If invalidated indexes never rebuild, cron may not be running. Use the Cron Checker tool to confirm cron health.


Settings

The Allow Index Invalidation switch is located at Stores -> Configuration -> Mirasvit Extensions -> MCP Tools -> Tools -> Indexer. See Tools Settings for details.