store/get-tax-rates reports whether tax calculation is switched on, whether prices are entered including tax, and every tax class with its rates by country and state.
It reports what is configured and nothing more.
At a glance
| Ability | store/get-tax-rates |
| Toolset | WooCommerce — toolset/woocommerce |
| Group | WooCommerce › Store Configuration |
| Requires | WooCommerce, 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
What a rate ought to be is a question about the business — where it is established, what it sells, which thresholds it has crossed — rather than a question about the software. This ability has no view on it.
That restraint matters more here than in most places, because a wrong tax rate does not produce an error. It produces an under-charged tax bill that nobody notices for a year, and then notices all at once.
The two flags at the top are the ones that catch people out. Tax calculation switched off makes every rate below it inert — the rates are all still there, correctly configured, and no tax is charged on anything. And prices-include-tax changes what every price in the shop means, so reading a rate table without it is reading half the picture.
Rates are grouped by class, because a store with reduced-rate or zero-rate products has more than one table and the product decides which applies.
Input
This ability takes no input.
What comes back
| Name | Type | What it is |
|---|---|---|
taxes_enabled | boolean | Whether tax is calculated at all. |
prices_include_tax | boolean | Whether entered prices already include tax. |
classes | array | Each tax class with its rates by country and state. |
note | string | A statement that this reports configuration only. |
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:
What tax is this store charging, and where?
It resolves to one call:
{
"ability": "store/get-tax-rates",
"parameters": {}
}Worth knowing
- Tax switched off makes every rate inert while leaving them configured.
- Prices-include-tax changes what every price in the shop means.
- What a rate ought to be is a business question. This reports only.
Related abilities
- Add Tax Rate — record a rate
- Get Store Settings — the wider configuration
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category