@sealmetrics/mcp 0.1.0 → 1.3.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversions.d.ts","sourceRoot":"","sources":["../../src/tools/conversions.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAO,MAAM,kBAAkB,EAAE,OAoDhC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,OAyCrC,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,OAoB1C,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,OAkE3C,CAAC;AA2KF,eAAO,MAAM,qBAAqB,EAAE,OAwCnC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,OAuCxC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,OA+BvC,CAAC"}

package/dist/tools/conversions.js

@@ -0,0 +1,427 @@
+import { PERIOD_SCHEMA, COMPARE_SCHEMA, LIMIT_SCHEMA, SORT_ORDER_SCHEMA, PAGE_SCHEMA, resolveSiteId, } from "./shared.js";
+export const getConversionsTool = {
+    name: "get_conversions",
+    description: "Get conversions broken down by type (e.g. purchase, signup). Shows count, revenue, and average order value per conversion type. " +
+        "Use for aggregated counts/revenue by conversion type. " +
+        "**For per-event detail or per-product analysis use `get_conversions_raw` or `get_conversion_items_raw`.**",
+    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: ["count", "revenue", "avg_value"],
+                default: "count",
+            },
+            sort_order: SORT_ORDER_SCHEMA,
+            page: PAGE_SCHEMA,
+            utm_source: {
+                type: "string",
+                description: "Filter by traffic source.",
+            },
+            utm_medium: {
+                type: "string",
+                description: "Filter by traffic medium.",
+            },
+            country: {
+                type: "string",
+                description: "Filter by country code (e.g. 'ES', 'US').",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        return client.requestPaginated("/stats/conversions", {
+            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 ?? "count",
+            sort_order: args.sort_order ?? "desc",
+            utm_source: args.utm_source,
+            utm_medium: args.utm_medium,
+            country: args.country,
+        });
+    },
+};
+export const getMicroconversionsTool = {
+    name: "get_microconversions",
+    description: "Get microconversions (smaller engagement events) broken down by type: add_to_cart, newsletter_signup, pdf_download, etc. Shows count and trends per event type. " +
+        "**For per-event detail use `get_microconversions_raw`.**",
+    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: ["count", "revenue", "avg_value"],
+                default: "count",
+            },
+            sort_order: SORT_ORDER_SCHEMA,
+            page: PAGE_SCHEMA,
+            conversion_type: {
+                type: "string",
+                description: "Filter by specific microconversion type.",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        return client.requestPaginated("/stats/microconversions", {
+            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 ?? "count",
+            sort_order: args.sort_order ?? "desc",
+            conversion_type: args.conversion_type,
+        });
+    },
+};
+export const listMicroconversionTypesTool = {
+    name: "list_microconversion_types",
+    description: "Get the list of available microconversion type names for a site. Use this to discover what microconversion types exist before querying details.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            period: PERIOD_SCHEMA,
+        },
+    },
+    handler: async (client, args) => {
+        return client.request("/stats/microconversions-types", {
+            site_id: resolveSiteId(args),
+            period: args.period ?? "30d",
+        });
+    },
+};
+export const getMicroconversionDetailsTool = {
+    name: "get_microconversion_details",
+    description: "Get detailed breakdown for a specific microconversion type. Shows metrics segmented by source, medium, campaign, country, device, browser, and OS.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            conversion_type: {
+                type: "string",
+                description: "The microconversion type to get details for (e.g. 'add_to_cart', 'newsletter_signup').",
+            },
+            period: PERIOD_SCHEMA,
+            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.",
+            },
+            country: {
+                type: "string",
+                description: "Filter by country code (e.g. 'ES', 'US').",
+            },
+            device_type: {
+                type: "string",
+                description: "Filter by device type (e.g. 'desktop', 'mobile', 'tablet').",
+            },
+            browser: {
+                type: "string",
+                description: "Filter by browser name.",
+            },
+            os: {
+                type: "string",
+                description: "Filter by operating system name.",
+            },
+        },
+        required: ["conversion_type"],
+    },
+    handler: async (client, args) => {
+        const conversionType = args.conversion_type;
+        return client.request(`/stats/microconversions/${encodeURIComponent(conversionType)}`, {
+            site_id: resolveSiteId(args),
+            period: args.period ?? "30d",
+            utm_source: args.utm_source,
+            utm_medium: args.utm_medium,
+            utm_campaign: args.utm_campaign,
+            utm_term: args.utm_term,
+            country: args.country,
+            device_type: args.device_type,
+            browser: args.browser,
+            os: args.os,
+        });
+    },
+};
+// =============================================================================
+// Raw event-level tools (PRD 08 — extends PRD 03 raw endpoints to MCP).
+// =============================================================================
+//
+// LLM context budget guardrails:
+// - `limit` capped at 100 (API allows up to 10000 — we cap to avoid burning
+//   tokens). Validated by JSON Schema; oversized requests fail before reaching
+//   the API.
+// - `include_properties` defaults to false on conversions/microconversions —
+//   custom properties are noisy metadata that rarely help answer questions.
+//   Pass `include_properties=true` to receive the full `properties` object.
+// - `get_conversion_items_raw` always returns properties (sku/price/qty live there).
+const RAW_LIMIT_SCHEMA = {
+    type: "number",
+    description: "Maximum number of rows to return (default: 10, max: 100). MCP-side cap to control token usage.",
+    default: 10,
+    minimum: 1,
+    maximum: 100,
+};
+const RAW_FILTER_KEYS = [
+    "conversion_type",
+    "country",
+    "device_type",
+    "browser",
+    "os",
+    "channel_group",
+    "utm_source",
+    "utm_medium",
+    "utm_campaign",
+    "utm_term",
+    "utm_content",
+];
+function pickRawFilters(args) {
+    const out = {};
+    for (const key of RAW_FILTER_KEYS) {
+        const value = args[key];
+        if (Array.isArray(value) && value.length > 0) {
+            out[key] = value;
+        }
+    }
+    return out;
+}
+function buildRawDates(args) {
+    const startDate = args.start_date;
+    const endDate = args.end_date;
+    if (startDate && endDate) {
+        return { start_date: startDate, end_date: endDate };
+    }
+    return { period: args.period ?? "30d" };
+}
+const RAW_DATE_SCHEMA = {
+    period: PERIOD_SCHEMA,
+    start_date: {
+        type: "string",
+        description: "Custom start date (YYYY-MM-DD). Use together with end_date as an alternative to period. Date range capped at 31 days by the API.",
+    },
+    end_date: {
+        type: "string",
+        description: "Custom end date (YYYY-MM-DD). Use together with start_date.",
+    },
+};
+const RAW_MULTI_FILTER_SCHEMA = {
+    conversion_type: {
+        type: "array",
+        items: { type: "string", minLength: 1 },
+        minItems: 1,
+        description: "Filter by conversion type (e.g. ['purchase']).",
+    },
+    country: {
+        type: "array",
+        items: { type: "string", minLength: 1 },
+        minItems: 1,
+        description: "Filter by country code (e.g. ['ES', 'US']).",
+    },
+    device_type: {
+        type: "array",
+        items: { type: "string", minLength: 1 },
+        minItems: 1,
+        description: "Filter by device type (e.g. ['mobile']).",
+    },
+    browser: {
+        type: "array",
+        items: { type: "string", minLength: 1 },
+        minItems: 1,
+        description: "Filter by browser.",
+    },
+    os: {
+        type: "array",
+        items: { type: "string", minLength: 1 },
+        minItems: 1,
+        description: "Filter by operating system.",
+    },
+    channel_group: {
+        type: "array",
+        items: { type: "string", minLength: 1 },
+        minItems: 1,
+        description: "Filter by channel group.",
+    },
+    utm_source: {
+        type: "array",
+        items: { type: "string", minLength: 1 },
+        minItems: 1,
+        description: "Filter by UTM source.",
+    },
+    utm_medium: {
+        type: "array",
+        items: { type: "string", minLength: 1 },
+        minItems: 1,
+        description: "Filter by UTM medium.",
+    },
+    utm_campaign: {
+        type: "array",
+        items: { type: "string", minLength: 1 },
+        minItems: 1,
+        description: "Filter by UTM campaign.",
+    },
+    utm_term: {
+        type: "array",
+        items: { type: "string", minLength: 1 },
+        minItems: 1,
+        description: "Filter by UTM term.",
+    },
+    utm_content: {
+        type: "array",
+        items: { type: "string", minLength: 1 },
+        minItems: 1,
+        description: "Filter by UTM content.",
+    },
+};
+function stripProperties(result) {
+    return {
+        ...result,
+        data: result.data.map((row) => {
+            const { properties: _omit, ...rest } = row;
+            return rest;
+        }),
+    };
+}
+export const getConversionsRawTool = {
+    name: "get_conversions_raw",
+    description: "Returns raw conversion rows from /stats/conversions/raw (one row per event, with timestamp_utc and timestamp_local). " +
+        "Use for one-row-per-event detail. " +
+        "**For per-product/SKU analysis prefer `get_conversion_items_raw` (always includes item properties like sku, price, quantity).** " +
+        "Custom `properties` are excluded by default — pass `include_properties=true` to receive them. " +
+        "Date range capped at 31 days; page_size capped at 100 to control token usage.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            ...RAW_DATE_SCHEMA,
+            page: PAGE_SCHEMA,
+            limit: RAW_LIMIT_SCHEMA,
+            include_properties: {
+                type: "boolean",
+                description: "If true, include the custom `properties` object in each row. Default false to keep responses compact.",
+                default: false,
+            },
+            ...RAW_MULTI_FILTER_SCHEMA,
+        },
+    },
+    handler: async (client, args) => {
+        const limit = args.limit ?? 10;
+        const includeProperties = args.include_properties === true;
+        const dates = buildRawDates(args);
+        const result = await client.requestPaginated("/stats/conversions/raw", {
+            site_id: resolveSiteId(args),
+            ...dates,
+            page_size: String(limit),
+            page: args.page != null ? String(args.page) : undefined,
+            ...pickRawFilters(args),
+        });
+        return includeProperties ? result : stripProperties(result);
+    },
+};
+export const getMicroconversionsRawTool = {
+    name: "get_microconversions_raw",
+    description: "Returns raw microconversion rows from /stats/microconversions/raw (one row per event, with timestamp_utc and timestamp_local). " +
+        "Use for one-row-per-event detail of microconversions (add_to_cart, newsletter_signup, etc.). " +
+        "Custom `properties` are excluded by default — pass `include_properties=true` to receive them. " +
+        "Date range capped at 31 days; page_size capped at 100 to control token usage.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            ...RAW_DATE_SCHEMA,
+            page: PAGE_SCHEMA,
+            limit: RAW_LIMIT_SCHEMA,
+            include_properties: {
+                type: "boolean",
+                description: "If true, include the custom `properties` object in each row. Default false to keep responses compact.",
+                default: false,
+            },
+            ...RAW_MULTI_FILTER_SCHEMA,
+        },
+    },
+    handler: async (client, args) => {
+        const limit = args.limit ?? 10;
+        const includeProperties = args.include_properties === true;
+        const dates = buildRawDates(args);
+        const result = await client.requestPaginated("/stats/microconversions/raw", {
+            site_id: resolveSiteId(args),
+            ...dates,
+            page_size: String(limit),
+            page: args.page != null ? String(args.page) : undefined,
+            ...pickRawFilters(args),
+        });
+        return includeProperties ? result : stripProperties(result);
+    },
+};
+export const getConversionItemsRawTool = {
+    name: "get_conversion_items_raw",
+    description: "Returns one row per item inside a conversion (e.g. one row per product in a purchase) from /stats/conversion-items/raw. " +
+        "`properties` always included — that's where product_id, sku, price, quantity live. " +
+        "**Best tool for per-product analytics.** " +
+        "Date range capped at 31 days; page_size capped at 100 to control token usage.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            ...RAW_DATE_SCHEMA,
+            page: PAGE_SCHEMA,
+            limit: RAW_LIMIT_SCHEMA,
+            ...RAW_MULTI_FILTER_SCHEMA,
+        },
+    },
+    handler: async (client, args) => {
+        const limit = args.limit ?? 10;
+        const dates = buildRawDates(args);
+        return client.requestPaginated("/stats/conversion-items/raw", {
+            site_id: resolveSiteId(args),
+            ...dates,
+            page_size: String(limit),
+            page: args.page != null ? String(args.page) : undefined,
+            ...pickRawFilters(args),
+        });
+    },
+};
+//# sourceMappingURL=conversions.js.map

