@sealmetrics/mcp 0.1.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (103) hide show
  1. package/README.md +173 -0
  2. package/dist/client.d.ts +68 -0
  3. package/dist/client.d.ts.map +1 -0
  4. package/dist/client.js +225 -0
  5. package/dist/client.js.map +1 -0
  6. package/dist/embedded.d.ts +29 -0
  7. package/dist/embedded.d.ts.map +1 -0
  8. package/dist/embedded.js +37 -0
  9. package/dist/embedded.js.map +1 -0
  10. package/dist/errors.d.ts +10 -0
  11. package/dist/errors.d.ts.map +1 -0
  12. package/dist/errors.js +55 -0
  13. package/dist/errors.js.map +1 -0
  14. package/dist/index.d.ts +1 -6
  15. package/dist/index.d.ts.map +1 -0
  16. package/dist/index.js +3809 -780
  17. package/dist/index.js.map +1 -0
  18. package/dist/resources/tracking-guide.d.ts +13 -0
  19. package/dist/resources/tracking-guide.d.ts.map +1 -0
  20. package/dist/resources/tracking-guide.js +479 -0
  21. package/dist/resources/tracking-guide.js.map +1 -0
  22. package/dist/sealmetrics.mcpb +0 -0
  23. package/dist/server.d.ts +38 -0
  24. package/dist/server.d.ts.map +1 -0
  25. package/dist/server.js +132 -0
  26. package/dist/server.js.map +1 -0
  27. package/dist/tools/alerts.d.ts +5 -0
  28. package/dist/tools/alerts.d.ts.map +1 -0
  29. package/dist/tools/alerts.js +80 -0
  30. package/dist/tools/alerts.js.map +1 -0
  31. package/dist/tools/audience.d.ts +7 -0
  32. package/dist/tools/audience.d.ts.map +1 -0
  33. package/dist/tools/audience.js +146 -0
  34. package/dist/tools/audience.js.map +1 -0
  35. package/dist/tools/bots.d.ts +4 -0
  36. package/dist/tools/bots.d.ts.map +1 -0
  37. package/dist/tools/bots.js +52 -0
  38. package/dist/tools/bots.js.map +1 -0
  39. package/dist/tools/channels.d.ts +5 -0
  40. package/dist/tools/channels.d.ts.map +1 -0
  41. package/dist/tools/channels.js +88 -0
  42. package/dist/tools/channels.js.map +1 -0
  43. package/dist/tools/content.d.ts +3 -0
  44. package/dist/tools/content.d.ts.map +1 -0
  45. package/dist/tools/content.js +47 -0
  46. package/dist/tools/content.js.map +1 -0
  47. package/dist/tools/conversions.d.ts +9 -0
  48. package/dist/tools/conversions.d.ts.map +1 -0
  49. package/dist/tools/conversions.js +427 -0
  50. package/dist/tools/conversions.js.map +1 -0
  51. package/dist/tools/funnel.d.ts +3 -0
  52. package/dist/tools/funnel.d.ts.map +1 -0
  53. package/dist/tools/funnel.js +27 -0
  54. package/dist/tools/funnel.js.map +1 -0
  55. package/dist/tools/index.d.ts +16 -0
  56. package/dist/tools/index.d.ts.map +1 -0
  57. package/dist/tools/index.js +83 -0
  58. package/dist/tools/index.js.map +1 -0
  59. package/dist/tools/overview.d.ts +3 -0
  60. package/dist/tools/overview.d.ts.map +1 -0
  61. package/dist/tools/overview.js +26 -0
  62. package/dist/tools/overview.js.map +1 -0
  63. package/dist/tools/pages.d.ts +7 -0
  64. package/dist/tools/pages.d.ts.map +1 -0
  65. package/dist/tools/pages.js +307 -0
  66. package/dist/tools/pages.js.map +1 -0
  67. package/dist/tools/properties.d.ts +5 -0
  68. package/dist/tools/properties.d.ts.map +1 -0
  69. package/dist/tools/properties.js +107 -0
  70. package/dist/tools/properties.js.map +1 -0
  71. package/dist/tools/segments.d.ts +4 -0
  72. package/dist/tools/segments.d.ts.map +1 -0
  73. package/dist/tools/segments.js +49 -0
  74. package/dist/tools/segments.js.map +1 -0
  75. package/dist/tools/setup.d.ts +49 -0
  76. package/dist/tools/setup.d.ts.map +1 -0
  77. package/dist/tools/setup.js +347 -0
  78. package/dist/tools/setup.js.map +1 -0
  79. package/dist/tools/shared.d.ts +33 -0
  80. package/dist/tools/shared.d.ts.map +1 -0
  81. package/dist/tools/shared.js +40 -0
  82. package/dist/tools/shared.js.map +1 -0
  83. package/dist/tools/sites.d.ts +4 -0
  84. package/dist/tools/sites.d.ts.map +1 -0
  85. package/dist/tools/sites.js +36 -0
  86. package/dist/tools/sites.js.map +1 -0
  87. package/dist/tools/tracking.d.ts +3 -0
  88. package/dist/tools/tracking.d.ts.map +1 -0
  89. package/dist/tools/tracking.js +220 -0
  90. package/dist/tools/tracking.js.map +1 -0
  91. package/dist/tools/traffic.d.ts +10 -0
  92. package/dist/tools/traffic.d.ts.map +1 -0
  93. package/dist/tools/traffic.js +273 -0
  94. package/dist/tools/traffic.js.map +1 -0
  95. package/dist/tools/webhooks.d.ts +5 -0
  96. package/dist/tools/webhooks.d.ts.map +1 -0
  97. package/dist/tools/webhooks.js +101 -0
  98. package/dist/tools/webhooks.js.map +1 -0
  99. package/dist/types.d.ts +118 -0
  100. package/dist/types.d.ts.map +1 -0
  101. package/dist/types.js +22 -0
  102. package/dist/types.js.map +1 -0
  103. package/package.json +44 -27
