@sealmetrics/mcp 0.1.0 → 1.2.0

package/dist/tools/index.js

@@ -0,0 +1,79 @@
+import { listSitesTool, getSiteTool } from "./sites.js";
+import { getOverviewTool } from "./overview.js";
+import { getTrafficSourcesTool, getTrafficMediumsTool, getCampaignsTool, getTermsTool, getTopSourcesTool, getTopCampaignsTool, getTopTermsTool, getTopReferrersTool, } from "./traffic.js";
+import { getPagesTool, getLandingPagesTool, getTopPagesTool, getTopLandingPagesTool, getLandingPagesByContentGroupTool, } from "./pages.js";
+import { getConversionsTool, getMicroconversionsTool, listMicroconversionTypesTool, getMicroconversionDetailsTool, } from "./conversions.js";
+import { getCountriesTool, getDevicesTool, getBrowsersTool, getOperatingSystemsTool, getDeviceTypesTool, } from "./audience.js";
+import { getFunnelTool } from "./funnel.js";
+import { getContentGroupsTool } from "./content.js";
+import { getChannelsTool, getTopChannelsTool, listChannelRulesTool } from "./channels.js";
+import { getBotStatsTool, getSuspiciousSessionsTool } from "./bots.js";
+import { listSegmentsTool, getSegmentTool } from "./segments.js";
+import { listAlertsTool, getAlertHistoryTool, getAlertStatsTool } from "./alerts.js";
+import { listWebhooksTool, listWebhookDeliveriesTool, getWebhookStatsTool } from "./webhooks.js";
+import { getTrackingCodeTool } from "./tracking.js";
+import { listPropertyKeysTool, getPropertyValuesTool, getPropertyBreakdownTool, } from "./properties.js";
+// Re-export shared utilities for convenience
+export { PERIOD_SCHEMA, COMPARE_SCHEMA, LIMIT_SCHEMA, SORT_ORDER_SCHEMA, PAGE_SCHEMA, resolveSiteId, } from "./shared.js";
+/** All registered tools. */
+export const ALL_TOOLS = [
+    // Sites
+    listSitesTool,
+    getSiteTool,
+    // Overview
+    getOverviewTool,
+    // Traffic
+    getTrafficSourcesTool,
+    getTrafficMediumsTool,
+    getCampaignsTool,
+    getTermsTool,
+    getTopSourcesTool,
+    getTopCampaignsTool,
+    getTopTermsTool,
+    getTopReferrersTool,
+    // Pages & Content
+    getPagesTool,
+    getLandingPagesTool,
+    getTopPagesTool,
+    getTopLandingPagesTool,
+    getLandingPagesByContentGroupTool,
+    getContentGroupsTool,
+    // Conversions
+    getConversionsTool,
+    getMicroconversionsTool,
+    listMicroconversionTypesTool,
+    getMicroconversionDetailsTool,
+    // Audience
+    getCountriesTool,
+    getDevicesTool,
+    getDeviceTypesTool,
+    getBrowsersTool,
+    getOperatingSystemsTool,
+    // Channels
+    getChannelsTool,
+    getTopChannelsTool,
+    listChannelRulesTool,
+    // Properties
+    listPropertyKeysTool,
+    getPropertyValuesTool,
+    getPropertyBreakdownTool,
+    // Funnel
+    getFunnelTool,
+    // Bot Detection
+    getBotStatsTool,
+    getSuspiciousSessionsTool,
+    // Segments
+    listSegmentsTool,
+    getSegmentTool,
+    // Alerts
+    listAlertsTool,
+    getAlertHistoryTool,
+    getAlertStatsTool,
+    // Webhooks
+    listWebhooksTool,
+    listWebhookDeliveriesTool,
+    getWebhookStatsTool,
+    // Tracking
+    getTrackingCodeTool,
+];
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,iCAAiC,GAClC,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1F,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACjG,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAEzB,6CAA6C;AAC7C,OAAO,EACL,aAAa,EACb,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,aAAa,CAAC;AAiBrB,4BAA4B;AAC5B,MAAM,CAAC,MAAM,SAAS,GAAc;IAClC,QAAQ;IACR,aAAa;IACb,WAAW;IACX,WAAW;IACX,eAAe;IACf,UAAU;IACV,qBAAqB;IACrB,qBAAqB;IACrB,gBAAgB;IAChB,YAAY;IACZ,iBAAiB;IACjB,mBAAmB;IACnB,eAAe;IACf,mBAAmB;IACnB,kBAAkB;IAClB,YAAY;IACZ,mBAAmB;IACnB,eAAe;IACf,sBAAsB;IACtB,iCAAiC;IACjC,oBAAoB;IACpB,cAAc;IACd,kBAAkB;IAClB,uBAAuB;IACvB,4BAA4B;IAC5B,6BAA6B;IAC7B,WAAW;IACX,gBAAgB;IAChB,cAAc;IACd,kBAAkB;IAClB,eAAe;IACf,uBAAuB;IACvB,WAAW;IACX,eAAe;IACf,kBAAkB;IAClB,oBAAoB;IACpB,aAAa;IACb,oBAAoB;IACpB,qBAAqB;IACrB,wBAAwB;IACxB,SAAS;IACT,aAAa;IACb,gBAAgB;IAChB,eAAe;IACf,yBAAyB;IACzB,WAAW;IACX,gBAAgB;IAChB,cAAc;IACd,SAAS;IACT,cAAc;IACd,mBAAmB;IACnB,iBAAiB;IACjB,WAAW;IACX,gBAAgB;IAChB,yBAAyB;IACzB,mBAAmB;IACnB,WAAW;IACX,mBAAmB;CACpB,CAAC"}

