umami-compass 0.1.0

package/dist/mcp/modules/performance.js

@@ -0,0 +1,114 @@
+import { z } from "zod";
+import { boundedItems, reportDateRange, reportFilters } from "../report-utils.js";
+import { READ_ONLY_ANNOTATIONS, runTool } from "../result.js";
+import { boundedItemsDataSchema, filtersSchema, parseUpstream, seriesRangeQuery, timeSchema, timezoneSchema, unitSchema, uuidSchema, } from "../schemas.js";
+const metricSchema = z
+    .enum(["lcp", "inp", "cls", "fcp", "ttfb"])
+    .default("lcp")
+    .describe("Core Web Vital or related loading metric");
+const dimensionSchema = z.enum(["page", "pageTitle", "device", "browser"]);
+const dimensionKeys = {
+    page: "pages",
+    pageTitle: "pageTitles",
+    device: "devices",
+    browser: "browsers",
+};
+const performanceReportSchema = z
+    .object({
+    chart: z.array(z.json()),
+    summary: z.json(),
+    pages: z.array(z.json()).optional(),
+    pageTitles: z.array(z.json()).optional(),
+    devices: z.array(z.json()).optional(),
+    browsers: z.array(z.json()).optional(),
+})
+    .passthrough();
+const webVitalsOutputSchema = {
+    data: z
+        .object({
+        metric: z.enum(["lcp", "inp", "cls", "fcp", "ttfb"]),
+        summary: z.json(),
+        chart: boundedItemsDataSchema,
+    })
+        .passthrough(),
+};
+const performanceBreakdownOutputSchema = {
+    data: boundedItemsDataSchema
+        .extend({
+        metric: z.enum(["lcp", "inp", "cls", "fcp", "ttfb"]),
+        dimension: dimensionSchema,
+        summary: z.json(),
+    })
+        .passthrough(),
+};
+function makeRequest(websiteId, start, end, maxRangeDays, metric, timezone, unit, filters) {
+    seriesRangeQuery(start, end, maxRangeDays, { timezone, unit, seriesCount: 1 });
+    return {
+        websiteId,
+        type: "performance",
+        parameters: {
+            ...reportDateRange(start, end, maxRangeDays),
+            metric,
+            timezone,
+            ...(unit ? { unit } : {}),
+        },
+        filters: reportFilters(filters),
+    };
+}
+export const performanceModule = {
+    id: "performance",
+    access: "read",
+    register(server, { client, config }) {
+        server.registerTool("get_web_vitals", {
+            title: "Get Core Web Vitals",
+            description: "Get Umami 3.2 LCP, INP, CLS, FCP and TTFB percentile summaries plus a bounded p50/p75/p95 series for one metric.",
+            inputSchema: {
+                websiteId: uuidSchema,
+                start: timeSchema,
+                end: timeSchema,
+                metric: metricSchema,
+                timezone: timezoneSchema,
+                unit: unitSchema,
+                maxPoints: z.number().int().min(1).max(1_000).default(366),
+                filters: filtersSchema.optional(),
+            },
+            outputSchema: webVitalsOutputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId, start, end, metric, timezone, unit, maxPoints, filters }, extra) => runTool(async () => {
+            const request = makeRequest(websiteId, start, end, config.maxRangeDays, metric, timezone, unit, filters);
+            const report = parseUpstream(performanceReportSchema, await client.runReport(request, extra.signal), "performance report");
+            return {
+                metric,
+                summary: report.summary,
+                chart: boundedItems(report.chart, maxPoints),
+            };
+        }));
+        server.registerTool("get_performance_breakdown", {
+            title: "Break down Core Web Vitals",
+            description: "Rank Umami 3.2 Web Vital percentiles by page, page title, device or browser with explicit context limits.",
+            inputSchema: {
+                websiteId: uuidSchema,
+                start: timeSchema,
+                end: timeSchema,
+                metric: metricSchema,
+                dimension: dimensionSchema,
+                timezone: timezoneSchema,
+                unit: unitSchema,
+                limit: z.number().int().min(1).max(100).default(20),
+                filters: filtersSchema.optional(),
+            },
+            outputSchema: performanceBreakdownOutputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId, start, end, metric, dimension, timezone, unit, limit, filters }, extra) => runTool(async () => {
+            const request = makeRequest(websiteId, start, end, config.maxRangeDays, metric, timezone, unit, filters);
+            const report = parseUpstream(performanceReportSchema, await client.runReport(request, extra.signal), "performance report");
+            return {
+                metric,
+                dimension,
+                summary: report.summary,
+                ...boundedItems(report[dimensionKeys[dimension]], limit),
+            };
+        }));
+    },
+};
+//# sourceMappingURL=performance.js.map

