@sealmetrics/mcp 0.1.0 → 1.2.0

package/dist/tools/audience.js

@@ -0,0 +1,146 @@
+import { PERIOD_SCHEMA, COMPARE_SCHEMA, LIMIT_SCHEMA, SORT_ORDER_SCHEMA, PAGE_SCHEMA, resolveSiteId, } from "./shared.js";
+export const getCountriesTool = {
+    name: "get_countries",
+    description: "Get traffic broken down by country. Shows entrances, pageviews, conversions, and revenue per country. Country codes follow ISO 3166-1 alpha-2 (e.g. ES=Spain, US=United States).",
+    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,
+        },
+    },
+    handler: async (client, args) => {
+        return client.requestPaginated("/stats/geo/countries", {
+            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",
+        });
+    },
+};
+export const getDevicesTool = {
+    name: "get_devices",
+    description: "Get traffic broken down by device type (desktop/mobile/tablet), browser (Chrome, Safari, Firefox...), and operating system (Windows, macOS, iOS, Android...). Returns all three breakdowns in a single call.",
+    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) => {
+        return client.request("/stats/devices", {
+            site_id: resolveSiteId(args),
+            period: args.period ?? "30d",
+            compare: args.compare,
+        });
+    },
+};
+export const getBrowsersTool = {
+    name: "get_browsers",
+    description: "Get traffic broken down by browser: Chrome, Safari, Firefox, Edge, etc. Shows entrances and pageviews per browser with pagination.",
+    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,
+            page: PAGE_SCHEMA,
+            country: {
+                type: "string",
+                description: "Filter by country code (e.g. 'ES', 'US').",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        return client.requestPaginated("/stats/browsers", {
+            site_id: resolveSiteId(args),
+            period: args.period ?? "30d",
+            page_size: String(args.limit ?? 20),
+            page: args.page != null ? String(args.page) : undefined,
+            country: args.country,
+        });
+    },
+};
+export const getOperatingSystemsTool = {
+    name: "get_operating_systems",
+    description: "Get traffic broken down by operating system: Windows, macOS, iOS, Android, Linux, etc. Shows entrances and pageviews per OS with pagination.",
+    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,
+            page: PAGE_SCHEMA,
+            country: {
+                type: "string",
+                description: "Filter by country code (e.g. 'ES', 'US').",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        return client.requestPaginated("/stats/operating-systems", {
+            site_id: resolveSiteId(args),
+            period: args.period ?? "30d",
+            page_size: String(args.limit ?? 20),
+            page: args.page != null ? String(args.page) : undefined,
+            country: args.country,
+        });
+    },
+};
+export const getDeviceTypesTool = {
+    name: "get_device_types",
+    description: "Get traffic broken down by device type (desktop, mobile, tablet) with pagination. Shows entrances, pageviews, conversions per device type.",
+    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,
+            page: PAGE_SCHEMA,
+            country: {
+                type: "string",
+                description: "Filter by country code (e.g. 'ES', 'US').",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        return client.requestPaginated("/stats/devices/types", {
+            site_id: resolveSiteId(args),
+            period: args.period ?? "30d",
+            page_size: String(args.limit ?? 10),
+            page: args.page != null ? String(args.page) : undefined,
+            country: args.country,
+        });
+    },
+};
+//# sourceMappingURL=audience.js.map

package/dist/tools/audience.js.map

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

package/dist/tools/bots.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"bots.d.ts","sourceRoot":"","sources":["../../src/tools/bots.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAO,MAAM,eAAe,EAAE,OAwB7B,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,OA0BvC,CAAC"}

package/dist/tools/bots.js

@@ -0,0 +1,52 @@
+import { LIMIT_SCHEMA, resolveSiteId } from "./shared.js";
+export const getBotStatsTool = {
+    name: "get_bot_stats",
+    description: "Get bot detection overview: score distribution, top suspicion flags, and daily trend of human vs suspected-bot traffic. Requires agent analytics to be enabled on the site.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID (account_id). Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            days: {
+                type: "number",
+                description: "Number of days to analyze (1-90, default: 30).",
+                default: 30,
+            },
+        },
+    },
+    handler: async (client, args) => {
+        return client.request("/bot-stats/overview", {
+            account_id: resolveSiteId(args),
+            days: String(args.days ?? 30),
+        });
+    },
+};
+export const getSuspiciousSessionsTool = {
+    name: "get_suspicious_sessions",
+    description: "Get sessions with high bot-suspicion scores for investigation. Shows session details, score, and detected flags. Useful for identifying automated traffic patterns.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID (account_id). Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            min_score: {
+                type: "number",
+                description: "Minimum suspicion score threshold (1-100, default: 50).",
+                default: 50,
+            },
+            limit: LIMIT_SCHEMA,
+        },
+    },
+    handler: async (client, args) => {
+        return client.request("/bot-stats/suspicious-sessions", {
+            account_id: resolveSiteId(args),
+            min_score: String(args.min_score ?? 50),
+            limit: String(args.limit ?? 20),
+        });
+    },
+};
+//# sourceMappingURL=bots.js.map