package/dist/tools/manage.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDef } from "./index.js";
+export declare const createSiteTool: ToolDef;
+//# sourceMappingURL=manage.d.ts.map

package/dist/tools/manage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage.d.ts","sourceRoot":"","sources":["../../src/tools/manage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAO,MAAM,cAAc,EAAE,OAmE5B,CAAC"}

package/dist/tools/manage.js

@@ -0,0 +1,55 @@
+export const createSiteTool = {
+    name: "create_site",
+    description: "Create a new analytics site in SealMetrics. IMPORTANT: This creates a permanent resource. Confirm the site name and domain with the user before calling this tool. Requires an API key with the sites:create scope.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            name: {
+                type: "string",
+                description: "Display name for the site (e.g. 'My Store', 'Company Blog'). Used to generate the site ID.",
+            },
+            domain: {
+                type: "string",
+                description: "Primary domain for tracking (e.g. 'example.com'). Optional — can be added later in Settings.",
+            },
+            timezone: {
+                type: "string",
+                description: 'IANA timezone for the site (e.g. "Europe/Madrid", "America/New_York"). Default: "UTC".',
+            },
+            currency: {
+                type: "string",
+                description: 'ISO 4217 currency code (e.g. "EUR", "USD"). Default: "EUR".',
+            },
+        },
+        required: ["name"],
+    },
+    handler: async (client, args) => {
+        const name = args.name;
+        if (!name || name.trim().length === 0) {
+            throw new Error("Site name is required and cannot be empty.");
+        }
+        const body = { name: name.trim() };
+        const domain = args.domain;
+        if (domain && domain.trim().length > 0) {
+            body.domains = [domain.trim().toLowerCase()];
+        }
+        const timezone = args.timezone;
+        if (timezone) {
+            body.timezone = timezone;
+        }
+        const currency = args.currency;
+        if (currency) {
+            body.currency = currency.toUpperCase();
+        }
+        const site = await client.post("/sites", body);
+        return {
+            site_id: site.id,
+            name: site.name,
+            domains: site.domains,
+            timezone: site.timezone,
+            currency: site.currency,
+            message: `Site "${site.name}" created successfully with ID "${site.id}". Install the tracking pixel to start collecting data.`,
+        };
+    },
+};
+//# sourceMappingURL=manage.js.map