package/dist/mcp/modules/performance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.js","sourceRoot":"","sources":["../../../src/mcp/modules/performance.ts"],"names":[],"mappings":"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"}

package/dist/mcp/modules/replay.d.ts

@@ -0,0 +1,3 @@
+import type { ToolModule } from "../tool-module.js";
+export declare const replayModule: ToolModule;
+//# sourceMappingURL=replay.d.ts.map

package/dist/mcp/modules/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../../src/mcp/modules/replay.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,eAAO,MAAM,YAAY,EAAE,UA8C1B,CAAC"}

package/dist/mcp/modules/replay.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+import { READ_ONLY_ANNOTATIONS, runTool } from "../result.js";
+import { filtersSchema, pagedOutputSchema, pageSchema, pageSizeSchema, rangeQuery, timeSchema, uuidSchema, } from "../schemas.js";
+export const replayModule = {
+    id: "replay",
+    access: "read",
+    register(server, { client, config }) {
+        server.registerTool("list_replays", {
+            title: "List session replay metadata",
+            description: "List Umami 3.2 session replay metadata. Raw rrweb event payloads are intentionally excluded to limit sensitive and oversized model context.",
+            inputSchema: {
+                websiteId: uuidSchema,
+                start: timeSchema,
+                end: timeSchema,
+                page: pageSchema,
+                pageSize: pageSizeSchema,
+                search: z.string().max(500).optional(),
+                minDuration: z
+                    .number()
+                    .int()
+                    .min(0)
+                    .max(86_400)
+                    .optional()
+                    .describe("Minimum replay duration in seconds"),
+                filters: filtersSchema.optional(),
+            },
+            outputSchema: pagedOutputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId, start, end, page, pageSize, search, minDuration, filters }, extra) => runTool(() => {
+            client.assertWebsiteAllowed(websiteId);
+            return client.get(`websites/${encodeURIComponent(websiteId)}/replays`, {
+                ...rangeQuery(start, end, config.maxRangeDays, { filters }),
+                page,
+                pageSize,
+                search,
+                minDuration,
+            }, extra.signal);
+        }));
+    },
+};
+//# sourceMappingURL=replay.js.map

package/dist/mcp/modules/replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.js","sourceRoot":"","sources":["../../../src/mcp/modules/replay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,UAAU,EACV,UAAU,EACV,UAAU,GACX,MAAM,eAAe,CAAC;AAGvB,MAAM,CAAC,MAAM,YAAY,GAAe;IACtC,EAAE,EAAE,QAAQ;IACZ,MAAM,EAAE,MAAM;IACd,QAAQ,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;QACjC,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;YACE,KAAK,EAAE,8BAA8B;YACrC,WAAW,EACT,6IAA6I;YAC/I,WAAW,EAAE;gBACX,SAAS,EAAE,UAAU;gBACrB,KAAK,EAAE,UAAU;gBACjB,GAAG,EAAE,UAAU;gBACf,IAAI,EAAE,UAAU;gBAChB,QAAQ,EAAE,cAAc;gBACxB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;gBACtC,WAAW,EAAE,CAAC;qBACX,MAAM,EAAE;qBACR,GAAG,EAAE;qBACL,GAAG,CAAC,CAAC,CAAC;qBACN,GAAG,CAAC,MAAM,CAAC;qBACX,QAAQ,EAAE;qBACV,QAAQ,CAAC,oCAAoC,CAAC;gBACjD,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE;aAClC;YACD,YAAY,EAAE,iBAAiB;YAC/B,WAAW,EAAE,qBAAqB;SACnC,EACD,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,CACjF,OAAO,CAAC,GAAG,EAAE;YACX,MAAM,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;YACvC,OAAO,MAAM,CAAC,GAAG,CACf,YAAY,kBAAkB,CAAC,SAAS,CAAC,UAAU,EACnD;gBACE,GAAG,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,CAAC;gBAC3D,IAAI;gBACJ,QAAQ;gBACR,MAAM;gBACN,WAAW;aACZ,EACD,KAAK,CAAC,MAAM,CACb,CAAC;QACJ,CAAC,CAAC,CACL,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mcp/modules/reports.d.ts

