Indexer
The Indexer tool (internal name builtin_system_indexer) lists Magento indexers — status, mode (Update on Save / Update by Schedule), last update, and pending backlog — and can invalidate indexers to trigger asynchronous reindexing via cron.
Access control
Access to 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. This resource controls whether the tool is visible to the role.
The status action is always available. The invalidate action is gated by two layers, both of which are required:
- The store-config switch Allow Index Invalidation (default disabled) — see Settings.
- The role's core System -> Index Management -> Invalidate index (
Magento_Indexer::invalidate) permission.
If either layer denies access, the invalidate action is unavailable.
When to use
The AI client uses this tool to check whether indexes are valid or backed up, and to trigger a rebuild after data changes — for example "are any indexes invalid?" or "reindex the product price index".
Reindexing is asynchronous by design. The invalidate action marks indexes as invalid; the indexer_reindex_all_invalid cron job then rebuilds them. After invalidating, poll status until the indexes report as valid. If invalidated indexes do not progress, use the Cron Checker tool to verify the scheduler is running.
Parameters
| Parameter | Description | Type | Required |
|---|---|---|---|
action | The operation to perform. One of status, invalidate. | string | Yes |
indexer_id | status action only. Narrow the result to a single indexer. | string | No |
indexer_ids | invalidate action only. A non-empty array of indexer ids to invalidate. There is no "all" shortcut. | array | Conditional |
Example output
The status action returns each indexer with its current status, mode, last update time, and pending backlog count.
Settings
The Indexer settings are located at Stores -> Configuration -> Mirasvit Extensions -> MCP Tools -> Tools -> Indexer.
To apply changes, clear the Magento cache after modifying these settings.
- Allow Index Invalidation (Yes/No, default No): when set to No, the tool is read-only and the
invalidateaction is unavailable. When set to Yes, theinvalidateaction becomes available to roles that also hold the core Invalidate index permission.