@@ -0,0 +1,118 @@
1
+ /** API response envelope. */
2
+ export interface APIResponse<T> {
3
+ success: boolean;
4
+ data: T;
5
+ meta?: Record<string, unknown>;
6
+ timestamp: string;
7
+ }
8
+ /** Paginated API response. */
9
+ export interface PaginatedResponse<T> {
10
+ success: boolean;
11
+ data: T[];
12
+ total: number;
13
+ page: number;
14
+ page_size: number;
15
+ has_next: boolean;
16
+ has_prev: boolean;
17
+ comparison?: Record<string, unknown> | null;
18
+ totals?: Record<string, unknown> | null;
19
+ timestamp: string;
20
+ }
21
+ /** Site info returned by GET /sites. */
22
+ export interface SiteInfo {
23
+ id: string;
24
+ name: string;
25
+ domains: string[];
26
+ timezone: string;
27
+ currency: string;
28
+ is_active: boolean;
29
+ created_at: string;
30
+ }
31
+ export interface SiteListResponse {
32
+ sites: SiteInfo[];
33
+ total: number;
34
+ }
35
+ /** Date range in overview response. */
36
+ export interface DateRange {
37
+ start_date: string;
38
+ end_date: string;
39
+ days: number;
40
+ }
41
+ /** Traffic metrics. */
42
+ export interface TrafficMetrics {
43
+ entrances: number;
44
+ engaged_entrances: number;
45
+ page_views: number;
46
+ microconversions: number;
47
+ conversions: number;
48
+ revenue: string;
49
+ bounce_rate: number;
50
+ pages_per_session: number;
51
+ }
52
+ /** Conversion metrics. */
53
+ export interface ConversionMetrics {
54
+ conversions: number;
55
+ revenue: string;
56
+ microconversions: number;
57
+ conversion_rate: number;
58
+ average_order_value: string;
59
+ }
60
+ /** Time series point. */
61
+ export interface TimeSeriesPoint {
62
+ date: string;
63
+ hour?: number | null;
64
+ day_of_week?: number | null;
65
+ value: number;
66
+ }
67
+ /** Time series data. */
68
+ export interface TimeSeries {
69
+ metric: string;
70
+ points: TimeSeriesPoint[];
71
+ total: number;
72
+ average: number;
73
+ }
74
+ /** Overview response. */
75
+ export interface StatsOverview {
76
+ date_range: DateRange;
77
+ traffic: TrafficMetrics;
78
+ conversions: ConversionMetrics;
79
+ traffic_change?: TrafficMetrics | null;
80
+ conversions_change?: ConversionMetrics | null;
81
+ entrances_series?: TimeSeries;
82
+ engaged_entrances_series?: TimeSeries;
83
+ page_views_series?: TimeSeries;
84
+ conversions_series?: TimeSeries;
85
+ microconversions_series?: TimeSeries;
86
+ revenue_series?: TimeSeries;
87
+ }
88
+ /** Devices breakdown response. */
89
+ export interface DevicesBreakdown {
90
+ by_device: DeviceMetric[];
91
+ by_browser: DeviceMetric[];
92
+ by_os: DeviceMetric[];
93
+ }
94
+ export interface DeviceMetric {
95
+ name: string;
96
+ entrances: number;
97
+ engaged_entrances: number;
98
+ page_views: number;
99
+ conversions: number;
100
+ revenue: string;
101
+ bounce_rate: number;
102
+ }
103
+ /** Funnel response. */
104
+ export interface FunnelStep {
105
+ name: string;
106
+ count: number;
107
+ rate: number;
108
+ dropoff: number;
109
+ }
110
+ export interface FunnelReport {
111
+ steps: FunnelStep[];
112
+ total_entrances: number;
113
+ overall_conversion_rate: number;
114
+ }
115
+ /** Valid period values. */
116
+ 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"];
117
+ export type Period = (typeof VALID_PERIODS)[number];
118
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/dist/types.js ADDED
@@ -0,0 +1,22 @@
1
+ /** Valid period values. */
2
+ export const VALID_PERIODS = [
3
+ "today",
4
+ "yesterday",
5
+ "7d",
6
+ "30d",
7
+ "90d",
8
+ "12m",
9
+ "this_week",
10
+ "wtd",
11
+ "last_week",
12
+ "this_month",
13
+ "mtd",
14
+ "last_month",
15
+ "this_quarter",
16
+ "qtd",
17
+ "last_quarter",
18
+ "this_year",
19
+ "ytd",
20
+ "last_year",
21
+ ];
22
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
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 CHANGED
@@ -1,43 +1,60 @@
1
1
  {
2
2
  "name": "@sealmetrics/mcp",
3
- "version": "0.1.0",
4
- "description": "SealMetrics MCP Server - Access your analytics data from Claude and other AI assistants",
5
- "main": "dist/index.js",
3
+ "version": "1.3.0",
4
+ "description": "SealMetrics analytics MCP server for Claude Code and Claude Desktop",
5
+ "author": "SealMetrics <dev@sealmetrics.com> (https://sealmetrics.com)",
6
+ "homepage": "https://github.com/adinton/sealmetrics2/tree/main/mcp-server#readme",
7
+ "repository": {
8
+ "type": "git",
9
+ "url": "https://github.com/adinton/sealmetrics2.git",
10
+ "directory": "mcp-server"
11
+ },
12
+ "bugs": {
13
+ "url": "https://github.com/adinton/sealmetrics2/issues"
14
+ },
6
15
  "type": "module",
7
16
  "bin": {
8
- "sealmetrics-mcp": "dist/index.js"
17
+ "sealmetrics-mcp": "./dist/index.js"
18
+ },
19
+ "files": [
20
+ "dist"
21
+ ],
22
+ "engines": {
23
+ "node": ">=18"
9
24
  },
10
25
  "scripts": {
11
26
  "build": "tsc",
12
- "dev": "tsc --watch",
13
- "start": "node dist/index.js",
14
- "prepublishOnly": "npm run build"
27
+ "dev": "tsx src/index.ts",
28
+ "test": "vitest run",
29
+ "test:watch": "vitest",
30
+ "typecheck": "tsc --noEmit",
31
+ "bundle": "node scripts/bundle.mjs",
32
+ "pack-mcpb": "node scripts/pack-mcpb.mjs",
33
+ "prepare": "npm run build && npm run bundle && chmod +x dist/index.js"
34
+ },
35
+ "dependencies": {
36
+ "@modelcontextprotocol/sdk": "^1.12.1",
37
+ "zod": "^3.25 || ^4.0"
38
+ },
39
+ "devDependencies": {
40
+ "@anthropic-ai/mcpb": "^1.0.0",
41
+ "@sealmetrics/setup-core": "file:../setup-core",
42
+ "@types/node": "^22.0.0",
43
+ "esbuild": "^0.24.0",
44
+ "msw": "^2.7.0",
45
+ "tsx": "^4.0.0",
46
+ "typescript": "^5.7.0",
47
+ "vitest": "4.1.5"
48
+ },
49
+ "overrides": {
50
+ "vite": "^7.3.2"
15
51
  },
16
52
  "keywords": [
17
53
  "mcp",
18
54
  "sealmetrics",
19
55
  "analytics",
20
56
  "claude",
21
- "ai",
22
57
  "model-context-protocol"
23
58
  ],
24
- "author": "SealMetrics",
25
- "license": "MIT",
26
- "dependencies": {
27
- "@modelcontextprotocol/sdk": "^1.0.0"
28
- },
29
- "devDependencies": {
30
- "@types/node": "^20.0.0",
31
- "typescript": "^5.0.0"
32
- },
33
- "engines": {
34
- "node": ">=18.0.0"
35
- },
36
- "files": [
37
- "dist"
38
- ],
39
- "repository": {
40
- "type": "git",
41
- "url": "https://github.com/sealmetrics/mcp-server"
42
- }
59
+ "license": "MIT"
43
60
  }