List Segments

cdp_list_segments

Lists the saved audience segments owned by your brand. Use cdp_get_segment for a segment's stored condition and cdp_segment_members for its membership.

Read-only and scoped to your brand.

Parameters

This tool takes no parameters.

Returns

• list — an array of { id, name, description?, scope }, one per segment your brand owns.
• scope — your brand's shop domain.

Example prompts

List my saved segments

What audiences do I have set up?

Notes

• Only your brand's segments are returned — never another brand's.
• This tool is read-only. Creating, updating, and archiving segments is a separate write operation exposed by cdp_segment_write, which is gated behind the CDP write-tier (beta) entitlement.