rank-math/run-maintenance-tool runs one Rank Math maintenance tool. It refuses without confirm: true.
The tools range from clearing a cache to deleting every redirection on the site.
Before you run it
Every tool here changes or removes data irreversibly, and they differ enormously in consequence — clearing a transient cache and deleting every redirection on the site are the same call with a different parameter. Some tools continue in the background after responding, so check the async flag rather than reading a success as “finished”. Discover what is runnable with rank-math/get-status and panel=tools.
At a glance
| Ability | rank-math/run-maintenance-tool |
| Toolset | Rank Math — toolset/rank-math |
| Group | Rank Math › Status, Backups & Tools |
| Requires | Rank Math SEO, active on the site |
| Capability | manage_options |
| Safety | Destructive — deletes stored values, and refuses to run without confirm: true |
| Repeatable | Not idempotent — each call changes the row set, so re-running is not a no-op |
| Ships in | AcrossAI Abilities Manager 0.0.34 and later |
How it works
Some tools finish within the request. Others — reindexing analytics, rebuilding tables on a large site — schedule work and continue in the background after responding.
For those, a successful response means the work started. Reading it as “done” is how a site gets a second tool run on top of a first one that is still going, which on table rebuilds is not a good idea.
So the response carries an async flag. When it is set, the work is ongoing and the result is not yet knowable from here.
The catalogue is install-specific. rank-math/get-status with panel=tools lists what is actually runnable, which is how you find out that the Yoast block converter is offered only when legacy Yoast blocks exist.
The destructive ones deserve naming: delete_log clears the entire 404 log, and the redirection tool deletes every redirection on the site — both unrecoverable, both one parameter away from a harmless cache clear.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
tool | string | Yes | Which tool to run, from rank-math/get-status with panel=tools. |
confirm | boolean | Yes — must be true | The irreversibility gate. Without it the call is refused before anything is touched. |
What comes back
| Name | Type | What it is |
|---|---|---|
tool | string | The tool that was run. |
async | boolean | Whether the work continues in the background. |
result | object | What the tool reported. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
Clear the Rank Math transients.
It resolves to one call:
{
"ability": "rank-math/run-maintenance-tool",
"parameters": {
"tool": "clear_transients",
"confirm": true
}
}Worth knowing
- Check
async. A success can mean “started”, not “finished”. - The tool list is install-specific — read it first.
- The 404-log and redirection tools delete everything of their kind, unrecoverably.
- Take a settings backup before running anything structural.
Related abilities
- Get Rank Math Status — discover the runnable tools
- Create Rank Math Settings Backup — before anything structural
- Delete Rank Math 404 Log Entries — the selective alternative
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category