package/dist/tools/manage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manage.js","sourceRoot":"","sources":["../../src/tools/manage.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,cAAc,GAAY;IACrC,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,qNAAqN;IACvN,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,4FAA4F;aAC/F;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,8FAA8F;aACjG;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,wFAAwF;aAC3F;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,6DAA6D;aAChE;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IACD,OAAO,EAAE,KAAK,EACZ,MAAyB,EACzB,IAA6B,EAC7B,EAAE;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAc,CAAC;QACjC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,IAAI,GAA4B,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QAE5D,MAAM,MAAM,GAAG,IAAI,CAAC,MAA4B,CAAC;QACjD,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAA8B,CAAC;QACrD,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC3B,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAA8B,CAAC;QACrD,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QACzC,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAW,QAAQ,EAAE,IAAI,CAAC,CAAC;QAEzD,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,EAAE;YAChB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,mCAAmC,IAAI,CAAC,EAAE,yDAAyD;SAC/H,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/tools/overview.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDef } from "./index.js";
+export declare const getOverviewTool: ToolDef;
+//# sourceMappingURL=overview.d.ts.map

package/dist/tools/overview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overview.d.ts","sourceRoot":"","sources":["../../src/tools/overview.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAO,MAAM,eAAe,EAAE,OA4B7B,CAAC"}

package/dist/tools/overview.js

@@ -0,0 +1,26 @@
+import { PERIOD_SCHEMA, COMPARE_SCHEMA, resolveSiteId } from "./shared.js";
+export const getOverviewTool = {
+    name: "get_overview",
+    description: "Get dashboard KPIs: pageviews, entrances, bounce rate, conversions, revenue. Includes time series data and optional period-over-period comparison. This is the best starting point for understanding a site's performance.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            period: PERIOD_SCHEMA,
+            compare: COMPARE_SCHEMA,
+        },
+    },
+    handler: async (client, args) => {
+        const siteId = resolveSiteId(args);
+        const params = {
+            site_id: siteId,
+            period: args.period ?? "30d",
+            compare: args.compare,
+        };
+        return client.request("/stats/overview", params);
+    },
+};
+//# sourceMappingURL=overview.js.map

package/dist/tools/overview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overview.js","sourceRoot":"","sources":["../../src/tools/overview.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG3E,MAAM,CAAC,MAAM,eAAe,GAAY;IACtC,IAAI,EAAE,cAAc;IACpB,WAAW,EACT,4NAA4N;IAC9N,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,0DAA0D;aAC7D;YACD,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE,cAAc;SACxB;KACF;IACD,OAAO,EAAE,KAAK,EACZ,MAAyB,EACzB,IAA6B,EAC7B,EAAE;QACF,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,MAAM,GAAuC;YACjD,OAAO,EAAE,MAAM;YACf,MAAM,EAAG,IAAI,CAAC,MAAiB,IAAI,KAAK;YACxC,OAAO,EAAE,IAAI,CAAC,OAA6B;SAC5C,CAAC;QACF,OAAO,MAAM,CAAC,OAAO,CAAgB,iBAAiB,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;CACF,CAAC"}

package/dist/tools/pages.d.ts

@@ -0,0 +1,7 @@
+import type { ToolDef } from "./index.js";
+export declare const getPagesTool: ToolDef;
+export declare const getLandingPagesTool: ToolDef;
+export declare const getTopPagesTool: ToolDef;
+export declare const getTopLandingPagesTool: ToolDef;
+export declare const getLandingPagesByContentGroupTool: ToolDef;
+//# sourceMappingURL=pages.d.ts.map

package/dist/tools/pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/tools/pages.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAO,MAAM,YAAY,EAAE,OAwC1B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,OAwCjC,CAAC;AAIF,eAAO,MAAM,eAAe,EAAE,OA+C7B,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,OA0CpC,CAAC;AAEF,eAAO,MAAM,iCAAiC,EAAE,OAmC/C,CAAC"}

package/dist/tools/pages.js

