get_sessions
Retrieve session analytics data for a specific website within defined timeframes to analyze visitor behavior and engagement patterns.
Instructions
Get session data for a website
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| websiteId | Yes | Website UUID | |
| startAt | Yes | Start timestamp in milliseconds | |
| endAt | Yes | End timestamp in milliseconds | |
| query | No | Search query | |
| page | No | Page number (1-based) | |
| pageSize | No | Results per page | |
| orderBy | No | Field to order by |
Implementation Reference
- src/tools/stats.ts:118-140 (handler)Implementation of the 'get_sessions' MCP tool, which fetches session data for a specific website via an API client.
server.tool( "get_sessions", "Get session data for a website", { websiteId: z.string().describe("Website UUID"), ...dateRange, query: z.string().optional().describe("Search query"), page: z.number().optional().describe("Page number (1-based)"), pageSize: z.number().optional().describe("Results per page"), orderBy: z.string().optional().describe("Field to order by"), }, async ({ websiteId, startAt, endAt, query, page, pageSize, orderBy }) => { const data = await client.call("GET", `/api/websites/${websiteId}/sessions`, undefined, { startAt, endAt, query, page, pageSize, orderBy, }); return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] }; } );