@kelpi/mcp 0.1.0

package/dist/tools/templates/index.js

@@ -0,0 +1,68 @@
+import { createTemplateInputSchema, listTemplatesInputSchema } from './schemas.js';
+import { createTemplateHandler } from './create.js';
+import { listTemplatesHandler } from './list.js';
+/**
+ * kelpi_create_template tool definition and handler
+ *
+ * Creates a new email template with variables support.
+ */
+export const kelpiCreateTemplate = {
+    definition: {
+        name: 'kelpi_create_template',
+        description: `Create a new email template for use in flows.
+
+Templates support:
+- Handlebars-style variables: {{variable_name}}
+- HTML content for rich email formatting
+- Variable definitions with optional default values
+
+Required fields:
+- slug: Unique identifier (lowercase, hyphens only, e.g., "welcome-email")
+- name: Display name for the template
+- subject: Email subject line (can include variables)
+- body_html: HTML content of the email
+
+Example:
+{
+  "slug": "welcome-email",
+  "name": "Welcome Email",
+  "subject": "Welcome to {{company_name}}!",
+  "body_html": "<h1>Welcome, {{first_name}}!</h1><p>Thanks for joining.</p>",
+  "variables": [
+    { "name": "first_name", "default_value": "there" },
+    { "name": "company_name" }
+  ]
+}`,
+        inputSchema: createTemplateInputSchema,
+    },
+    handler: createTemplateHandler,
+};
+/**
+ * kelpi_list_templates tool definition and handler
+ *
+ * Lists all templates in the workspace.
+ */
+export const kelpiListTemplates = {
+    definition: {
+        name: 'kelpi_list_templates',
+        description: `List all email templates in the workspace.
+
+Returns a paginated list of templates with:
+- ID and slug
+- Name and subject
+- Creation timestamp
+- Variable definitions
+
+Use pagination parameters for large template libraries:
+- limit: Maximum number of templates to return (1-100)
+- offset: Number of templates to skip`,
+        inputSchema: listTemplatesInputSchema,
+    },
+    handler: listTemplatesHandler,
+};
+// Re-export schemas
+export * from './schemas.js';
+// Re-export handler factories for testing
+export { createCreateTemplateHandler } from './create.js';
+export { createListTemplatesHandler } from './list.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/templates/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAoB;IAClD,UAAU,EAAE;QACV,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;EAuBf;QACE,WAAW,EAAE,yBAAyB;KACvC;IACD,OAAO,EAAE,qBAAqB;CAC/B,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAoB;IACjD,UAAU,EAAE;QACV,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE;;;;;;;;;;sCAUqB;QAClC,WAAW,EAAE,wBAAwB;KACtC;IACD,OAAO,EAAE,oBAAoB;CAC9B,CAAC;AAEF,oBAAoB;AACpB,cAAc,cAAc,CAAC;AAE7B,0CAA0C;AAC1C,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC"}

package/dist/tools/templates/list.d.ts

@@ -0,0 +1,11 @@
+import type { ToolHandler } from '../../lib/tool-registry.js';
+/**
+ * Creates a list templates handler.
+ * This factory function allows for dependency injection in tests.
+ */
+export declare function createListTemplatesHandler(): ToolHandler;
+/**
+ * Default list templates handler
+ */
+export declare const listTemplatesHandler: ToolHandler;
+//# sourceMappingURL=list.d.ts.map

package/dist/tools/templates/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/tools/templates/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,4BAA4B,CAAC;AAI1E;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,WAAW,CAwBxD;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,aAA+B,CAAC"}

package/dist/tools/templates/list.js

