Cache Manager
The Cache Manager tool (internal name builtin_system_cache) lists Magento cache types and their status, and can clean, flush, enable, or disable cache types. Clean and flush act immediately; enable and disable persist to app/etc/env.php.
Access control
Access to 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. This resource controls whether the tool is visible to the role.
In addition to ACL-based visibility, each write action is authorized against the role's core Magento Cache Management permissions — the same ACL resources the buttons on the admin System -> Cache Management page use:
| Action | Required core permission |
|---|---|
clean | System -> Cache Management -> Flush Magento Cache |
flush | System -> Cache Management -> Flush Cache Storage |
enable / disable | System -> Cache Management -> Toggle Cache Type |
The status action is always available because it is read-only. If the role lacks the required permission for a write action, the action returns an error naming the missing permission.
This tool has no store-config settings. Its write actions are governed entirely by the role's core Cache Management permissions.
When to use
The AI client uses this tool to inspect cache health and to clear caches after configuration or data changes — for example "is the full page cache enabled?", "flush the config cache", or "which cache types are invalidated?". The status action is the starting point: it reports the cache type ids that the other actions take as input.
The flush action clears the entire cache storage, which is heavier than clean. On a shared cache backend it affects everything stored there, not just Magento cache types. Prefer clean unless a full storage flush is specifically required.
Parameters
| Parameter | Description | Type | Required |
|---|---|---|---|
action | The operation to perform. One of status, clean, flush, enable, disable. | string | Yes |
types | Cache type ids to target (e.g. config, full_page, block_html). Optional for clean and flush — omit to target all cache types. Required for enable and disable. | array | Conditional |
The cache type ids passed in types come from the status action. Call status first to discover the available ids.
Example output
The status action returns each cache type with the following fields, plus the cache backend class in use:
| Field | Description |
|---|---|
id | The cache type id (e.g. config, full_page) |
label | The human-readable cache type name |
enabled | Whether the cache type is enabled |
invalidated | Whether the cache type is marked for refresh |
cache_backend | The configured cache backend class |