mailerpress-pro/list-segment-products lists the WooCommerce products available as filter values inside a segment condition.
It is the companion to the condition metadata, for the conditions that take a product.
At a glance
| Ability | mailerpress-pro/list-segment-products |
| Toolset | MailerPress Pro — toolset/mailerpress-pro |
| Group | MailerPress Pro › Segments |
| Requires | AcrossAI Pro, plus MailerPress with its Pro add-on active on the site |
| Capability | manage_options |
| Safety | Read-only — changes nothing |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Pro 0.9.16 and later |
How it works
A purchase-based condition — bought this, did not buy this — needs a product identifier, and the identifier MailerPress expects is not necessarily the product ID you would use elsewhere.
So this returns the values in the form the segment evaluator accepts, which removes a class of segment that is syntactically valid and matches nobody because the product reference is wrong.
It is also the practical inventory for building purchase segments: what can be segmented on, rather than what exists in the shop. Products that have never been bought are of limited use as a segment condition.
Only meaningful on a site with WooCommerce. Without it the condition types that use these do not exist either.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
search | string | No | Search on the product name. |
What comes back
| Name | Type | What it is |
|---|---|---|
products | array | Products usable as segment condition values. |
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:
Which products can I segment customers by?
It resolves to one call:
{
"ability": "mailerpress-pro/list-segment-products",
"parameters": {}
}Worth knowing
- The identifier here is what the segment evaluator accepts.
- A wrong product reference produces a valid segment matching nobody.
- Only meaningful with WooCommerce active.
- Read-only.
Related abilities
- MailerPress Pro Segment Condition Metadata — which conditions take these
- MailerPress Pro Create Segment — use them
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category