@iterable/mcp 1.0.0

package/dist/prompts.js

@@ -0,0 +1,66 @@
+/**
+ * Auto-generated MCP prompts from existing tools
+ * Creates slash commands without code duplication
+ */
+/**
+ * Convert a tool's JSON Schema to MCP prompt arguments
+ */
+function toolSchemaToPromptArguments(schema) {
+    if (!schema?.properties)
+        return [];
+    const required = schema.required || [];
+    return Object.entries(schema.properties).map(([name, prop]) => ({
+        name,
+        description: prop.description || `${name} parameter`,
+        required: required.includes(name),
+    }));
+}
+/**
+ * Convert tool name to user-friendly prompt name
+ * get_user -> get-user, export_data -> export-data
+ */
+function toolNameToPromptName(toolName) {
+    return toolName.replace(/_/g, "-");
+}
+/**
+ * Generate MCP prompts from filtered tools
+ * Creates prompts for all provided tools (assumes they're already filtered appropriately)
+ */
+export function generatePrompts(tools) {
+    return tools.map((tool) => ({
+        name: toolNameToPromptName(tool.name),
+        description: tool.description,
+        arguments: toolSchemaToPromptArguments(tool.inputSchema),
+    }));
+}
+/**
+ * Generate prompt message that calls the corresponding tool
+ */
+export function generatePromptMessage(promptName, args = {}) {
+    // Convert prompt name back to tool name
+    const toolName = promptName.replace(/-/g, "_");
+    // Generate a natural language instruction to use the tool
+    const argsList = Object.entries(args)
+        .filter(([_, value]) => value !== undefined && value !== "")
+        .map(([key, value]) => {
+        if (typeof value === "string") {
+            return `"${key}": "${value}"`;
+        }
+        return `"${key}": ${JSON.stringify(value)}`;
+    });
+    const toolCall = argsList.length > 0
+        ? `${toolName} tool with parameters: { ${argsList.join(", ")} }`
+        : `${toolName} tool`;
+    return {
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Please use the ${toolCall} to complete this request.`,
+                },
+            },
+        ],
+    };
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;GAEG;AACH,SAAS,2BAA2B,CAClC,MAAW;IAEX,IAAI,CAAC,MAAM,EAAE,UAAU;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;IACvC,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAC1C,CAAC,CAAC,IAAI,EAAE,IAAI,CAAgB,EAAE,EAAE,CAAC,CAAC;QAChC,IAAI;QACJ,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,GAAG,IAAI,YAAY;QACpD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;KAClC,CAAC,CACH,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,QAAgB;IAC5C,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,IAAI,EAAE,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC;QACrC,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,SAAS,EAAE,2BAA2B,CAAC,IAAI,CAAC,WAAW,CAAC;KACzD,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAAkB,EAClB,OAAgC,EAAE;IAElC,wCAAwC;IACxC,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAE/C,0DAA0D;IAC1D,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;SAClC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,CAAC;SAC3D,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACpB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,IAAI,GAAG,OAAO,KAAK,GAAG,CAAC;QAChC,CAAC;QACD,OAAO,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEL,MAAM,QAAQ,GACZ,QAAQ,CAAC,MAAM,GAAG,CAAC;QACjB,CAAC,CAAC,GAAG,QAAQ,4BAA4B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QAChE,CAAC,CAAC,GAAG,QAAQ,OAAO,CAAC;IAEzB,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,kBAAkB,QAAQ,4BAA4B;iBAC7D;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/schema-utils.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Utilities for converting Zod schemas to JSON Schema format
+ * This eliminates the need to manually duplicate schema definitions
+ */
+import { zodToJsonSchema } from "@alcyone-labs/zod-to-json-schema";
+export { zodToJsonSchema };
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+/**
+ * Tool configuration for MCP tool creation
+ */
+interface ToolConfig<TSchema extends z.ZodType> {
+    name: string;
+    description: string;
+    schema: TSchema;
+    execute: (params: z.infer<TSchema>) => Promise<any>;
+}
+/**
+ * Create an MCP tool with automatic error handling and response formatting
+ */
+export declare function createTool<TSchema extends z.ZodType>(config: ToolConfig<TSchema>): Tool;
+//# sourceMappingURL=schema-utils.d.ts.map

package/dist/schema-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-utils.d.ts","sourceRoot":"","sources":["../src/schema-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,eAAe,EAChB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EAAE,eAAe,EAAE,CAAC;AAQ3B,OAAO,EAAuB,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,UAAU,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,EAClD,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,GAC1B,IAAI,CAoEN"}

package/dist/schema-utils.js

@@ -0,0 +1,65 @@
+/**
+ * Utilities for converting Zod schemas to JSON Schema format
+ * This eliminates the need to manually duplicate schema definitions
+ */
+import { zodToJsonSchema, } from "@alcyone-labs/zod-to-json-schema";
+// Re-export for testing
+export { zodToJsonSchema };
+import { IterableApiError, IterableNetworkError, IterableRawError, IterableResponseValidationError, } from "@iterable/api";
+import { ErrorCode, McpError } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+/**
+ * Create an MCP tool with automatic error handling and response formatting
+ */
+export function createTool(config) {
+    const handler = async (args) => {
+        try {
+            // Validate input with schema
+            const params = config.schema.parse(args);
+            // Execute the tool logic
+            const result = await config.execute(params);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                throw new McpError(ErrorCode.InvalidParams, `Validation error: ${error.issues.map((issue) => `${issue.path.join(".")}: ${issue.message}`).join(", ")}`);
+            }
+            if (error instanceof McpError) {
+                throw error;
+            }
+            // Handle Iterable-specific errors - return structured data when possible
+            if (error instanceof IterableResponseValidationError ||
+                error instanceof IterableApiError ||
+                error instanceof IterableRawError) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(error, null, 2),
+                        },
+                    ],
+                };
+            }
+            // Network errors don't have useful response data, so throw
+            if (error instanceof IterableNetworkError) {
+                throw new McpError(ErrorCode.InternalError, `Iterable network error: ${error.message}`);
+            }
+            const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+            throw new McpError(ErrorCode.InternalError, `Tool execution failed: ${errorMessage}`);
+        }
+    };
+    return {
+        name: config.name,
+        description: config.description,
+        inputSchema: zodToJsonSchema(config.schema),
+        handler,
+    };
+}
+//# sourceMappingURL=schema-utils.js.map

package/dist/schema-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-utils.js","sourceRoot":"","sources":["../src/schema-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,eAAe,GAChB,MAAM,kCAAkC,CAAC;AAE1C,wBAAwB;AACxB,OAAO,EAAE,eAAe,EAAE,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,+BAA+B,GAChC,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAQ,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,MAA2B;IAE3B,MAAM,OAAO,GAAG,KAAK,EAAE,IAAa,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,6BAA6B;YAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAEzC,yBAAyB;YACzB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAE5C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtC;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAChC,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,aAAa,EACvB,qBAAqB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3G,CAAC;YACJ,CAAC;YAED,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,yEAAyE;YACzE,IACE,KAAK,YAAY,+BAA+B;gBAChD,KAAK,YAAY,gBAAgB;gBACjC,KAAK,YAAY,gBAAgB,EACjC,CAAC;gBACD,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;yBACrC;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,2DAA2D;YAC3D,IAAI,KAAK,YAAY,oBAAoB,EAAE,CAAC;gBAC1C,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,aAAa,EACvB,2BAA4B,KAAa,CAAC,OAAO,EAAE,CACpD,CAAC;YACJ,CAAC;YAED,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC;YACpE,MAAM,IAAI,QAAQ,CAChB,SAAS,CAAC,aAAa,EACvB,0BAA0B,YAAY,EAAE,CACzC,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,WAAW,EAAE,eAAe,CAAC,MAAM,CAAC,MAAM,CAA0B;QACpE,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,13 @@
+export declare class IterableMcpServer {
+    private server;
+    private iterableClient;
+    private tools;
+    private prompts;
+    private globalSessionId;
+    private sessionContext;
+    constructor();
+    private setupHandlers;
+    private setupHttpInterceptors;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAkDA,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,OAAO,CAAY;IAG3B,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,cAAc,CAA2C;;IAkCjE,OAAO,CAAC,aAAa;IAkDrB,OAAO,CAAC,qBAAqB;IA6DvB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA+B3B"}

package/dist/server.js

@@ -0,0 +1,172 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { IterableClient } from "@iterable/api";
+import { logger } from "@iterable/api";
+import { DEFAULT_USER_AGENT } from "@iterable/api";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ErrorCode, GetPromptRequestSchema, ListPromptsRequestSchema, ListToolsRequestSchema, McpError, } from "@modelcontextprotocol/sdk/types.js";
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { detectClientName } from "./client-detection.js";
+import { loadMcpServerConfig } from "./config.js";
+import { HEADER_CLIENT, HEADER_SESSION_ID, HEADER_TOOL, HEADER_USER_AGENT, } from "./http-headers.js";
+import { generatePromptMessage, generatePrompts } from "./prompts.js";
+import { setupGracefulShutdown } from "./shutdown.js";
+import { filterTools } from "./tool-filter.js";
+import { createAllTools } from "./tools/index.js";
+import { sanitizeUrlForLogs } from "./utils/url.js";
+// Get package version
+const packageJson = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), "..", "package.json"), "utf-8"));
+export class IterableMcpServer {
+    server;
+    iterableClient;
+    tools;
+    prompts;
+    // Since we are using the stdio transport, we assume a global session
+    globalSessionId = createSessionId();
+    sessionContext = new AsyncLocalStorage();
+    constructor() {
+        this.server = new Server({
+            name: "iterable-mcp",
+            version: packageJson.version,
+        }, {
+            capabilities: {
+                tools: {},
+                prompts: {},
+            },
+        });
+        this.setupHandlers();
+        // Set up callback to log when MCP handshake completes
+        this.server.oninitialized = () => {
+            logger.info("MCP session initialized", {
+                sessionId: this.globalSessionId,
+                clientName: detectClientName(this.server),
+            });
+        };
+        this.server.onerror = (error) => logger.error("MCP Error", { error });
+        // Setup graceful shutdown
+        setupGracefulShutdown(async () => {
+            await this.server.close();
+        });
+    }
+    setupHandlers() {
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
+            tools: this.tools,
+        }));
+        this.server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+            prompts: this.prompts,
+        }));
+        this.server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            if (!this.prompts.some((prompt) => prompt.name === name)) {
+                throw new McpError(ErrorCode.InvalidRequest, `Unknown prompt: ${name}`);
+            }
+            return generatePromptMessage(name, args || {});
+        });
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            const tool = this.tools.find((tool) => tool.name === name);
+            if (!tool || typeof tool.handler !== "function") {
+                throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+            }
+            try {
+                return await this.sessionContext.run({
+                    sessionId: this.globalSessionId,
+                    clientName: detectClientName(this.server),
+                    toolName: name,
+                }, async () => {
+                    return await tool.handler(args || {});
+                });
+            }
+            catch (error) {
+                if (error instanceof McpError) {
+                    throw error;
+                }
+                throw new McpError(ErrorCode.InternalError, `Error executing tool ${name}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        });
+    }
+    setupHttpInterceptors() {
+        // Request interceptor for adding session headers
+        this.iterableClient.client.interceptors.request.use((config) => {
+            const sessionContext = this.sessionContext.getStore();
+            const userAgent = [
+                `iterable-mcp/${packageJson.version}`,
+                DEFAULT_USER_AGENT,
+                `(node=${process.versions.node}; os=${process.platform}; client=${sessionContext?.clientName || "none"})`,
+            ].join(" ");
+            Object.assign(config.headers, {
+                [HEADER_CLIENT]: sessionContext?.clientName,
+                [HEADER_SESSION_ID]: sessionContext?.sessionId,
+                [HEADER_TOOL]: sessionContext?.toolName,
+                [HEADER_USER_AGENT]: userAgent,
+            });
+            try {
+                const method = String(config.method || "GET").toUpperCase();
+                const baseURL = config.baseURL || this.iterableClient.client.defaults.baseURL;
+                const url = config.url || "";
+                const fullUrl = `${baseURL || ""}${url}`;
+                const safeUrl = sanitizeUrlForLogs(fullUrl);
+                // SECURITY: Do not log headers or params; sanitize URL to avoid PII
+                logger.debug("MCP HTTP request", {
+                    method,
+                    url: safeUrl,
+                    timeout: config.timeout,
+                });
+            }
+            catch {
+                // Ignore logging errors
+            }
+            return config;
+        });
+        // Response interceptor for error logging
+        this.iterableClient.client.interceptors.response.use((response) => response, (error) => {
+            try {
+                const cfg = error?.config || {};
+                const method = String(cfg.method || "GET").toUpperCase();
+                const baseURL = cfg.baseURL || this.iterableClient.client.defaults.baseURL;
+                const url = cfg.url || "";
+                const fullUrl = `${baseURL || ""}${url}`;
+                const safeUrl = sanitizeUrlForLogs(fullUrl);
+                logger.error("MCP HTTP error", {
+                    method,
+                    url: safeUrl,
+                    message: String(error?.message || "Unknown error"),
+                });
+            }
+            catch {
+                // Ignore logging errors
+            }
+            return Promise.reject(error);
+        });
+    }
+    async run() {
+        const mcpConfig = await loadMcpServerConfig();
+        // Initialize Iterable client with API key and base URL from config
+        this.iterableClient = new IterableClient({
+            apiKey: mcpConfig.apiKey,
+            baseURL: mcpConfig.baseUrl || "https://api.iterable.com",
+        });
+        this.setupHttpInterceptors();
+        // Create tools with filtering based on configuration
+        const allTools = createAllTools(this.iterableClient);
+        this.tools = filterTools(allTools, mcpConfig);
+        // Create prompts from read-only tools only (for safety)
+        const readOnlyTools = filterTools(allTools, {
+            ...mcpConfig,
+            allowWrites: false,
+            allowSends: false,
+        });
+        this.prompts = generatePrompts(readOnlyTools);
+        await this.server.connect(new StdioServerTransport());
+        logger.info(`Iterable MCP server v${packageJson.version} running on stdio`);
+        logger.info(`Configuration: PII=${mcpConfig.allowUserPii}, Writes=${mcpConfig.allowWrites}, Sends=${mcpConfig.allowSends}`);
+        logger.info(`Available tools: ${this.tools.length}`);
+        logger.debug("Debug mode enabled");
+    }
+}
+function createSessionId() {
+    return Math.random().toString(36).slice(2) + Date.now().toString(36);
+}
+//# 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/shutdown.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Simple graceful shutdown handling for the MCP server
+ */
+export declare function setupGracefulShutdown(handler?: () => Promise<void>): void;
+//# sourceMappingURL=shutdown.d.ts.map