@@ -0,0 +1,3 @@
+import type { ToolModule } from "../tool-module.js";
+export declare const reportsModule: ToolModule;
+//# sourceMappingURL=reports.d.ts.map

package/dist/mcp/modules/reports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../../src/mcp/modules/reports.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AA4DpD,eAAO,MAAM,aAAa,EAAE,UAwU3B,CAAC"}

package/dist/mcp/modules/reports.js

@@ -0,0 +1,301 @@
+import { z } from "zod";
+import { UmamiError } from "../../api/errors.js";
+import { boundedItems, boundTopLevelArrays, reportDateRange, reportFilters, requireRecord, } from "../report-utils.js";
+import { READ_ONLY_ANNOTATIONS, runTool } from "../result.js";
+import { boundedItemsOutputSchema, filtersSchema, outputSchema, pagedOutputSchema, pageSchema, pageSizeSchema, recordOutputSchema, timeSchema, timezoneSchema, uuidSchema, } from "../schemas.js";
+const reportTypeSchema = z.enum([
+    "attribution",
+    "breakdown",
+    "funnel",
+    "goal",
+    "heatmap",
+    "journey",
+    "performance",
+    "retention",
+    "revenue",
+    "utm",
+]);
+const breakdownFieldSchema = z.enum([
+    "path",
+    "referrer",
+    "title",
+    "query",
+    "os",
+    "browser",
+    "device",
+    "country",
+    "region",
+    "city",
+    "tag",
+    "hostname",
+    "distinctId",
+    "language",
+    "event",
+    "utmSource",
+    "utmMedium",
+    "utmCampaign",
+    "utmContent",
+    "utmTerm",
+]);
+const currencySchema = z
+    .string()
+    .length(3)
+    .transform((value) => value.toUpperCase())
+    .optional();
+const maxItemsSchema = z.number().int().min(1).max(100).default(20);
+function commonRequest(websiteId, start, end, maxRangeDays, filters) {
+    return {
+        websiteId,
+        dates: reportDateRange(start, end, maxRangeDays),
+        filters: reportFilters(filters),
+    };
+}
+export const reportsModule = {
+    id: "reports",
+    access: "read",
+    register(server, { client, config }) {
+        server.registerTool("list_saved_reports", {
+            title: "List saved Umami reports",
+            description: "List saved report definitions for one website without modifying them.",
+            inputSchema: {
+                websiteId: uuidSchema,
+                type: reportTypeSchema.optional(),
+                page: pageSchema,
+                pageSize: pageSizeSchema,
+            },
+            outputSchema: pagedOutputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId, type, page, pageSize }, extra) => runTool(() => {
+            client.assertWebsiteAllowed(websiteId);
+            return client.get(`websites/${encodeURIComponent(websiteId)}/reports`, { type, page, pageSize }, extra.signal);
+        }));
+        server.registerTool("get_saved_report", {
+            title: "Get a saved Umami report",
+            description: "Get one saved report definition. The website ID is required to enforce the local allowlist and is verified against the response.",
+            inputSchema: { websiteId: uuidSchema, reportId: uuidSchema },
+            outputSchema: recordOutputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId, reportId }, extra) => runTool(async () => {
+            client.assertWebsiteAllowed(websiteId);
+            const report = requireRecord(await client.get(`reports/${encodeURIComponent(reportId)}`, undefined, extra.signal));
+            if (typeof report.websiteId !== "string" ||
+                report.websiteId.toLowerCase() !== websiteId) {
+                throw new UmamiError("FORBIDDEN", "The saved report does not belong to that website.");
+            }
+            return report;
+        }));
+        server.registerTool("list_segments", {
+            title: "List Umami segments or cohorts",
+            description: "List reusable website segments or cohorts with bounded model context.",
+            inputSchema: {
+                websiteId: uuidSchema,
+                type: z.enum(["segment", "cohort"]),
+                search: z.string().max(500).optional(),
+                limit: z.number().int().min(1).max(100).default(50),
+            },
+            outputSchema: boundedItemsOutputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId, type, search, limit }, extra) => runTool(async () => {
+            client.assertWebsiteAllowed(websiteId);
+            const result = await client.get(`websites/${encodeURIComponent(websiteId)}/segments`, { type, search }, extra.signal);
+            return { type, ...boundedItems(result, limit) };
+        }));
+        server.registerTool("run_goal_report", {
+            title: "Run a goal report",
+            description: "Calculate an Umami conversion goal for a path or custom event.",
+            inputSchema: {
+                websiteId: uuidSchema,
+                start: timeSchema,
+                end: timeSchema,
+                type: z.enum(["path", "event"]),
+                value: z.string().min(1).max(500),
+                filters: filtersSchema.optional(),
+            },
+            outputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId, start, end, type, value, filters }, extra) => runTool(() => {
+            const common = commonRequest(websiteId, start, end, config.maxRangeDays, filters);
+            const request = {
+                websiteId,
+                type: "goal",
+                parameters: { ...common.dates, type, value },
+                filters: common.filters,
+            };
+            return client.runReport(request, extra.signal);
+        }));
+        server.registerTool("run_funnel_report", {
+            title: "Run a funnel report",
+            description: "Calculate a 2–8 step Umami funnel. windowMinutes controls the allowed time between consecutive steps.",
+            inputSchema: {
+                websiteId: uuidSchema,
+                start: timeSchema,
+                end: timeSchema,
+                windowMinutes: z.number().int().min(1).max(10_080).default(60),
+                steps: z
+                    .array(z.object({
+                    type: z.enum(["path", "event"]),
+                    value: z.string().min(1).max(500),
+                    filters: z
+                        .array(z.object({
+                        property: z.string().min(1).max(200),
+                        operator: z.enum(["eq", "neq", "c", "dnc"]),
+                        value: z.string().max(500),
+                    }))
+                        .max(10)
+                        .optional(),
+                }))
+                    .min(2)
+                    .max(8),
+                filters: filtersSchema.optional(),
+            },
+            outputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId, start, end, windowMinutes, steps, filters }, extra) => runTool(() => {
+            const common = commonRequest(websiteId, start, end, config.maxRangeDays, filters);
+            const request = {
+                websiteId,
+                type: "funnel",
+                parameters: { ...common.dates, window: windowMinutes, steps },
+                filters: common.filters,
+            };
+            return client.runReport(request, extra.signal);
+        }));
+        server.registerTool("run_journey_report", {
+            title: "Run a journey report",
+            description: "Calculate the most common 2–7 step user journeys and return a bounded ranking.",
+            inputSchema: {
+                websiteId: uuidSchema,
+                start: timeSchema,
+                end: timeSchema,
+                steps: z.number().int().min(2).max(7),
+                startStep: z.string().min(1).max(500).optional(),
+                endStep: z.string().min(1).max(500).optional(),
+                eventType: z.number().int().positive().optional(),
+                limit: maxItemsSchema,
+                filters: filtersSchema.optional(),
+            },
+            outputSchema: boundedItemsOutputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId, start, end, steps, startStep, endStep, eventType, limit, filters }, extra) => runTool(async () => {
+            const common = commonRequest(websiteId, start, end, config.maxRangeDays, filters);
+            const request = {
+                websiteId,
+                type: "journey",
+                parameters: {
+                    ...common.dates,
+                    steps,
+                    ...(startStep ? { startStep } : {}),
+                    ...(endStep ? { endStep } : {}),
+                    ...(eventType ? { eventType } : {}),
+                },
+                filters: common.filters,
+            };
+            return boundedItems(await client.runReport(request, extra.signal), limit);
+        }));
+        server.registerTool("run_retention_report", {
+            title: "Run a retention report",
+            description: "Calculate daily Umami cohort retention and return a bounded result set.",
+            inputSchema: {
+                websiteId: uuidSchema,
+                start: timeSchema,
+                end: timeSchema,
+                timezone: timezoneSchema,
+                limit: z.number().int().min(1).max(500).default(100),
+                filters: filtersSchema.optional(),
+            },
+            outputSchema: boundedItemsOutputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId, start, end, timezone, limit, filters }, extra) => runTool(async () => {
+            const common = commonRequest(websiteId, start, end, config.maxRangeDays, filters);
+            const request = {
+                websiteId,
+                type: "retention",
+                parameters: { ...common.dates, timezone },
+                filters: common.filters,
+            };
+            return boundedItems(await client.runReport(request, extra.signal), limit);
+        }));
+        server.registerTool("run_utm_report", {
+            title: "Run a UTM report",
+            description: "Calculate Umami source, medium, campaign, term and content performance with bounded category arrays.",
+            inputSchema: {
+                websiteId: uuidSchema,
+                start: timeSchema,
+                end: timeSchema,
+                limit: maxItemsSchema,
+                filters: filtersSchema.optional(),
+            },
+            outputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId, start, end, limit, filters }, extra) => runTool(async () => {
+            const common = commonRequest(websiteId, start, end, config.maxRangeDays, filters);
+            const request = {
+                websiteId,
+                type: "utm",
+                parameters: common.dates,
+                filters: common.filters,
+            };
+            return boundTopLevelArrays(await client.runReport(request, extra.signal), limit);
+        }));
+        server.registerTool("run_attribution_report", {
+            title: "Run an attribution report",
+            description: "Calculate first-click or last-click attribution for a conversion path or event with bounded channel arrays.",
+            inputSchema: {
+                websiteId: uuidSchema,
+                start: timeSchema,
+                end: timeSchema,
+                model: z.enum(["first-click", "last-click"]),
+                type: z.enum(["path", "event"]),
+                step: z.string().min(1).max(500),
+                currency: currencySchema,
+                limit: maxItemsSchema,
+                filters: filtersSchema.optional(),
+            },
+            outputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId, start, end, model, type, step, currency, limit, filters }, extra) => runTool(async () => {
+            const common = commonRequest(websiteId, start, end, config.maxRangeDays, filters);
+            const request = {
+                websiteId,
+                type: "attribution",
+                parameters: {
+                    ...common.dates,
+                    model,
+                    type,
+                    step,
+                    ...(currency ? { currency } : {}),
+                },
+                filters: common.filters,
+            };
+            return boundTopLevelArrays(await client.runReport(request, extra.signal), limit);
+        }));
+        server.registerTool("run_breakdown_report", {
+            title: "Run a multi-field breakdown",
+            description: "Cross-tabulate up to three Umami dimensions and return the highest-ranked bounded rows.",
+            inputSchema: {
+                websiteId: uuidSchema,
+                start: timeSchema,
+                end: timeSchema,
+                fields: z
+                    .array(breakdownFieldSchema)
+                    .min(1)
+                    .max(3)
+                    .refine((items) => new Set(items).size === items.length, "fields must be unique"),
+                limit: z.number().int().min(1).max(100).default(20),
+                filters: filtersSchema.optional(),
+            },
+            outputSchema: boundedItemsOutputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId, start, end, fields, limit, filters }, extra) => runTool(async () => {
+            const common = commonRequest(websiteId, start, end, config.maxRangeDays, filters);
+            const request = {
+                websiteId,
+                type: "breakdown",
+                parameters: { ...common.dates, fields: fields },
+                filters: common.filters,
+            };
+            return boundedItems(await client.runReport(request, extra.signal), limit);
+        }));
+    },
+};
+//# sourceMappingURL=reports.js.map