@@ -0,0 +1,207 @@
+import { PERIOD_SCHEMA, COMPARE_SCHEMA, LIMIT_SCHEMA, SORT_ORDER_SCHEMA, PAGE_SCHEMA, resolveSiteId, } from "./shared.js";
+export const getPagesTool = {
+    name: "get_pages",
+    description: "Get metrics per page URL path: pageviews, entrances, conversions. Useful for finding most popular pages and content performance.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            period: PERIOD_SCHEMA,
+            compare: COMPARE_SCHEMA,
+            limit: LIMIT_SCHEMA,
+            sort_by: {
+                type: "string",
+                description: "Field to sort by.",
+                enum: ["page_views", "entrances", "engaged_entrances", "conversions", "revenue"],
+                default: "page_views",
+            },
+            sort_order: SORT_ORDER_SCHEMA,
+            page: PAGE_SCHEMA,
+            path_filter: {
+                type: "string",
+                description: "Filter pages by URL path pattern (e.g. '/blog').",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        return client.requestPaginated("/stats/pages", {
+            site_id: resolveSiteId(args),
+            period: args.period ?? "30d",
+            compare: args.compare,
+            page_size: String(args.limit ?? 20),
+            page: args.page != null ? String(args.page) : undefined,
+            sort_by: args.sort_by ?? "page_views",
+            sort_order: args.sort_order ?? "desc",
+            path_filter: args.path_filter,
+        });
+    },
+};
+export const getLandingPagesTool = {
+    name: "get_landing_pages",
+    description: "Get landing page performance: entrances, bounce rate, conversions. Landing pages are the first page users see when entering the site. High bounce rates indicate poor landing page experience.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            period: PERIOD_SCHEMA,
+            compare: COMPARE_SCHEMA,
+            limit: LIMIT_SCHEMA,
+            sort_by: {
+                type: "string",
+                description: "Field to sort by.",
+                enum: ["entrances", "engaged_entrances", "page_views", "conversions", "revenue", "bounce_rate"],
+                default: "entrances",
+            },
+            sort_order: SORT_ORDER_SCHEMA,
+            page: PAGE_SCHEMA,
+            path_filter: {
+                type: "string",
+                description: "Filter by URL path pattern.",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        return client.requestPaginated("/stats/landing-pages", {
+            site_id: resolveSiteId(args),
+            period: args.period ?? "30d",
+            compare: args.compare,
+            page_size: String(args.limit ?? 20),
+            page: args.page != null ? String(args.page) : undefined,
+            sort_by: args.sort_by ?? "entrances",
+            sort_order: args.sort_order ?? "desc",
+            path_filter: args.path_filter,
+        });
+    },
+};
+// --- Top N tools (non-paginated, client.request) ---
+export const getTopPagesTool = {
+    name: "get_top_pages",
+    description: "Get top pages ranked by page views. Returns a compact list of the top N pages — ideal for quick rankings and summaries.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            period: PERIOD_SCHEMA,
+            limit: LIMIT_SCHEMA,
+            country: {
+                type: "string",
+                description: "Filter by country code (e.g. 'ES', 'US').",
+            },
+            utm_source: {
+                type: "string",
+                description: "Filter by UTM source.",
+            },
+            utm_medium: {
+                type: "string",
+                description: "Filter by UTM medium.",
+            },
+            utm_campaign: {
+                type: "string",
+                description: "Filter by UTM campaign.",
+            },
+            utm_term: {
+                type: "string",
+                description: "Filter by UTM term.",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        return client.request("/stats/pages/top", {
+            site_id: resolveSiteId(args),
+            period: args.period ?? "30d",
+            limit: String(args.limit ?? 10),
+            country: args.country,
+            utm_source: args.utm_source,
+            utm_medium: args.utm_medium,
+            utm_campaign: args.utm_campaign,
+            utm_term: args.utm_term,
+        });
+    },
+};
+export const getTopLandingPagesTool = {
+    name: "get_top_landing_pages",
+    description: "Get top landing pages ranked by entrances. Returns a compact list of the top N landing pages — ideal for quick rankings.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            period: PERIOD_SCHEMA,
+            limit: LIMIT_SCHEMA,
+            utm_source: {
+                type: "string",
+                description: "Filter by UTM source.",
+            },
+            utm_medium: {
+                type: "string",
+                description: "Filter by UTM medium.",
+            },
+            country: {
+                type: "string",
+                description: "Filter by country code (e.g. 'ES', 'US').",
+            },
+            content_grouping: {
+                type: "string",
+                description: "Filter by content grouping name.",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        return client.request("/stats/landing-pages/top", {
+            site_id: resolveSiteId(args),
+            period: args.period ?? "30d",
+            limit: String(args.limit ?? 10),
+            utm_source: args.utm_source,
+            utm_medium: args.utm_medium,
+            country: args.country,
+            content_grouping: args.content_grouping,
+        });
+    },
+};
+export const getLandingPagesByContentGroupTool = {
+    name: "get_landing_pages_by_content_group",
+    description: "Get landing page metrics grouped by content grouping. Shows aggregate performance per content group (e.g. blog, product, category).",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            period: PERIOD_SCHEMA,
+            utm_source: {
+                type: "string",
+                description: "Filter by UTM source.",
+            },
+            utm_medium: {
+                type: "string",
+                description: "Filter by UTM medium.",
+            },
+            country: {
+                type: "string",
+                description: "Filter by country code (e.g. 'ES', 'US').",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        return client.request("/stats/landing-pages/by-content-group", {
+            site_id: resolveSiteId(args),
+            period: args.period ?? "30d",
+            utm_source: args.utm_source,
+            utm_medium: args.utm_medium,
+            country: args.country,
+        });
+    },
+};
+//# sourceMappingURL=pages.js.map

