rank-math/get-content-ai-status reports whether Content AI is usable: module state, whether a Rank Math account is connected, the current plan, and the remaining credit balance with usage details.
It reads locally and spends no credits.
At a glance
| Ability | rank-math/get-content-ai-status |
| Toolset | Rank Math — toolset/rank-math |
| Group | Rank Math › Content AI |
| 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
Content AI runs on credits bought from Rank Math. Spending somebody’s credits is not something to do as a side effect of a request, so every ability here states plainly whether it spends any, and the ones that do are gated.
So this is the call before any of the spending ones. Knowing the balance in advance turns “the request failed” into “there are no credits”, which is a different problem with a different fix.
The module state and connection state are separate failures with the same symptom. A module that is off and an account that is not connected both produce Content AI abilities that do not work, and distinguishing them takes one read.
Credits do not refund. A request that spends them and returns something unhelpful has still spent them, which is why the balance is worth checking rather than discovering.
Input
This ability takes no input.
What comes back
| Name | Type | What it is |
|---|---|---|
module_active | boolean | Whether the Content AI module is on. |
connected | boolean | Whether a Rank Math account is connected. |
plan | string | The current plan. |
credits | object | The remaining balance and usage details. |
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:
Do we have Content AI credits left?
It resolves to one call:
{
"ability": "rank-math/get-content-ai-status",
"parameters": {}
}Worth knowing
- Spends nothing. Call it before anything that does.
- Module off and account not connected are different problems with the same symptom.
- Credits do not refund.
Related abilities
- Research Keyword with Content AI — the ability that spends
- Update AI Visibility Brand or Query — the other one
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category