@@ -0,0 +1,31 @@
+import { withAuth, successResponse, handleApiError } from '../../lib/tool-helpers.js';
+/**
+ * Creates a list templates handler.
+ * This factory function allows for dependency injection in tests.
+ */
+export function createListTemplatesHandler() {
+    return async (input) => {
+        return withAuth('listing templates', async ({ client }) => {
+            // Build query parameters
+            const queryParams = {};
+            if (input.limit !== undefined && typeof input.limit === 'number') {
+                queryParams.limit = String(input.limit);
+            }
+            if (input.offset !== undefined && typeof input.offset === 'number') {
+                queryParams.offset = String(input.offset);
+            }
+            try {
+                const response = await client.get('/api/v1/templates', Object.keys(queryParams).length > 0 ? queryParams : undefined);
+                return successResponse(response.data);
+            }
+            catch (err) {
+                return handleApiError(err, 'list templates');
+            }
+        });
+    };
+}
+/**
+ * Default list templates handler
+ */
+export const listTemplatesHandler = createListTemplatesHandler();
+//# sourceMappingURL=list.js.map

package/dist/tools/templates/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/tools/templates/list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGtF;;;GAGG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO,KAAK,EAAE,KAA8B,EAAuB,EAAE;QACnE,OAAO,QAAQ,CAAC,mBAAmB,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;YACxD,yBAAyB;YACzB,MAAM,WAAW,GAA2B,EAAE,CAAC;YAE/C,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACjE,WAAW,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1C,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACnE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC5C,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAC/B,mBAAmB,EACnB,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAC9D,CAAC;gBACF,OAAO,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACxC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,cAAc,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,0BAA0B,EAAE,CAAC"}