package/dist/tools/pages.js.map

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

package/dist/tools/properties.d.ts

@@ -0,0 +1,5 @@
+import type { ToolDef } from "./index.js";
+export declare const listPropertyKeysTool: ToolDef;
+export declare const getPropertyValuesTool: ToolDef;
+export declare const getPropertyBreakdownTool: ToolDef;
+//# sourceMappingURL=properties.d.ts.map

package/dist/tools/properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../../src/tools/properties.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAU1C,eAAO,MAAM,oBAAoB,EAAE,OAsBlC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,OA6CnC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,OAiCtC,CAAC"}

package/dist/tools/properties.js

@@ -0,0 +1,107 @@
+import { PERIOD_SCHEMA, LIMIT_SCHEMA, PAGE_SCHEMA, resolveSiteId, } from "./shared.js";
+const TABLE_SCHEMA = {
+    type: "string",
+    description: 'Table to query: "conversions", "microconversions", "both", or "conversion_items". Default: "both".',
+    enum: ["conversions", "microconversions", "both", "conversion_items"],
+    default: "both",
+};
+export const listPropertyKeysTool = {
+    name: "list_property_keys",
+    description: "Get the list of available custom property keys from conversions and/or microconversions. Use this to discover what property keys exist before querying values or breakdowns.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            period: PERIOD_SCHEMA,
+            table: TABLE_SCHEMA,
+        },
+    },
+    handler: async (client, args) => {
+        return client.request("/stats/properties/keys", {
+            site_id: resolveSiteId(args),
+            period: args.period ?? "30d",
+            table: args.table ?? "both",
+        });
+    },
+};
+export const getPropertyValuesTool = {
+    name: "get_property_values",
+    description: "Get property values with counts, grouped by a UTM parameter. Paginated. Use to see which values a specific property key has and how they distribute across traffic sources.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            property_key: {
+                type: "string",
+                description: "The property key to analyze (e.g. 'product_name', 'plan_type').",
+            },
+            period: PERIOD_SCHEMA,
+            group_by: {
+                type: "string",
+                description: 'Group results by: "utm_source", "utm_medium", "utm_campaign", or "all". Default: "utm_source".',
+                enum: ["utm_source", "utm_medium", "utm_campaign", "all"],
+                default: "utm_source",
+            },
+            table: TABLE_SCHEMA,
+            conversion_type: {
+                type: "string",
+                description: "Filter by conversion type.",
+            },
+            limit: LIMIT_SCHEMA,
+            page: PAGE_SCHEMA,
+        },
+        required: ["property_key"],
+    },
+    handler: async (client, args) => {
+        return client.requestPaginated("/stats/properties/values", {
+            site_id: resolveSiteId(args),
+            property_key: args.property_key,
+            period: args.period ?? "30d",
+            group_by: args.group_by ?? "utm_source",
+            table: args.table ?? "both",
+            conversion_type: args.conversion_type,
+            page_size: String(args.limit ?? 50),
+            page: args.page != null ? String(args.page) : undefined,
+        });
+    },
+};
+export const getPropertyBreakdownTool = {
+    name: "get_property_breakdown",
+    description: "Get a complete property breakdown with pivot-table style data. Shows all values for a property key with their counts and revenue — ideal for analyzing product or category performance.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            property_key: {
+                type: "string",
+                description: "The property key to analyze (e.g. 'product_name', 'plan_type').",
+            },
+            period: PERIOD_SCHEMA,
+            table: TABLE_SCHEMA,
+            conversion_type: {
+                type: "string",
+                description: "Filter by conversion type.",
+            },
+        },
+        required: ["property_key"],
+    },
+    handler: async (client, args) => {
+        return client.request("/stats/properties/breakdown", {
+            site_id: resolveSiteId(args),
+            property_key: args.property_key,
+            period: args.period ?? "30d",
+            table: args.table ?? "both",
+            conversion_type: args.conversion_type,
+        });
+    },
+};
+//# sourceMappingURL=properties.js.map

