Return one visitor's interaction timeline for a site, newest first, with keyset pagination. Each item is { event_key, occurred_at, page_path, payload_summary } where payload_summary is a schema-known scalar projection (never raw payload bytes). Pagination cursor is opaque; pass the returned `next_before` back as `before`. A `visitor_id` that does not belong to the given `site_id` (typo, wrong account, deleted row) returns E_FORBIDDEN — not an empty items list — so a retry with the same wrong id will keep failing. Pro plan required — non-Pro accounts get E_FORBIDDEN with plan/feature details. Read-only.
| Name | Type | Required | Description |
|---|---|---|---|
| site_id | uuid | Yes | — |
| visitor_id | uuid | Yes | — |
| limit | integer | Yes | — |
| before | string | No | — |
| Name | Type | Description |
|---|---|---|
| items | array of object | — |
| has_more | boolean | — |
| next_before | string or null | — |
get_visitor_activity is called by an AI assistant connected to Sentway over MCP, not by hand. Point the assistant at the Sentway MCP endpoint and complete the OAuth flow, and the tool becomes available in the same session as the other 38 Sentway tools. See connecting over MCP.