package/dist/mcp/modules/reports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reports.js","sourceRoot":"","sources":["../../../src/mcp/modules/reports.ts"],"names":[],"mappings":"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"}

package/dist/mcp/modules/revenue.d.ts

@@ -0,0 +1,3 @@
+import type { ToolModule } from "../tool-module.js";
+export declare const revenueModule: ToolModule;
+//# sourceMappingURL=revenue.d.ts.map

package/dist/mcp/modules/revenue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revenue.d.ts","sourceRoot":"","sources":["../../../src/mcp/modules/revenue.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAQpD,eAAO,MAAM,aAAa,EAAE,UAoE3B,CAAC"}

package/dist/mcp/modules/revenue.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+import { boundedItems } from "../report-utils.js";
+import { READ_ONLY_ANNOTATIONS, runTool } from "../result.js";
+import { boundedItemsOutputSchema, filtersSchema, rangeQuery, recordOutputSchema, timeSchema, uuidSchema, } from "../schemas.js";
+const currencySchema = z
+    .string()
+    .length(3)
+    .transform((value) => value.toUpperCase())
+    .describe("Three-letter display currency, for example USD or EUR");
+export const revenueModule = {
+    id: "revenue",
+    access: "read",
+    register(server, { client, config }) {
+        server.registerTool("get_revenue_stats", {
+            title: "Get revenue statistics",
+            description: "Get Umami 3.2 revenue totals and comparison values in a chosen currency.",
+            inputSchema: {
+                websiteId: uuidSchema,
+                start: timeSchema,
+                end: timeSchema,
+                currency: currencySchema,
+                filters: filtersSchema.optional(),
+            },
+            outputSchema: recordOutputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId, start, end, currency, filters }, extra) => runTool(() => {
+            client.assertWebsiteAllowed(websiteId);
+            return client.get(`websites/${encodeURIComponent(websiteId)}/revenue/stats`, {
+                ...rangeQuery(start, end, config.maxRangeDays, { filters }),
+                currency,
+            }, extra.signal);
+        }));
+        server.registerTool("get_revenue_metrics", {
+            title: "Break down revenue metrics",
+            description: "Break down Umami 3.2 revenue by country, region, referrer or channel.",
+            inputSchema: {
+                websiteId: uuidSchema,
+                start: timeSchema,
+                end: timeSchema,
+                currency: currencySchema,
+                type: z.enum(["country", "region", "referrer", "channel"]),
+                limit: z.number().int().min(1).max(100).default(20),
+                filters: filtersSchema.optional(),
+            },
+            outputSchema: boundedItemsOutputSchema,
+            annotations: READ_ONLY_ANNOTATIONS,
+        }, ({ websiteId, start, end, currency, type, limit, filters }, extra) => runTool(async () => {
+            client.assertWebsiteAllowed(websiteId);
+            return boundedItems(await client.get(`websites/${encodeURIComponent(websiteId)}/revenue/metrics`, {
+                ...rangeQuery(start, end, config.maxRangeDays, { filters }),
+                currency,
+                type,
+            }, extra.signal), limit);
+        }));
+    },
+};
+//# sourceMappingURL=revenue.js.map

