@sealmetrics/mcp 0.1.0 → 1.2.0

package/dist/tools/traffic.js

@@ -0,0 +1,273 @@
+import { PERIOD_SCHEMA, COMPARE_SCHEMA, LIMIT_SCHEMA, SORT_ORDER_SCHEMA, PAGE_SCHEMA, resolveSiteId, } from "./shared.js";
+const TRAFFIC_SORT_BY = {
+    type: "string",
+    description: "Field to sort by.",
+    enum: ["entrances", "engaged_entrances", "page_views", "conversions", "revenue", "bounce_rate"],
+    default: "entrances",
+};
+function trafficParams(args) {
+    return {
+        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 getTrafficSourcesTool = {
+    name: "get_traffic_sources",
+    description: "Get traffic broken down by source (utm_source): google, facebook, twitter, direct, etc. Shows entrances, pageviews, conversions, and revenue per source.",
+    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,
+            page: PAGE_SCHEMA,
+            sort_by: TRAFFIC_SORT_BY,
+            sort_order: SORT_ORDER_SCHEMA,
+        },
+    },
+    handler: async (client, args) => {
+        return client.requestPaginated("/stats/sources", trafficParams(args));
+    },
+};
+export const getTrafficMediumsTool = {
+    name: "get_traffic_mediums",
+    description: "Get traffic broken down by medium (utm_medium): organic, cpc, email, referral, social, etc. Useful for understanding which marketing channels drive traffic.",
+    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,
+            page: PAGE_SCHEMA,
+            sort_by: TRAFFIC_SORT_BY,
+            sort_order: SORT_ORDER_SCHEMA,
+        },
+    },
+    handler: async (client, args) => {
+        return client.requestPaginated("/stats/mediums", trafficParams(args));
+    },
+};
+export const getCampaignsTool = {
+    name: "get_campaigns",
+    description: "Get traffic and conversions broken down by campaign (utm_campaign). Shows performance of individual marketing campaigns including entrances, conversions, and revenue.",
+    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,
+            page: PAGE_SCHEMA,
+            sort_by: TRAFFIC_SORT_BY,
+            sort_order: SORT_ORDER_SCHEMA,
+            utm_source: {
+                type: "string",
+                description: "Filter by source (e.g. 'google').",
+            },
+            utm_medium: {
+                type: "string",
+                description: "Filter by medium (e.g. 'cpc').",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        const params = trafficParams(args);
+        params.utm_source = args.utm_source;
+        params.utm_medium = args.utm_medium;
+        return client.requestPaginated("/stats/campaigns", params);
+    },
+};
+export const getTermsTool = {
+    name: "get_terms",
+    description: "Get traffic and conversions broken down by UTM term (keyword). Shows which search keywords or ad terms drive the most traffic. Supports filtering by source, medium, and campaign.",
+    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,
+            page: PAGE_SCHEMA,
+            sort_by: TRAFFIC_SORT_BY,
+            sort_order: SORT_ORDER_SCHEMA,
+            utm_source: {
+                type: "string",
+                description: "Filter by source (e.g. 'google').",
+            },
+            utm_medium: {
+                type: "string",
+                description: "Filter by medium (e.g. 'cpc').",
+            },
+            utm_campaign: {
+                type: "string",
+                description: "Filter by campaign name.",
+            },
+            country: {
+                type: "string",
+                description: "Filter by country code (e.g. 'ES', 'US').",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        const params = trafficParams(args);
+        params.utm_source = args.utm_source;
+        params.utm_medium = args.utm_medium;
+        params.utm_campaign = args.utm_campaign;
+        params.country = args.country;
+        return client.requestPaginated("/stats/terms", params);
+    },
+};
+// --- Top N tools (non-paginated, client.request) ---
+function topNParams(args) {
+    return {
+        site_id: resolveSiteId(args),
+        period: args.period ?? "30d",
+        limit: String(args.limit ?? 10),
+    };
+}
+export const getTopSourcesTool = {
+    name: "get_top_sources",
+    description: "Get top traffic sources ranked by entrances. Returns a compact list of the top N sources (utm_source) without pagination — ideal for quick rankings and summaries.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            period: PERIOD_SCHEMA,
+            limit: LIMIT_SCHEMA,
+            utm_medium: {
+                type: "string",
+                description: "Filter by medium (e.g. 'cpc').",
+            },
+            country: {
+                type: "string",
+                description: "Filter by country code (e.g. 'ES', 'US').",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        const params = topNParams(args);
+        params.utm_medium = args.utm_medium;
+        params.country = args.country;
+        return client.request("/stats/sources/top", params);
+    },
+};
+export const getTopCampaignsTool = {
+    name: "get_top_campaigns",
+    description: "Get top campaigns ranked by entrances. Returns a compact list of the top N campaigns (utm_campaign) — ideal for quick rankings.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            period: PERIOD_SCHEMA,
+            limit: LIMIT_SCHEMA,
+            utm_source: {
+                type: "string",
+                description: "Filter by source (e.g. 'google').",
+            },
+            utm_medium: {
+                type: "string",
+                description: "Filter by medium (e.g. 'cpc').",
+            },
+            country: {
+                type: "string",
+                description: "Filter by country code (e.g. 'ES', 'US').",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        const params = topNParams(args);
+        params.utm_source = args.utm_source;
+        params.utm_medium = args.utm_medium;
+        params.country = args.country;
+        return client.request("/stats/campaigns/top", params);
+    },
+};
+export const getTopTermsTool = {
+    name: "get_top_terms",
+    description: "Get top UTM terms (keywords) ranked by entrances. Returns a compact list of the top N terms — ideal for quick keyword rankings.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID. Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            period: PERIOD_SCHEMA,
+            limit: LIMIT_SCHEMA,
+            utm_source: {
+                type: "string",
+                description: "Filter by source (e.g. 'google').",
+            },
+            utm_medium: {
+                type: "string",
+                description: "Filter by medium (e.g. 'cpc').",
+            },
+            utm_campaign: {
+                type: "string",
+                description: "Filter by campaign name.",
+            },
+            country: {
+                type: "string",
+                description: "Filter by country code (e.g. 'ES', 'US').",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        const params = topNParams(args);
+        params.utm_source = args.utm_source;
+        params.utm_medium = args.utm_medium;
+        params.utm_campaign = args.utm_campaign;
+        params.country = args.country;
+        return client.request("/stats/terms/top", params);
+    },
+};
+export const getTopReferrersTool = {
+    name: "get_top_referrers",
+    description: "Get top referrer domains ranked by entrances. Shows which external sites send 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,
+            limit: LIMIT_SCHEMA,
+            country: {
+                type: "string",
+                description: "Filter by country code (e.g. 'ES', 'US').",
+            },
+        },
+    },
+    handler: async (client, args) => {
+        const params = topNParams(args);
+        params.country = args.country;
+        return client.request("/stats/referrers/top", params);
+    },
+};
+//# sourceMappingURL=traffic.js.map