package/dist/shutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../src/shutdown.ts"],"names":[],"mappings":"AAAA;;GAEG;AA4DH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAyBzE"}

package/dist/shutdown.js

@@ -0,0 +1,68 @@
+/**
+ * Simple graceful shutdown handling for the MCP server
+ */
+import { createIterableConfig } from "@iterable/api";
+import { logger } from "@iterable/api";
+// Get config for shutdown timeout
+const config = (() => {
+    try {
+        const iterableConfig = createIterableConfig();
+        return { SHUTDOWN_TIMEOUT: iterableConfig.timeout || 30000 };
+    }
+    catch {
+        return { SHUTDOWN_TIMEOUT: 30000 };
+    }
+})();
+let isShuttingDown = false;
+async function shutdown(signal, handler) {
+    if (isShuttingDown) {
+        logger.info("Shutdown already in progress");
+        return;
+    }
+    isShuttingDown = true;
+    logger.info("Starting graceful shutdown", { signal });
+    const shutdownStart = Date.now();
+    try {
+        if (handler) {
+            // Run shutdown handler with timeout
+            await Promise.race([
+                handler(),
+                new Promise((_, reject) => setTimeout(() => reject(new Error(`Shutdown timeout after ${config.SHUTDOWN_TIMEOUT}ms`)), config.SHUTDOWN_TIMEOUT)),
+            ]);
+        }
+        const duration = Date.now() - shutdownStart;
+        logger.info("Graceful shutdown completed", { duration });
+        process.exit(0);
+    }
+    catch (error) {
+        logger.error("Graceful shutdown failed", {
+            error: error instanceof Error ? error.message : String(error),
+            duration: Date.now() - shutdownStart,
+        });
+        process.exit(1);
+    }
+}
+export function setupGracefulShutdown(handler) {
+    // Register signal handlers
+    const signals = ["SIGTERM", "SIGINT"];
+    signals.forEach((signal) => {
+        process.once(signal, () => {
+            void shutdown(signal, handler);
+        });
+    });
+    // Handle uncaught errors
+    process.once("uncaughtException", (error) => {
+        logger.error("Uncaught exception, shutting down", {
+            error: error.message,
+            stack: error.stack,
+        });
+        void shutdown("uncaughtException", handler);
+    });
+    process.once("unhandledRejection", (reason) => {
+        logger.error("Unhandled rejection, shutting down", {
+            reason: String(reason),
+        });
+        void shutdown("unhandledRejection", handler);
+    });
+}
+//# sourceMappingURL=shutdown.js.map

