Tool

list_segments

List segments

Read-onlyIdempotent

SurfacesChat agentMCPCLI

List an audience's SAVED segments (rule-based and static) with live member counts. Use to resolve a segment by name (e.g. 'active customers') before targeting a campaign at it via segmentId. For an ad-hoc, unsaved condition check use preview_segment instead.

CLI: tinbox list-segments

Parameters

Name	Type	Required	Description
`audienceId`	string	yes	The audience whose segments to list (from list_audiences).

Example

json

{
  "audienceId": "aud_…"
}