package/dist/tools/traffic.js.map

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

package/dist/tools/webhooks.d.ts

@@ -0,0 +1,5 @@
+import type { ToolDef } from "./index.js";
+export declare const listWebhooksTool: ToolDef;
+export declare const listWebhookDeliveriesTool: ToolDef;
+export declare const getWebhookStatsTool: ToolDef;
+//# sourceMappingURL=webhooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/tools/webhooks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAO,MAAM,gBAAgB,EAAE,OA+B9B,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,OAsCvC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,OA8BjC,CAAC"}

package/dist/tools/webhooks.js

@@ -0,0 +1,101 @@
+import { LIMIT_SCHEMA, resolveSiteId } from "./shared.js";
+export const listWebhooksTool = {
+    name: "list_webhooks",
+    description: "List webhook endpoints configured for a site. Shows endpoint URL, subscribed event types, and active status. Webhooks send real-time HTTP notifications when events occur.",
+    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 webhook endpoints (default: false).",
+            },
+            limit: LIMIT_SCHEMA,
+            offset: {
+                type: "number",
+                description: "Offset for pagination (default: 0).",
+                default: 0,
+            },
+        },
+    },
+    handler: async (client, args) => {
+        return client.requestDirect("/webhooks", {
+            account_id: resolveSiteId(args),
+            include_inactive: args.include_inactive != null ? String(args.include_inactive) : undefined,
+            limit: String(args.limit ?? 50),
+            offset: args.offset != null ? String(args.offset) : undefined,
+        });
+    },
+};
+export const listWebhookDeliveriesTool = {
+    name: "list_webhook_deliveries",
+    description: "List delivery attempts for a specific webhook endpoint. Shows HTTP status, response time, and success/failure for each delivery. Useful for debugging webhook integration issues.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID (account_id). Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            endpoint_id: {
+                type: "string",
+                description: "Webhook endpoint UUID.",
+            },
+            status: {
+                type: "string",
+                description: "Filter by delivery status.",
+                enum: ["pending", "success", "failed"],
+            },
+            limit: LIMIT_SCHEMA,
+            offset: {
+                type: "number",
+                description: "Offset for pagination (default: 0).",
+                default: 0,
+            },
+        },
+        required: ["endpoint_id"],
+    },
+    handler: async (client, args) => {
+        const endpointId = args.endpoint_id;
+        return client.requestDirect(`/webhooks/${encodeURIComponent(endpointId)}/deliveries`, {
+            account_id: resolveSiteId(args),
+            status: args.status,
+            limit: String(args.limit ?? 50),
+            offset: args.offset != null ? String(args.offset) : undefined,
+        });
+    },
+};
+export const getWebhookStatsTool = {
+    name: "get_webhook_stats",
+    description: "Get delivery statistics for a specific webhook endpoint: total deliveries, success rate, average response time, and failure breakdown. Useful for monitoring webhook reliability.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            site_id: {
+                type: "string",
+                description: "Site ID (account_id). Optional if SEALMETRICS_SITE_ID env var is set.",
+            },
+            endpoint_id: {
+                type: "string",
+                description: "Webhook endpoint UUID.",
+            },
+            hours: {
+                type: "number",
+                description: "Hours to look back for statistics (1-720, default: 24).",
+                default: 24,
+            },
+        },
+        required: ["endpoint_id"],
+    },
+    handler: async (client, args) => {
+        const endpointId = args.endpoint_id;
+        return client.requestDirect(`/webhooks/${encodeURIComponent(endpointId)}/stats`, {
+            account_id: resolveSiteId(args),
+            hours: String(args.hours ?? 24),
+        });
+    },
+};
+//# sourceMappingURL=webhooks.js.map