package/dist/shutdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.js","sourceRoot":"","sources":["../src/shutdown.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,kCAAkC;AAClC,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE;IACnB,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,oBAAoB,EAAE,CAAC;QAC9C,OAAO,EAAE,gBAAgB,EAAE,cAAc,CAAC,OAAO,IAAI,KAAK,EAAE,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC;IACrC,CAAC;AACH,CAAC,CAAC,EAAE,CAAC;AAEL,IAAI,cAAc,GAAG,KAAK,CAAC;AAE3B,KAAK,UAAU,QAAQ,CACrB,MAAc,EACd,OAA6B;IAE7B,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC5C,OAAO;IACT,CAAC;IAED,cAAc,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAEtD,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEjC,IAAI,CAAC;QACH,IAAI,OAAO,EAAE,CAAC;YACZ,oCAAoC;YACpC,MAAM,OAAO,CAAC,IAAI,CAAC;gBACjB,OAAO,EAAE;gBACT,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CACxB,UAAU,CACR,GAAG,EAAE,CACH,MAAM,CACJ,IAAI,KAAK,CAAC,0BAA0B,MAAM,CAAC,gBAAgB,IAAI,CAAC,CACjE,EACH,MAAM,CAAC,gBAAgB,CACxB,CACF;aACF,CAAC,CAAC;QACL,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE;YACvC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;YAC7D,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa;SACrC,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAA6B;IACjE,2BAA2B;IAC3B,MAAM,OAAO,GAAqB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAExD,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QACzB,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;YACxB,KAAK,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,yBAAyB;IACzB,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;QAC1C,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE;YAChD,KAAK,EAAE,KAAK,CAAC,OAAO;YACpB,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAC;QACH,KAAK,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;QAC5C,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE;YACjD,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;SACvB,CAAC,CAAC;QACH,KAAK,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tool-filter.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Tool filtering system for MCP server restrictions
+ * Uses safe-list approach: explicitly allow safe tools, block everything else
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { McpServerConfig } from "./config.js";
+export declare const NON_PII_TOOLS: Set<string>;
+export declare const READ_ONLY_TOOLS: Set<string>;
+/**
+ * Tools that can directly or indirectly trigger sending messages.
+ * Conservative: includes immediate sends, scheduling, triggers, and event/journey triggers.
+ */
+export declare const SEND_TOOLS: Set<string>;
+/**
+ * Filter tools based on configuration restrictions
+ * Uses safe-list approach: only allow explicitly safe tools
+ */
+export declare function filterTools(tools: Tool[], config: McpServerConfig): Tool[];
+//# sourceMappingURL=tool-filter.d.ts.map

