Skip to main content

Cache Manager

The Cache Manager tool inspects and manages Magento cache types. It can list all cache types with their status, and clean, flush, enable, or disable them.

Access control

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

Each write action is additionally authorized against the role's core Magento cache permissions:

  • clean requires System -> Cache Management -> Flush Magento Cache
  • flush requires System -> Cache Management -> Flush Cache Storage
  • enable / disable require System -> Cache Management -> Toggle Cache Type

The status action is always available. If a role lacks the permission for a requested write action, the tool returns an error naming the missing permission.


When to use

The AI assistant uses this tool to answer questions like "which caches are invalidated?" or to act on requests such as "clean the configuration cache" or "flush the full page cache".


Parameters

ParameterDescriptionTypeRequired
actionAction to perform: status, clean, flush, enable, or disable.stringYes
typesArray of cache type ids to act on. Optional for clean and flush (omit to apply to all cache types); required for enable and disable.arrayDepends on action
warning

flush clears the entire cache storage, including cache used by other applications that share the same backend. Prefer clean, which only removes items tagged by Magento.


Settings

The Cache Manager has no store-configuration settings. Its write actions are governed entirely by the role's core Cache Management permissions described under Access control.


Example output

The status action returns one entry per cache type, plus the configured cache backend class:

FieldDescription
idThe cache type id (e.g. config, full_page)
labelThe human-readable cache type name
enabledWhether the cache type is enabled
invalidatedWhether the cache type is currently invalidated and needs refreshing