package/dist/tools/properties.js.map

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

package/dist/tools/segments.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDef } from "./index.js";
+export declare const listSegmentsTool: ToolDef;
+export declare const getSegmentTool: ToolDef;
+//# sourceMappingURL=segments.d.ts.map

package/dist/tools/segments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"segments.d.ts","sourceRoot":"","sources":["../../src/tools/segments.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAO,MAAM,gBAAgB,EAAE,OAuB9B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,OAwB5B,CAAC"}

package/dist/tools/segments.js

@@ -0,0 +1,49 @@
+import { resolveSiteId } from "./shared.js";
+export const listSegmentsTool = {
+    name: "list_segments",
+    description: "List all segments available for a site. Segments are saved filter sets (e.g. 'Mobile users from Spain', 'Organic traffic') that can be applied to stats queries via the segment parameter.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID (account_id). Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            include_system: {
+                type: "boolean",
+                description: "Include system segments like 'All Traffic', 'Direct' (default: true).",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        return client.request("/segments", {
+            account_id: resolveSiteId(args),
+            include_system: args.include_system != null ? String(args.include_system) : undefined,
+        });
+    },
+};
+export const getSegmentTool = {
+    name: "get_segment",
+    description: "Get details of a specific segment including its filter definition. The segment_id can be either the segment ID (seg_xxx) or the segment name.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID (account_id). Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            segment_id: {
+                type: "string",
+                description: "Segment ID (seg_xxx) or segment name.",
+            },
+        },
+        required: ["segment_id"],
+    },
+    handler: async (client, args) => {
+        const segmentId = args.segment_id;
+        return client.request(`/segments/${encodeURIComponent(segmentId)}`, {
+            account_id: resolveSiteId(args),
+        });
+    },
+};
+//# sourceMappingURL=segments.js.map

package/dist/tools/segments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"segments.js","sourceRoot":"","sources":["../../src/tools/segments.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,CAAC,MAAM,gBAAgB,GAAY;IACvC,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,4LAA4L;IAC9L,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uEAAuE;aACrF;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,uEAAuE;aACrF;SACF;KACF;IACD,OAAO,EAAE,KAAK,EAAE,MAAyB,EAAE,IAA6B,EAAE,EAAE;QAC1E,OAAO,MAAM,CAAC,OAAO,CAAU,WAAW,EAAE;YAC1C,UAAU,EAAE,aAAa,CAAC,IAAI,CAAC;YAC/B,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS;SACtF,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAY;IACrC,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,+IAA+I;IACjJ,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uEAAuE;aACrF;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uCAAuC;aACrD;SACF;QACD,QAAQ,EAAE,CAAC,YAAY,CAAC;KACzB;IACD,OAAO,EAAE,KAAK,EAAE,MAAyB,EAAE,IAA6B,EAAE,EAAE;QAC1E,MAAM,SAAS,GAAG,IAAI,CAAC,UAAoB,CAAC;QAC5C,OAAO,MAAM,CAAC,OAAO,CAAU,aAAa,kBAAkB,CAAC,SAAS,CAAC,EAAE,EAAE;YAC3E,UAAU,EAAE,aAAa,CAAC,IAAI,CAAC;SAChC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}