package/dist/tool-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-filter.d.ts","sourceRoot":"","sources":["../src/tool-filter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,aAAa,EAAE,GAAG,CAAC,MAAM,CA2DpC,CAAC;AAEH,eAAO,MAAM,eAAe,EAAE,GAAG,CAAC,MAAM,CAsCtC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,GAAG,CAAC,MAAM,CA0BjC,CAAC;AAEH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,EAAE,CAO1E"}

package/dist/tool-filter.js

@@ -0,0 +1,144 @@
+/**
+ * Tool filtering system for MCP server restrictions
+ * Uses safe-list approach: explicitly allow safe tools, block everything else
+ */
+export const NON_PII_TOOLS = new Set([
+    "abort_campaign",
+    "activate_triggered_campaign",
+    "archive_campaigns",
+    "bulk_delete_catalog_items",
+    "cancel_campaign",
+    "create_campaign",
+    "create_catalog",
+    "create_list",
+    "create_snippet",
+    "deactivate_triggered_campaign",
+    "delete_catalog",
+    "delete_catalog_item",
+    "delete_list",
+    "delete_snippet",
+    "delete_templates",
+    "get_campaign",
+    "get_campaign_metrics",
+    "get_campaigns",
+    "get_catalog_field_mappings",
+    "get_catalog_item",
+    "get_catalog_items",
+    "get_catalogs",
+    "get_channels",
+    "get_child_campaigns",
+    "get_email_template",
+    "get_experiment_metrics",
+    "get_inapp_template",
+    "get_journeys",
+    "get_list_size",
+    "get_lists",
+    "get_message_types",
+    "get_push_template",
+    "get_sms_template",
+    "get_snippet",
+    "get_snippets",
+    "get_template_by_client_id",
+    "get_templates",
+    "get_user_fields",
+    "get_webhooks",
+    "partial_update_catalog_item",
+    "preview_email_template",
+    "preview_inapp_template",
+    "replace_catalog_item",
+    "schedule_campaign",
+    "send_campaign",
+    "trigger_campaign",
+    "update_catalog_field_mappings",
+    "update_catalog_items",
+    "update_email_template",
+    "update_inapp_template",
+    "update_push_template",
+    "update_sms_template",
+    "update_snippet",
+    "update_webhook",
+    "upsert_email_template",
+    "upsert_inapp_template",
+    "upsert_push_template",
+    "upsert_sms_template",
+]);
+export const READ_ONLY_TOOLS = new Set([
+    "get_campaign",
+    "get_campaign_metrics",
+    "get_campaigns",
+    "get_catalog_field_mappings",
+    "get_catalog_item",
+    "get_catalog_items",
+    "get_catalogs",
+    "get_channels",
+    "get_child_campaigns",
+    "get_email_template",
+    "get_embedded_messages",
+    "get_experiment_metrics",
+    "get_export_files",
+    "get_export_jobs",
+    "get_in_app_messages",
+    "get_inapp_template",
+    "get_journeys",
+    "get_list_preview_users",
+    "get_list_size",
+    "get_list_users",
+    "get_lists",
+    "get_message_types",
+    "get_push_template",
+    "get_sent_messages",
+    "get_sms_template",
+    "get_snippet",
+    "get_snippets",
+    "get_template_by_client_id",
+    "get_templates",
+    "get_user_by_email",
+    "get_user_by_user_id",
+    "get_user_events_by_email",
+    "get_user_events_by_user_id",
+    "get_user_fields",
+    "get_webhooks",
+    "preview_email_template",
+    "preview_inapp_template",
+]);
+/**
+ * Tools that can directly or indirectly trigger sending messages.
+ * Conservative: includes immediate sends, scheduling, triggers, and event/journey triggers.
+ */
+export const SEND_TOOLS = new Set([
+    // Campaign sends and enablers
+    "send_campaign",
+    "trigger_campaign",
+    "schedule_campaign",
+    // Creating a blast campaign can send immediately if sendAt not provided
+    "create_campaign",
+    // Triggered campaigns can cause sends upon activation; block unless explicitly allowed
+    "activate_triggered_campaign",
+    // Journey triggers enqueue users which may send
+    "trigger_journey",
+    // Events may drive sends via triggers/journeys
+    "track_event",
+    "track_bulk_events",
+    // Direct per-user messaging sends
+    "send_email",
+    "send_sms",
+    "send_whatsapp",
+    "send_web_push",
+    "send_push",
+    "send_in_app",
+    // Template proof sends (send to specific test recipient)
+    "send_email_template_proof",
+    "send_sms_template_proof",
+    "send_push_template_proof",
+    "send_inapp_template_proof",
+]);
+/**
+ * Filter tools based on configuration restrictions
+ * Uses safe-list approach: only allow explicitly safe tools
+ */
+export function filterTools(tools, config) {
+    return tools.filter((tool) => (config.allowUserPii || NON_PII_TOOLS.has(tool.name)) &&
+        (config.allowWrites || READ_ONLY_TOOLS.has(tool.name)) &&
+        (config.allowSends || !SEND_TOOLS.has(tool.name)));
+}
+//# sourceMappingURL=tool-filter.js.map

package/dist/tool-filter.js.map

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

package/dist/tools/campaigns.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP tools for Iterable campaign operations
+ */
+import type { IterableClient } from "@iterable/api";
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare function createCampaignTools(client: IterableClient): Tool[];
+//# sourceMappingURL=campaigns.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"campaigns.d.ts","sourceRoot":"","sources":["../../src/tools/campaigns.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAgBpD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAI/D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,EAAE,CAwFlE"}