MCPToolsCDP tools
Customer Events
Get a profile's raw event history
cdp_customer_events
Returns a profile's raw event history, scoped to your brand. Filter by event type and an ISO time window, and page with limit/offset or the opaque cursor. 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. | — |
eventType | string | No | Restrict to a single event type (e.g. view). | — |
from | string | No | ISO-8601 inclusive lower bound on event time. | — |
to | string | No | ISO-8601 inclusive upper bound on event time. | — |
limit | number | No | Page size (1–100). | 25 |
offset | number | No | Offset for offset-based paging. | 0 |
cursor | string | No | Opaque nextCursor from a previous page, to continue enumerating. | — |
Returns
list— the profile's events for the given filters.totalSize,offset,pageSize— paging metadata.nextCursor— pass back ascursorto walk the next page, ornullwhen exhausted.
Example prompts
Show me the events for profile abc123 in the last 7 daysList product_viewed events for that profileNotes
- An out-of-scope profile id — or another shop's events on a merged profile — returns an empty list, never another brand's data and never an error.
- Events are read through the brand-scoped query path, so results always cover your brand only.