umami-mcp

Instructions

Implementation Reference

• src/tools/sessions.ts:73-91 (handler)

  The handler and registration for "get_session_data_values" tool.

  server.tool(
    "get_session_data_values",
    "Get session data values (aggregated counts for session properties) for a website",
    {
      websiteId: z.string().describe("Website UUID"),
      startAt: z.number().describe("Start timestamp in milliseconds"),
      endAt: z.number().describe("End timestamp in milliseconds"),
      propertyName: z.string().optional().describe("Filter by property name"),
    },
    async ({ websiteId, startAt, endAt, propertyName }) => {
      const data = await client.call(
        "GET",
        `/api/websites/${websiteId}/session-data/values`,
        undefined,
        { startAt, endAt, propertyName }
      );
      return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
    }
  );