package/dist/tools/bots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bots.js","sourceRoot":"","sources":["../../src/tools/bots.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG1D,MAAM,CAAC,MAAM,eAAe,GAAY;IACtC,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,6KAA6K;IAC/K,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uEAAuE;aACrF;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gDAAgD;gBAC7D,OAAO,EAAE,EAAE;aACZ;SACF;KACF;IACD,OAAO,EAAE,KAAK,EAAE,MAAyB,EAAE,IAA6B,EAAE,EAAE;QAC1E,OAAO,MAAM,CAAC,OAAO,CAAU,qBAAqB,EAAE;YACpD,UAAU,EAAE,aAAa,CAAC,IAAI,CAAC;YAC/B,IAAI,EAAE,MAAM,CAAE,IAAI,CAAC,IAAe,IAAI,EAAE,CAAC;SAC1C,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAY;IAChD,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EACT,qKAAqK;IACvK,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uEAAuE;aACrF;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yDAAyD;gBACtE,OAAO,EAAE,EAAE;aACZ;YACD,KAAK,EAAE,YAAY;SACpB;KACF;IACD,OAAO,EAAE,KAAK,EAAE,MAAyB,EAAE,IAA6B,EAAE,EAAE;QAC1E,OAAO,MAAM,CAAC,OAAO,CAAU,gCAAgC,EAAE;YAC/D,UAAU,EAAE,aAAa,CAAC,IAAI,CAAC;YAC/B,SAAS,EAAE,MAAM,CAAE,IAAI,CAAC,SAAoB,IAAI,EAAE,CAAC;YACnD,KAAK,EAAE,MAAM,CAAE,IAAI,CAAC,KAAgB,IAAI,EAAE,CAAC;SAC5C,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/tools/channels.d.ts

@@ -0,0 +1,5 @@
+import type { ToolDef } from "./index.js";
+export declare const getChannelsTool: ToolDef;
+export declare const getTopChannelsTool: ToolDef;
+export declare const listChannelRulesTool: ToolDef;
+//# sourceMappingURL=channels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.ts","sourceRoot":"","sources":["../../src/tools/channels.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAO,MAAM,eAAe,EAAE,OA+B7B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,OA2BhC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,OA4BlC,CAAC"}

package/dist/tools/channels.js

@@ -0,0 +1,88 @@
+import { PERIOD_SCHEMA, LIMIT_SCHEMA, PAGE_SCHEMA, resolveSiteId, periodToDateRange } from "./shared.js";
+export const getChannelsTool = {
+    name: "get_channels",
+    description: "Get traffic metrics grouped by channel: Paid Search, Organic Search, Social, Direct, Email, Referral, etc. Channels are automatically classified based on UTM parameters and referrer rules.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID (account_id). Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            period: PERIOD_SCHEMA,
+            limit: LIMIT_SCHEMA,
+            page: PAGE_SCHEMA,
+            country: {
+                type: "string",
+                description: "Filter by country code (e.g. 'ES', 'US').",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        const { start_date, end_date } = periodToDateRange(args.period ?? "30d");
+        return client.request("/channel-groups/stats/channels", {
+            account_id: resolveSiteId(args),
+            start_date,
+            end_date,
+            page_size: String(args.limit ?? 20),
+            page: args.page != null ? String(args.page) : undefined,
+            country: args.country,
+        });
+    },
+};
+export const getTopChannelsTool = {
+    name: "get_top_channels",
+    description: "Get top channels ranked by entrances. Returns a compact list of the top N channels (Paid Search, Organic, Social, etc.) — 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,
+            country: {
+                type: "string",
+                description: "Filter by country code (e.g. 'ES', 'US').",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        return client.request("/stats/top-channels", {
+            site_id: resolveSiteId(args),
+            period: args.period ?? "30d",
+            limit: String(args.limit ?? 10),
+            country: args.country,
+        });
+    },
+};
+export const listChannelRulesTool = {
+    name: "list_channel_rules",
+    description: "List channel group rules configured for a site. Shows how traffic is classified into channels (Paid Search, Organic, Social, etc.) based on UTM parameters and referrer patterns.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID (account_id). Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            include_inactive: {
+                type: "boolean",
+                description: "Include inactive rules (default: false).",
+            },
+            include_defaults: {
+                type: "boolean",
+                description: "Include default system rules (default: true).",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        return client.request("/channel-groups", {
+            account_id: resolveSiteId(args),
+            include_inactive: args.include_inactive != null ? String(args.include_inactive) : undefined,
+            include_defaults: args.include_defaults != null ? String(args.include_defaults) : undefined,
+        });
+    },
+};
+//# sourceMappingURL=channels.js.map

