MCPToolsCDP tools
Segment Members
List a segment's members, or just its size
cdp_segment_members
Lists the members of a saved segment owned by your brand, or — with countOnly — just the membership size. Pass the segmentId from cdp_list_segments; page with limit/offset, or pass the opaque cursor to walk deep pages.
Read-only and scoped to your brand.
Parameters
| Name | Type | Required | Description | Default |
|---|---|---|---|---|
segmentId | string | Yes | The segment id from cdp_list_segments. | — |
limit | number | No | Page size (1–100). | 25 |
offset | number | No | Offset for offset-based paging. | 0 |
cursor | string | No | Opaque deep-pagination position (the last member itemId of the previous page). | — |
countOnly | boolean | No | When true, return only the membership count and skip reading a page. | false |
Returns
When listing members:
segmentId,list— the member profiles.identities— a map of profileitemId→ derived identity (email / phone / name).totalSize,offset,pageSize— paging metadata.nextCursor— the last memberitemIdwhen a full page was returned (pass it back ascursorto walk the next page), ornullwhen the page is exhausted.scope— your brand's shop domain.
When countOnly is true:
segmentId,count,scope.
Example prompts
How many customers are in my "VIP" segment?List the members of segment seg_123Notes
- Only in-scope profiles are ever returned.
- An id that isn't one of your brand's segments returns an empty page (or not-found when
countOnly), never another brand's members. - Use
countOnlywhen you only need the size — it skips reading a profile page.