package/dist/mcp/modules/revenue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revenue.js","sourceRoot":"","sources":["../../../src/mcp/modules/revenue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EACL,wBAAwB,EACxB,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,UAAU,EACV,UAAU,GACX,MAAM,eAAe,CAAC;AAGvB,MAAM,cAAc,GAAG,CAAC;KACrB,MAAM,EAAE;KACR,MAAM,CAAC,CAAC,CAAC;KACT,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;KACzC,QAAQ,CAAC,uDAAuD,CAAC,CAAC;AAErE,MAAM,CAAC,MAAM,aAAa,GAAe;IACvC,EAAE,EAAE,SAAS;IACb,MAAM,EAAE,MAAM;IACd,QAAQ,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;QACjC,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;YACE,KAAK,EAAE,wBAAwB;YAC/B,WAAW,EAAE,0EAA0E;YACvF,WAAW,EAAE;gBACX,SAAS,EAAE,UAAU;gBACrB,KAAK,EAAE,UAAU;gBACjB,GAAG,EAAE,UAAU;gBACf,QAAQ,EAAE,cAAc;gBACxB,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE;aAClC;YACD,YAAY,EAAE,kBAAkB;YAChC,WAAW,EAAE,qBAAqB;SACnC,EACD,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,CACtD,OAAO,CAAC,GAAG,EAAE;YACX,MAAM,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;YACvC,OAAO,MAAM,CAAC,GAAG,CACf,YAAY,kBAAkB,CAAC,SAAS,CAAC,gBAAgB,EACzD;gBACE,GAAG,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,CAAC;gBAC3D,QAAQ;aACT,EACD,KAAK,CAAC,MAAM,CACb,CAAC;QACJ,CAAC,CAAC,CACL,CAAC;QAEF,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;YACE,KAAK,EAAE,4BAA4B;YACnC,WAAW,EAAE,uEAAuE;YACpF,WAAW,EAAE;gBACX,SAAS,EAAE,UAAU;gBACrB,KAAK,EAAE,UAAU;gBACjB,GAAG,EAAE,UAAU;gBACf,QAAQ,EAAE,cAAc;gBACxB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;gBAC1D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnD,OAAO,EAAE,aAAa,CAAC,QAAQ,EAAE;aAClC;YACD,YAAY,EAAE,wBAAwB;YACtC,WAAW,EAAE,qBAAqB;SACnC,EACD,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,CACnE,OAAO,CAAC,KAAK,IAAI,EAAE;YACjB,MAAM,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;YACvC,OAAO,YAAY,CACjB,MAAM,MAAM,CAAC,GAAG,CACd,YAAY,kBAAkB,CAAC,SAAS,CAAC,kBAAkB,EAC3D;gBACE,GAAG,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,CAAC;gBAC3D,QAAQ;gBACR,IAAI;aACL,EACD,KAAK,CAAC,MAAM,CACb,EACD,KAAK,CACN,CAAC;QACJ,CAAC,CAAC,CACL,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/mcp/modules/sessions.d.ts

@@ -0,0 +1,3 @@
+import type { ToolModule } from "../tool-module.js";
+export declare const sessionsModule: ToolModule;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/mcp/modules/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../../src/mcp/modules/sessions.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,eAAO,MAAM,cAAc,EAAE,UAgH5B,CAAC"}