package/dist/tools/channels.js.map

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

package/dist/tools/content.d.ts

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

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

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

package/dist/tools/content.js

@@ -0,0 +1,47 @@
+import { PERIOD_SCHEMA, resolveSiteId } from "./shared.js";
+export const getContentGroupsTool = {
+    name: "get_content_groups",
+    description: "Get metrics grouped by content group (content_grouping). Shows pageviews and entrances per content group. Useful for understanding which sections of a site get the most traffic.",
+    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', 'US').",
+            },
+            utm_source: {
+                type: "string",
+                description: "Filter by UTM source (e.g. 'google').",
+            },
+            utm_medium: {
+                type: "string",
+                description: "Filter by UTM medium (e.g. 'cpc').",
+            },
+            utm_campaign: {
+                type: "string",
+                description: "Filter by UTM campaign name.",
+            },
+            utm_term: {
+                type: "string",
+                description: "Filter by UTM term.",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        return client.request("/stats/pages/content-groups", {
+            site_id: resolveSiteId(args),
+            period: args.period ?? "30d",
+            country: args.country,
+            utm_source: args.utm_source,
+            utm_medium: args.utm_medium,
+            utm_campaign: args.utm_campaign,
+            utm_term: args.utm_term,
+        });
+    },
+};
+//# sourceMappingURL=content.js.map

package/dist/tools/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/tools/content.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG3D,MAAM,CAAC,MAAM,oBAAoB,GAAY;IAC3C,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,mLAAmL;IACrL,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,2CAA2C;aACzD;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uCAAuC;aACrD;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oCAAoC;aAClD;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8BAA8B;aAC5C;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qBAAqB;aACnC;SACF;KACF;IACD,OAAO,EAAE,KAAK,EAAE,MAAyB,EAAE,IAA6B,EAAE,EAAE;QAC1E,OAAO,MAAM,CAAC,OAAO,CAAU,6BAA6B,EAAE;YAC5D,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC;YAC5B,MAAM,EAAG,IAAI,CAAC,MAAiB,IAAI,KAAK;YACxC,OAAO,EAAE,IAAI,CAAC,OAA6B;YAC3C,UAAU,EAAE,IAAI,CAAC,UAAgC;YACjD,UAAU,EAAE,IAAI,CAAC,UAAgC;YACjD,YAAY,EAAE,IAAI,CAAC,YAAkC;YACrD,QAAQ,EAAE,IAAI,CAAC,QAA8B;SAC9C,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/tools/conversions.d.ts

@@ -0,0 +1,6 @@
+import type { ToolDef } from "./index.js";
+export declare const getConversionsTool: ToolDef;
+export declare const getMicroconversionsTool: ToolDef;
+export declare const listMicroconversionTypesTool: ToolDef;
+export declare const getMicroconversionDetailsTool: ToolDef;
+//# sourceMappingURL=conversions.d.ts.map

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,OAkDhC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,OAwCrC,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,OAoB1C,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,OAkE3C,CAAC"}

package/dist/tools/conversions.js