package/dist/tools/templates/schemas.d.ts

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+/**
+ * Schema for kelpi_create_template input
+ */
+export declare const createTemplateInputSchema: z.ZodObject<{
+    slug: z.ZodString;
+    name: z.ZodString;
+    subject: z.ZodString;
+    body_html: z.ZodString;
+    variables: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        default_value: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        default_value?: string | undefined;
+        required?: boolean | undefined;
+    }, {
+        name: string;
+        default_value?: string | undefined;
+        required?: boolean | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    slug: string;
+    subject: string;
+    body_html: string;
+    variables?: {
+        name: string;
+        default_value?: string | undefined;
+        required?: boolean | undefined;
+    }[] | undefined;
+}, {
+    name: string;
+    slug: string;
+    subject: string;
+    body_html: string;
+    variables?: {
+        name: string;
+        default_value?: string | undefined;
+        required?: boolean | undefined;
+    }[] | undefined;
+}>;
+/**
+ * Schema for kelpi_list_templates input
+ */
+export declare const listTemplatesInputSchema: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit?: number | undefined;
+    offset?: number | undefined;
+}, {
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+/**
+ * Template response from API
+ */
+export interface TemplateResponse {
+    id: string;
+    slug: string;
+    name: string;
+    subject: string;
+    body_html: string;
+    variables?: Array<{
+        name: string;
+        default_value?: string;
+        required?: boolean;
+    }>;
+    created_at: string;
+}
+/**
+ * List templates response from API
+ */
+export interface ListTemplatesResponse {
+    data: TemplateResponse[];
+    pagination: {
+        total: number;
+        limit: number;
+        offset: number;
+        has_more: boolean;
+    };
+}
+/**
+ * Type exports
+ */
+export type CreateTemplateInput = z.infer<typeof createTemplateInputSchema>;
+export type ListTemplatesInput = z.infer<typeof listTemplatesInputSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/tools/templates/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/templates/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASpC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;EAGnC,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,gBAAgB,EAAE,CAAC;IACzB,UAAU,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/tools/templates/schemas.js

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+/**
+ * Slug validation regex
+ * Must be lowercase letters, numbers, and hyphens only
+ * Cannot start or end with hyphen
+ * Cannot have consecutive hyphens
+ */
+const SLUG_REGEX = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+/**
+ * Schema for template variable
+ */
+const templateVariableSchema = z.object({
+    name: z.string().min(1),
+    default_value: z.string().optional(),
+    required: z.boolean().optional(),
+});
+/**
+ * Schema for kelpi_create_template input
+ */
+export const createTemplateInputSchema = z.object({
+    slug: z
+        .string()
+        .min(1, 'Slug is required')
+        .regex(SLUG_REGEX, 'Slug must be lowercase with hyphens only (e.g., "welcome-email")'),
+    name: z.string().min(1, 'Name is required'),
+    subject: z.string().min(1, 'Subject is required'),
+    body_html: z.string().min(1, 'Body HTML is required'),
+    variables: z.array(templateVariableSchema).optional(),
+});
+/**
+ * Schema for kelpi_list_templates input
+ */
+export const listTemplatesInputSchema = z.object({
+    limit: z.number().min(1).max(100).optional(),
+    offset: z.number().min(0).optional(),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/tools/templates/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/tools/templates/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,MAAM,UAAU,GAAG,0BAA0B,CAAC;AAE9C;;GAEG;AACH,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,kBAAkB,CAAC;SAC1B,KAAK,CAAC,UAAU,EAAE,kEAAkE,CAAC;IACxF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,qBAAqB,CAAC;IACjD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,uBAAuB,CAAC;IACrD,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * MCP Configuration stored at ~/.kelpi/config.json
+ */
+export interface KelpiConfig {
+    api_key?: string;
+    api_url?: string;
+    workspace_id?: string;
+}
+/**
+ * Authentication state for the MCP server
+ */
+export interface AuthState {
+    authenticated: boolean;
+    workspace_id?: string;
+    workspace_name?: string;
+    key_type?: 'public' | 'secret';
+}
+/**
+ * Options for saving configuration
+ */
+export interface SaveConfigOptions {
+    merge?: boolean;
+}
+/**
+ * API Client options
+ */
+export interface ApiClientOptions {
+    apiKey: string;
+    apiUrl?: string;
+    timeout?: number;
+    maxRetries?: number;
+    retryDelay?: number;
+}
+/**
+ * API response structure
+ */
+export interface ApiResponse<T = unknown> {
+    data: T;
+    status: number;
+}
+/**
+ * Validation error from API
+ */
+export interface ValidationError {
+    field: string;
+    message: string;
+}
+/**
+ * Config validation result
+ */
+export interface ConfigValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+//# 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":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@kelpi/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Kelpi customer engagement automation. Enables AI assistants to manage email templates, automation flows, contacts, and events.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "kelpi-mcp": "./bin/kelpi-mcp"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:run": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:unit": "vitest run --exclude 'src/__tests__/integration*/**'",
+    "test:integration": "vitest run src/__tests__/integration --pool=forks",
+    "test:integration:api": "vitest run --config vitest.config.integration-api.ts --pool=forks",
+    "test:integration:api:watch": "vitest --config vitest.config.integration-api.ts --pool=forks",
+    "test:all": "pnpm test:run && pnpm test:integration:api",
+    "lint": "eslint src --ext .ts",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "pnpm run build && pnpm run test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.22.0",
+    "zod-to-json-schema": "^3.22.0"
+  },
+  "devDependencies": {
+    "@supabase/supabase-js": "^2.89.0",
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^3.0.0",
+    "dotenv": "^17.2.3",
+    "memfs": "^4.17.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md"
+  ],
+  "keywords": [
+    "kelpi",
+    "mcp",
+    "model-context-protocol",
+    "customer-engagement",
+    "email-automation",
+    "marketing-automation",
+    "claude",
+    "ai-assistant",
+    "sdk",
+    "api"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kelpi-ai/kelpi.git",
+    "directory": "packages/mcp"
+  },
+  "homepage": "https://github.com/kelpi-ai/kelpi/tree/main/packages/mcp#readme",
+  "bugs": {
+    "url": "https://github.com/kelpi-ai/kelpi/issues"
+  },
+  "author": "Kelpi AI <support@kelpi.io>",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}