MCPToolsCDP tools
Customer Sessions
Get a profile's web session history
cdp_customer_sessions
Returns a profile's web session history, scoped to your brand. Page with limit/offset. Pass a profile itemId from cdp_search_customers.
Read-only and scoped to your brand.
Parameters
| Name | Type | Required | Description | Default |
|---|---|---|---|---|
profileId | string | Yes | The CDP profile id (itemId) from cdp_search_customers. | — |
limit | number | No | Page size (1–100). | 25 |
offset | number | No | Offset for offset-based paging. | 0 |
Returns
list— the profile's sessions.totalSize,offset,pageSize— paging metadata.
Example prompts
Show me the recent sessions for profile abc123How many sessions has that profile had?Notes
- Sessions are post-filtered to your brand's shop domain, so an out-of-scope profile id — or another shop's sessions on a merged profile — returns an empty list, never another brand's data.
- This tool takes no filters or cursor — page with
limit/offset.