package/dist/tools/conversions.js.map

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

package/dist/tools/funnel.d.ts

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

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

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

package/dist/tools/funnel.js

@@ -0,0 +1,27 @@
+import { PERIOD_SCHEMA, resolveSiteId } from "./shared.js";
+export const getFunnelTool = {
+    name: "get_funnel",
+    description: "Get funnel analysis showing conversion rates between steps. Returns step-by-step data including visitor count, conversion rate, and dropoff at each stage. Useful for finding where users drop off in multi-step flows.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            period: PERIOD_SCHEMA,
+            country: {
+                type: "string",
+                description: "Filter by country code (e.g. 'ES').",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        return client.request("/stats/funnel", {
+            site_id: resolveSiteId(args),
+            period: args.period ?? "30d",
+            country: args.country,
+        });
+    },
+};
+//# sourceMappingURL=funnel.js.map

package/dist/tools/funnel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"funnel.js","sourceRoot":"","sources":["../../src/tools/funnel.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG3D,MAAM,CAAC,MAAM,aAAa,GAAY;IACpC,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,yNAAyN;IAC3N,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0DAA0D;aACxE;YACD,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qCAAqC;aACnD;SACF;KACF;IACD,OAAO,EAAE,KAAK,EAAE,MAAyB,EAAE,IAA6B,EAAE,EAAE;QAC1E,OAAO,MAAM,CAAC,OAAO,CAAe,eAAe,EAAE;YACnD,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC;YAC5B,MAAM,EAAG,IAAI,CAAC,MAAiB,IAAI,KAAK;YACxC,OAAO,EAAE,IAAI,CAAC,OAA6B;SAC5C,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,16 @@
+import type { SealMetricsClient } from "../client.js";
+export { PERIOD_SCHEMA, COMPARE_SCHEMA, LIMIT_SCHEMA, SORT_ORDER_SCHEMA, PAGE_SCHEMA, resolveSiteId, } from "./shared.js";
+/** Tool definition with name, description, schema, and handler. */
+export interface ToolDef {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+    handler: (client: SealMetricsClient, args: Record<string, unknown>) => Promise<unknown>;
+}
+/** All registered tools. */
+export declare const ALL_TOOLS: ToolDef[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAmDtD,OAAO,EACL,aAAa,EACb,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,mEAAmE;AACnE,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,OAAO,EAAE,CACP,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB;AAED,4BAA4B;AAC5B,eAAO,MAAM,SAAS,EAAE,OAAO,EA+D9B,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,83 @@
+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, getConversionsRawTool, getMicroconversionsRawTool, getConversionItemsRawTool, } 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,
+    // Conversions — raw event-level (PRD 08)
+    getConversionsRawTool,
+    getMicroconversionsRawTool,
+    getConversionItemsRawTool,
+    // 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,EAC7B,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,GAC1B,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,yCAAyC;IACzC,qBAAqB;IACrB,0BAA0B;IAC1B,yBAAyB;IACzB,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/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;AAiG1C,eAAO,MAAM,YAAY,EAAE,OA8C1B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,OA6CjC,CAAC;AAIF,eAAO,MAAM,eAAe,EAAE,OA+C7B,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,OA0CpC,CAAC;AAEF,eAAO,MAAM,iCAAiC,EAAE,OAmC/C,CAAC"}