package/dist/tools/webhooks.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,118 @@
+/** API response envelope. */
+export interface APIResponse<T> {
+    success: boolean;
+    data: T;
+    meta?: Record<string, unknown>;
+    timestamp: string;
+}
+/** Paginated API response. */
+export interface PaginatedResponse<T> {
+    success: boolean;
+    data: T[];
+    total: number;
+    page: number;
+    page_size: number;
+    has_next: boolean;
+    has_prev: boolean;
+    comparison?: Record<string, unknown> | null;
+    totals?: Record<string, unknown> | null;
+    timestamp: string;
+}
+/** Site info returned by GET /sites. */
+export interface SiteInfo {
+    id: string;
+    name: string;
+    domains: string[];
+    timezone: string;
+    currency: string;
+    is_active: boolean;
+    created_at: string;
+}
+export interface SiteListResponse {
+    sites: SiteInfo[];
+    total: number;
+}
+/** Date range in overview response. */
+export interface DateRange {
+    start_date: string;
+    end_date: string;
+    days: number;
+}
+/** Traffic metrics. */
+export interface TrafficMetrics {
+    entrances: number;
+    engaged_entrances: number;
+    page_views: number;
+    microconversions: number;
+    conversions: number;
+    revenue: string;
+    bounce_rate: number;
+    pages_per_session: number;
+}
+/** Conversion metrics. */
+export interface ConversionMetrics {
+    conversions: number;
+    revenue: string;
+    microconversions: number;
+    conversion_rate: number;
+    average_order_value: string;
+}
+/** Time series point. */
+export interface TimeSeriesPoint {
+    date: string;
+    hour?: number | null;
+    day_of_week?: number | null;
+    value: number;
+}
+/** Time series data. */
+export interface TimeSeries {
+    metric: string;
+    points: TimeSeriesPoint[];
+    total: number;
+    average: number;
+}
+/** Overview response. */
+export interface StatsOverview {
+    date_range: DateRange;
+    traffic: TrafficMetrics;
+    conversions: ConversionMetrics;
+    traffic_change?: TrafficMetrics | null;
+    conversions_change?: ConversionMetrics | null;
+    entrances_series?: TimeSeries;
+    engaged_entrances_series?: TimeSeries;
+    page_views_series?: TimeSeries;
+    conversions_series?: TimeSeries;
+    microconversions_series?: TimeSeries;
+    revenue_series?: TimeSeries;
+}
+/** Devices breakdown response. */
+export interface DevicesBreakdown {
+    by_device: DeviceMetric[];
+    by_browser: DeviceMetric[];
+    by_os: DeviceMetric[];
+}
+export interface DeviceMetric {
+    name: string;
+    entrances: number;
+    engaged_entrances: number;
+    page_views: number;
+    conversions: number;
+    revenue: string;
+    bounce_rate: number;
+}
+/** Funnel response. */
+export interface FunnelStep {
+    name: string;
+    count: number;
+    rate: number;
+    dropoff: number;
+}
+export interface FunnelReport {
+    steps: FunnelStep[];
+    total_entrances: number;
+    overall_conversion_rate: number;
+}
+/** Valid period values. */
+export declare const VALID_PERIODS: readonly ["today", "yesterday", "7d", "30d", "90d", "12m", "this_week", "wtd", "last_week", "this_month", "mtd", "last_month", "this_quarter", "qtd", "last_quarter", "this_year", "ytd", "last_year"];
+export type Period = (typeof VALID_PERIODS)[number];
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,22 @@
+/** Valid period values. */
+export const VALID_PERIODS = [
+    "today",
+    "yesterday",
+    "7d",
+    "30d",
+    "90d",
+    "12m",
+    "this_week",
+    "wtd",
+    "last_week",
+    "this_month",
+    "mtd",
+    "last_month",
+    "this_quarter",
+    "qtd",
+    "last_quarter",
+    "this_year",
+    "ytd",
+    "last_year",
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAgIA,2BAA2B;AAC3B,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO;IACP,WAAW;IACX,IAAI;IACJ,KAAK;IACL,KAAK;IACL,KAAK;IACL,WAAW;IACX,KAAK;IACL,WAAW;IACX,YAAY;IACZ,KAAK;IACL,YAAY;IACZ,cAAc;IACd,KAAK;IACL,cAAc;IACd,WAAW;IACX,KAAK;IACL,WAAW;CACH,CAAC"}

package/package.json

@@ -1,43 +1,51 @@
 {
   "name": "@sealmetrics/mcp",
-  "version": "0.1.0",
-  "description": "SealMetrics MCP Server - Access your analytics data from Claude and other AI assistants",
-  "main": "dist/index.js",
+  "version": "1.2.0",
+  "description": "SealMetrics analytics MCP server for Claude Code and Claude Desktop",
+  "author": "SealMetrics <dev@sealmetrics.com> (https://sealmetrics.com)",
+  "homepage": "https://github.com/adinton/sealmetrics2/tree/main/mcp-server#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/adinton/sealmetrics2.git",
+    "directory": "mcp-server"
+  },
+  "bugs": {
+    "url": "https://github.com/adinton/sealmetrics2/issues"
+  },
   "type": "module",
   "bin": {
-    "sealmetrics-mcp": "dist/index.js"
+    "sealmetrics-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
   },
   "scripts": {
     "build": "tsc",
-    "dev": "tsc --watch",
-    "start": "node dist/index.js",
-    "prepublishOnly": "npm run build"
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build && chmod +x dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.25 || ^4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "msw": "^2.7.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
   },
   "keywords": [
     "mcp",
     "sealmetrics",
     "analytics",
     "claude",
-    "ai",
     "model-context-protocol"
   ],
-  "author": "SealMetrics",
-  "license": "MIT",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "typescript": "^5.0.0"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "files": [
-    "dist"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/sealmetrics/mcp-server"
-  }
+  "license": "MIT"
 }