@sealmetrics/mcp 0.1.0 → 1.3.0

package/dist/server.js

@@ -0,0 +1,132 @@
+/**
+ * Server factory (Fase 3 Bloque 2). Builds the McpServer, registers the ~47
+ * read-only data tools (with `readOnlyHint` and retained handles, RF-3206) and the
+ * write-path setup tools, and wires the relaxed startup gate (RF-3202) + dynamic
+ * read-only enablement after provisioning (RF-3202b).
+ *
+ * Extracted from index.ts so it can be unit-tested without a stdio transport:
+ * tests inspect `readOnlyHandles[].enabled` and invoke `setupTools[].handler`.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { SealMetricsClient } from "./client.js";
+import { ALL_TOOLS } from "./tools/index.js";
+import { createSetupTools } from "./tools/setup.js";
+import { INSTALL_SOURCE } from "./embedded.js";
+import { TRACKING_GUIDE_URI, TRACKING_GUIDE_NAME, TRACKING_GUIDE_DESCRIPTION, TRACKING_GUIDE_CONTENT, } from "./resources/tracking-guide.js";
+const MAX_RESPONSE_LENGTH = 100_000;
+function jsonSchemaToZod(prop) {
+    const type = prop.type;
+    const enumValues = prop.enum;
+    const description = prop.description;
+    let schema;
+    if (enumValues && enumValues.length > 0) {
+        schema = z.enum(enumValues);
+    }
+    else if (type === "number" || type === "integer") {
+        schema = z.number();
+    }
+    else if (type === "boolean") {
+        schema = z.boolean();
+    }
+    else {
+        schema = z.string();
+    }
+    if (description)
+        schema = schema.describe(description);
+    return schema;
+}
+function buildShape(properties) {
+    const shape = {};
+    for (const [key, prop] of Object.entries(properties)) {
+        shape[key] = jsonSchemaToZod(prop).optional();
+    }
+    return shape;
+}
+function safeStringify(value) {
+    try {
+        const json = JSON.stringify(value, null, 2);
+        if (json.length > MAX_RESPONSE_LENGTH) {
+            return json.slice(0, MAX_RESPONSE_LENGTH) + "\n... (truncated)";
+        }
+        return json;
+    }
+    catch {
+        return '{"error": "Response could not be serialized"}';
+    }
+}
+function toToolResult(result) {
+    return { content: [{ type: "text", text: safeStringify(result) }] };
+}
+function toErrorResult(error) {
+    const message = error instanceof Error ? error.message : "Unknown error occurred";
+    return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+}
+export function buildServer(opts) {
+    const client = new SealMetricsClient(opts.apiKey, opts.baseUrl);
+    const server = new McpServer({ name: "sealmetrics", version: opts.version });
+    // Read-only data tools (~47): registerTool → readOnlyHint + retained handle.
+    // Without an api_key they are registered but DISABLED (hidden from tools/list);
+    // provision_site enables them in-session (RF-3202b).
+    const readOnlyHandles = ALL_TOOLS.map((tool) => {
+        const handle = server.registerTool(tool.name, {
+            description: tool.description,
+            inputSchema: buildShape(tool.inputSchema.properties),
+            annotations: { title: tool.name, readOnlyHint: true },
+        }, async (args) => {
+            try {
+                return toToolResult(await tool.handler(client, args));
+            }
+            catch (error) {
+                return toErrorResult(error);
+            }
+        });
+        if (!client.hasApiKey())
+            handle.disable();
+        return handle;
+    });
+    const enableReadOnlyTools = () => {
+        for (const handle of readOnlyHandles) {
+            if (!handle.enabled)
+                handle.enable(); // fires notifications/tools/list_changed
+        }
+    };
+    // Write-path setup tools.
+    const setupState = { provisioned: false, pixelVerified: false };
+    const setupContext = {
+        client,
+        baseUrl: opts.baseUrl,
+        provisionKey: opts.provisionKey,
+        installSource: opts.installSource ?? INSTALL_SOURCE,
+        cwd: opts.cwd,
+        state: setupState,
+        onProvisioned: (apiKey, _accountId) => {
+            client.setApiKey(apiKey); // in memory only (VAL-3201)
+            enableReadOnlyTools(); // RF-3202b (accountId already set on ctx.state by the handler)
+        },
+        pollDefaults: opts.pollDefaults,
+        now: opts.now,
+        sleep: opts.sleep,
+    };
+    const setupTools = createSetupTools(setupContext);
+    for (const tool of setupTools) {
+        server.registerTool(tool.name, {
+            description: tool.description,
+            inputSchema: buildShape(tool.inputSchema.properties),
+            annotations: tool.annotations,
+        }, async (args) => {
+            try {
+                return toToolResult(await tool.handler(args));
+            }
+            catch (error) {
+                return toErrorResult(error);
+            }
+        });
+    }
+    // Resources
+    server.resource(TRACKING_GUIDE_NAME, TRACKING_GUIDE_URI, { description: TRACKING_GUIDE_DESCRIPTION, mimeType: "text/markdown" }, async () => ({
+        contents: [{ uri: TRACKING_GUIDE_URI, mimeType: "text/markdown", text: TRACKING_GUIDE_CONTENT }],
+    }));
+    return { server, client, readOnlyHandles, setupTools, setupContext, enableReadOnlyTools };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/alerts.d.ts

@@ -0,0 +1,5 @@
+import type { ToolDef } from "./index.js";
+export declare const listAlertsTool: ToolDef;
+export declare const getAlertHistoryTool: ToolDef;
+export declare const getAlertStatsTool: ToolDef;
+//# sourceMappingURL=alerts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../../src/tools/alerts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAO,MAAM,cAAc,EAAE,OAuB5B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,OAqCjC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,OAkB/B,CAAC"}

package/dist/tools/alerts.js

@@ -0,0 +1,80 @@
+import { LIMIT_SCHEMA, resolveSiteId } from "./shared.js";
+export const listAlertsTool = {
+    name: "list_alerts",
+    description: "List alert rules configured for a site. Shows rule name, metric, condition, threshold, and status (active/paused). Alerts monitor metrics and trigger notifications when thresholds are crossed.",
+    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/paused alert rules (default: false).",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        return client.requestDirect("/alerts/rules", {
+            account_id: resolveSiteId(args),
+            include_inactive: args.include_inactive != null ? String(args.include_inactive) : undefined,
+        });
+    },
+};
+export const getAlertHistoryTool = {
+    name: "get_alert_history",
+    description: "Get history of triggered alerts: when they fired, current status (active/resolved/acknowledged), and which rule triggered them. Useful for reviewing past incidents.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID (account_id). Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            rule_id: {
+                type: "number",
+                description: "Filter by specific alert rule ID.",
+            },
+            status: {
+                type: "string",
+                description: "Filter by alert status.",
+                enum: ["active", "resolved", "acknowledged"],
+            },
+            limit: LIMIT_SCHEMA,
+            offset: {
+                type: "number",
+                description: "Offset for pagination (default: 0).",
+                default: 0,
+            },
+        },
+    },
+    handler: async (client, args) => {
+        return client.requestDirect("/alerts/history", {
+            account_id: resolveSiteId(args),
+            rule_id: args.rule_id != null ? String(args.rule_id) : undefined,
+            status: args.status,
+            limit: String(args.limit ?? 50),
+            offset: args.offset != null ? String(args.offset) : undefined,
+        });
+    },
+};
+export const getAlertStatsTool = {
+    name: "get_alert_stats",
+    description: "Get alert statistics for a site: total rules, active alerts, resolved count, and acknowledgement rate. Provides a quick health overview of the alerting system.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID (account_id). Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        return client.requestDirect("/alerts/stats", {
+            account_id: resolveSiteId(args),
+        });
+    },
+};
+//# sourceMappingURL=alerts.js.map

package/dist/tools/alerts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts.js","sourceRoot":"","sources":["../../src/tools/alerts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG1D,MAAM,CAAC,MAAM,cAAc,GAAY;IACrC,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,kMAAkM;IACpM,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uEAAuE;aACrF;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,uDAAuD;aACrE;SACF;KACF;IACD,OAAO,EAAE,KAAK,EAAE,MAAyB,EAAE,IAA6B,EAAE,EAAE;QAC1E,OAAO,MAAM,CAAC,aAAa,CAAU,eAAe,EAAE;YACpD,UAAU,EAAE,aAAa,CAAC,IAAI,CAAC;YAC/B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS;SAC5F,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAY;IAC1C,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,sKAAsK;IACxK,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uEAAuE;aACrF;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mCAAmC;aACjD;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yBAAyB;gBACtC,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,cAAc,CAAC;aAC7C;YACD,KAAK,EAAE,YAAY;YACnB,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qCAAqC;gBAClD,OAAO,EAAE,CAAC;aACX;SACF;KACF;IACD,OAAO,EAAE,KAAK,EAAE,MAAyB,EAAE,IAA6B,EAAE,EAAE;QAC1E,OAAO,MAAM,CAAC,aAAa,CAAU,iBAAiB,EAAE;YACtD,UAAU,EAAE,aAAa,CAAC,IAAI,CAAC;YAC/B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;YAChE,MAAM,EAAE,IAAI,CAAC,MAA4B;YACzC,KAAK,EAAE,MAAM,CAAE,IAAI,CAAC,KAAgB,IAAI,EAAE,CAAC;YAC3C,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAgB,CAAC,CAAC,CAAC,CAAC,SAAS;SACxE,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAY;IACxC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,iKAAiK;IACnK,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uEAAuE;aACrF;SACF;KACF;IACD,OAAO,EAAE,KAAK,EAAE,MAAyB,EAAE,IAA6B,EAAE,EAAE;QAC1E,OAAO,MAAM,CAAC,aAAa,CAAU,eAAe,EAAE;YACpD,UAAU,EAAE,aAAa,CAAC,IAAI,CAAC;SAChC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/tools/audience.d.ts

@@ -0,0 +1,7 @@
+import type { ToolDef } from "./index.js";
+export declare const getCountriesTool: ToolDef;
+export declare const getDevicesTool: ToolDef;
+export declare const getBrowsersTool: ToolDef;
+export declare const getOperatingSystemsTool: ToolDef;
+export declare const getDeviceTypesTool: ToolDef;
+//# sourceMappingURL=audience.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audience.d.ts","sourceRoot":"","sources":["../../src/tools/audience.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAO,MAAM,gBAAgB,EAAE,OAmC9B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,OAsB5B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,OA6B7B,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,OA6BrC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,OA6BhC,CAAC"}

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 } 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) => {
+        // Pass `period` through as-is; the API resolves it with "today" in the
+        // account's timezone (PRD-029 RF-008). No client-side date pre-resolution.
+        return client.request("/channel-groups/stats/channels", {
+            account_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 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,9 @@
+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;
+export declare const getConversionsRawTool: ToolDef;
+export declare const getMicroconversionsRawTool: ToolDef;
+export declare const getConversionItemsRawTool: ToolDef;
+//# sourceMappingURL=conversions.d.ts.map