rank-math/get-role-capabilities returns the Rank Math capability matrix: the sixteen capabilities it defines with their labels, and which roles currently hold each one.
It is the diagnosis for an insufficient_capability failure from another Rank Math ability.
At a glance
| Ability | rank-math/get-role-capabilities |
| Toolset | Rank Math — toolset/rank-math |
| Group | Rank Math › Modules & Permissions |
| Requires | Rank Math SEO, active on the site |
| Capability | manage_options |
| Safety | Read-only — changes nothing |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Abilities Manager 0.0.34 and later |
How it works
Rank Math defines its own capabilities, and an insufficient_capability failure from any ability here is about those rather than about being an administrator. rank-math/get-role-capabilities is the diagnosis.
The capabilities are ordinary WordPress capabilities with a rank_math_ prefix, which means the generic users/add-role-capability and users/remove-role-capability abilities grant and revoke them. There is no special mechanism, and this suite deliberately does not duplicate those writers.
Sixteen separate capabilities is finer-grained than most plugins, and the granularity is the point: a role can be allowed to edit a post’s SEO meta without being allowed to touch the redirection table or the sitemap settings.
It also means a permission failure names something specific, and reading the matrix turns that name into “this role does not have it” rather than a general permissions mystery.
Input
This ability takes no input.
What comes back
| Name | Type | What it is |
|---|---|---|
capabilities | array | Each capability with its label and the roles that hold it. |
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:
Why can our editors not change redirections?
It resolves to one call:
{
"ability": "rank-math/get-role-capabilities",
"parameters": {}
}Worth knowing
- Sixteen capabilities, granted and revoked with the generic user abilities.
rank_math_*are ordinary WordPress capabilities.- The answer to an
insufficient_capabilityfailure. - Read-only.
Related abilities
- Reset Rank Math Role Capabilities — start over
- List Rank Math Modules — the other common cause of a failure
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category