store/list-low-stock lists published products that track stock and are at or below a threshold you choose, including those already at zero.
Read-only. It is the reordering list.
At a glance
| Ability | store/list-low-stock |
| Toolset | WooCommerce — toolset/woocommerce |
| Group | WooCommerce › Inventory |
| 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
The threshold is yours rather than the store’s. WooCommerce has its own low-stock setting, but it drives notification emails and is usually set once and forgotten — which makes it a poor answer to “what should we order this week”, where the sensible number depends on how fast the thing sells.
Products that do not track stock are excluded, because they have no number to be low. That includes most virtual and downloadable products and anything set to unlimited.
Zero-stock products are included rather than separated out. They are the most urgent entries on the list, not a different question.
The examination limit caps how many products are inspected, not how many are returned low — worth raising on a large catalogue.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
threshold | integer | No | Quantity at or below which a product counts as low. |
limit | integer | No | How many products to examine. |
What comes back
| Name | Type | What it is |
|---|---|---|
threshold | integer | The threshold used. |
products | array | The products at or below it, with their stock levels. |
count | integer | How many were found. |
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 do we need to reorder? Anything with five or fewer left.
It resolves to one call:
{
"ability": "store/list-low-stock",
"parameters": {
"threshold": 5
}
}Worth knowing
- Only products that track stock appear. Unlimited products have no number to be low.
- Zero-stock products are included.
- The limit caps how many products are examined, not how many come back.
- Read-only.
Related abilities
- Adjust Stock — restock what is low
- Get Stock — one product in detail
- List Top Products — what is selling fast enough to matter
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category