@@ -0,0 +1,178 @@
+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 to analyze which conversion goals are performing best.",
+    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.",
+    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,
+        });
+    },
+};
+//# 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":"AACA,OAAO,EACL,aAAa,EACb,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,aAAa,CAAC;AAGrB,MAAM,CAAC,MAAM,kBAAkB,GAAY;IACzC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,4LAA4L;IAC9L,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,cAAc;YACvB,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mBAAmB;gBAChC,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,CAAC;gBACvC,OAAO,EAAE,OAAO;aACjB;YACD,UAAU,EAAE,iBAAiB;YAC7B,IAAI,EAAE,WAAW;YACjB,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2BAA2B;aACzC;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2BAA2B;aACzC;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2CAA2C;aACzD;SACF;KACF;IACD,OAAO,EAAE,KAAK,EAAE,MAAyB,EAAE,IAA6B,EAAE,EAAE;QAC1E,OAAO,MAAM,CAAC,gBAAgB,CAAC,oBAAoB,EAAE;YACnD,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC;YAC5B,MAAM,EAAG,IAAI,CAAC,MAAiB,IAAI,KAAK;YACxC,OAAO,EAAE,IAAI,CAAC,OAA6B;YAC3C,SAAS,EAAE,MAAM,CAAE,IAAI,CAAC,KAAgB,IAAI,EAAE,CAAC;YAC/C,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAc,CAAC,CAAC,CAAC,CAAC,SAAS;YACjE,OAAO,EAAG,IAAI,CAAC,OAAkB,IAAI,OAAO;YAC5C,UAAU,EAAG,IAAI,CAAC,UAAqB,IAAI,MAAM;YACjD,UAAU,EAAE,IAAI,CAAC,UAAgC;YACjD,UAAU,EAAE,IAAI,CAAC,UAAgC;YACjD,OAAO,EAAE,IAAI,CAAC,OAA6B;SAC5C,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAY;IAC9C,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,iKAAiK;IACnK,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,cAAc;YACvB,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mBAAmB;gBAChC,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,CAAC;gBACvC,OAAO,EAAE,OAAO;aACjB;YACD,UAAU,EAAE,iBAAiB;YAC7B,IAAI,EAAE,WAAW;YACjB,eAAe,EAAE;gBACf,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0CAA0C;aACxD;SACF;KACF;IACD,OAAO,EAAE,KAAK,EAAE,MAAyB,EAAE,IAA6B,EAAE,EAAE;QAC1E,OAAO,MAAM,CAAC,gBAAgB,CAAC,yBAAyB,EAAE;YACxD,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC;YAC5B,MAAM,EAAG,IAAI,CAAC,MAAiB,IAAI,KAAK;YACxC,OAAO,EAAE,IAAI,CAAC,OAA6B;YAC3C,SAAS,EAAE,MAAM,CAAE,IAAI,CAAC,KAAgB,IAAI,EAAE,CAAC;YAC/C,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAc,CAAC,CAAC,CAAC,CAAC,SAAS;YACjE,OAAO,EAAG,IAAI,CAAC,OAAkB,IAAI,OAAO;YAC5C,UAAU,EAAG,IAAI,CAAC,UAAqB,IAAI,MAAM;YACjD,eAAe,EAAE,IAAI,CAAC,eAAqC;SAC5D,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAY;IACnD,IAAI,EAAE,4BAA4B;IAClC,WAAW,EACT,iJAAiJ;IACnJ,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;SACtB;KACF;IACD,OAAO,EAAE,KAAK,EAAE,MAAyB,EAAE,IAA6B,EAAE,EAAE;QAC1E,OAAO,MAAM,CAAC,OAAO,CAAU,+BAA+B,EAAE;YAC9D,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC;YAC5B,MAAM,EAAG,IAAI,CAAC,MAAiB,IAAI,KAAK;SACzC,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,6BAA6B,GAAY;IACpD,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,oJAAoJ;IACtJ,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0DAA0D;aACxE;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wFAAwF;aACtG;YACD,MAAM,EAAE,aAAa;YACrB,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uBAAuB;aACrC;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uBAAuB;aACrC;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yBAAyB;aACvC;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qBAAqB;aACnC;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2CAA2C;aACzD;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6DAA6D;aAC3E;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yBAAyB;aACvC;YACD,EAAE,EAAE;gBACF,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kCAAkC;aAChD;SACF;QACD,QAAQ,EAAE,CAAC,iBAAiB,CAAC;KAC9B;IACD,OAAO,EAAE,KAAK,EAAE,MAAyB,EAAE,IAA6B,EAAE,EAAE;QAC1E,MAAM,cAAc,GAAG,IAAI,CAAC,eAAyB,CAAC;QACtD,OAAO,MAAM,CAAC,OAAO,CAAU,2BAA2B,kBAAkB,CAAC,cAAc,CAAC,EAAE,EAAE;YAC9F,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC;YAC5B,MAAM,EAAG,IAAI,CAAC,MAAiB,IAAI,KAAK;YACxC,UAAU,EAAE,IAAI,CAAC,UAAgC;YACjD,UAAU,EAAE,IAAI,CAAC,UAAgC;YACjD,YAAY,EAAE,IAAI,CAAC,YAAkC;YACrD,QAAQ,EAAE,IAAI,CAAC,QAA8B;YAC7C,OAAO,EAAE,IAAI,CAAC,OAA6B;YAC3C,WAAW,EAAE,IAAI,CAAC,WAAiC;YACnD,OAAO,EAAE,IAAI,CAAC,OAA6B;YAC3C,EAAE,EAAE,IAAI,CAAC,EAAwB;SAClC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

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;AAgDtD,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,EA2D9B,CAAC"}