@instantkom/mcp-server 1.0.0

package/dist/tools/app/widgets.d.ts

@@ -0,0 +1,103 @@
+import type { ApiClient } from '../../client/api-client.js';
+/**
+ * Widgets Tools
+ * Widget and superwidget management
+ */
+export declare function listWidgets(apiClient: ApiClient, args: any): Promise<any>;
+export declare function getWidget(apiClient: ApiClient, args: {
+    id: number;
+}): Promise<any>;
+export declare function createWidget(apiClient: ApiClient, args: any): Promise<any>;
+export declare function updateWidget(apiClient: ApiClient, args: any): Promise<any>;
+export declare function deleteWidget(apiClient: ApiClient, args: {
+    id: number;
+}): Promise<any>;
+export declare const widgetTools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            page: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            id?: undefined;
+            name?: undefined;
+            type?: undefined;
+            config?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            id: {
+                type: string;
+                description: string;
+            };
+            page?: undefined;
+            limit?: undefined;
+            name?: undefined;
+            type?: undefined;
+            config?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            name: {
+                type: string;
+                description: string;
+            };
+            type: {
+                type: string;
+                description: string;
+            };
+            config: {
+                type: string;
+                description: string;
+            };
+            page?: undefined;
+            limit?: undefined;
+            id?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            id: {
+                type: string;
+                description: string;
+            };
+            name: {
+                type: string;
+                description: string;
+            };
+            config: {
+                type: string;
+                description: string;
+            };
+            page?: undefined;
+            limit?: undefined;
+            type?: undefined;
+        };
+        required: string[];
+    };
+})[];
+//# sourceMappingURL=widgets.d.ts.map

package/dist/tools/app/widgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widgets.d.ts","sourceRoot":"","sources":["../../../src/tools/app/widgets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D;;;GAGG;AAEH,wBAAsB,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAgB/E;AAED,wBAAsB,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAWxF;AAED,wBAAsB,YAAY,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAWhF;AAED,wBAAsB,YAAY,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAYhF;AAED,wBAAsB,YAAY,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAW3F;AAED,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4DvB,CAAC"}

package/dist/tools/app/widgets.js

@@ -0,0 +1,128 @@
+/**
+ * Widgets Tools
+ * Widget and superwidget management
+ */
+export async function listWidgets(apiClient, args) {
+    const params = new URLSearchParams();
+    if (args.page)
+        params.append('page', args.page.toString());
+    if (args.limit)
+        params.append('limit', args.limit.toString());
+    const query = params.toString() ? `?${params.toString()}` : '';
+    const response = await apiClient.get(`/v1/widgets${query}`);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+    };
+}
+export async function getWidget(apiClient, args) {
+    const response = await apiClient.get(`/v1/widgets/${args.id}`);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+    };
+}
+export async function createWidget(apiClient, args) {
+    const response = await apiClient.post('/v1/widgets', args);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+    };
+}
+export async function updateWidget(apiClient, args) {
+    const { id, ...data } = args;
+    const response = await apiClient.put(`/v1/widgets/${id}`, data);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+    };
+}
+export async function deleteWidget(apiClient, args) {
+    await apiClient.delete(`/v1/widgets/${args.id}`);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: 'Widget deleted successfully',
+            },
+        ],
+    };
+}
+export const widgetTools = [
+    {
+        name: 'list_widgets',
+        description: 'List all widgets',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                page: { type: 'number', description: 'Page number (default: 1)' },
+                limit: { type: 'number', description: 'Items per page (default: 10)' },
+            },
+        },
+    },
+    {
+        name: 'get_widget',
+        description: 'Get a specific widget by ID',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'number', description: 'Widget ID' },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'create_widget',
+        description: 'Create a new widget',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Widget name' },
+                type: { type: 'string', description: 'Widget type' },
+                config: { type: 'object', description: 'Widget configuration' },
+            },
+            required: ['name', 'type'],
+        },
+    },
+    {
+        name: 'update_widget',
+        description: 'Update an existing widget',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'number', description: 'Widget ID' },
+                name: { type: 'string', description: 'Widget name' },
+                config: { type: 'object', description: 'Widget configuration' },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'delete_widget',
+        description: 'Delete a widget',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'number', description: 'Widget ID' },
+            },
+            required: ['id'],
+        },
+    },
+];
+//# sourceMappingURL=widgets.js.map

package/dist/tools/app/widgets.js.map

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

package/dist/tools/public/health.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Public Tools - Health Check
+ * No authentication required
+ */
+import type { ApiClient } from '../../client/api-client.js';
+export declare function getHealth(apiClient: ApiClient): Promise<any>;
+export declare const healthTools: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {};
+        required: never[];
+    };
+}[];
+//# sourceMappingURL=health.d.ts.map

package/dist/tools/public/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/tools/public/health.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D,wBAAsB,SAAS,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAWlE;AAED,eAAO,MAAM,WAAW;;;;;;;;GAUvB,CAAC"}

package/dist/tools/public/health.js

@@ -0,0 +1,27 @@
+/**
+ * Public Tools - Health Check
+ * No authentication required
+ */
+export async function getHealth(apiClient) {
+    const response = await apiClient.get('/v1/health');
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+    };
+}
+export const healthTools = [
+    {
+        name: 'get_health',
+        description: 'Get API health status and uptime information',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+];
+//# sourceMappingURL=health.js.map

package/dist/tools/public/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../src/tools/public/health.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAAoB;IAClD,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAEnD,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;aACxC;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,8CAA8C;QAC3D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;SACb;KACF;CACF,CAAC"}

package/dist/tools/public/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Public Tools - Index
+ * Aggregates all public tools
+ */
+export { getHealth, healthTools } from './health.js';
+export declare const publicTools: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {};
+        required: never[];
+    };
+}[];
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/public/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/public/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAErD,eAAO,MAAM,WAAW;;;;;;;;GAEvB,CAAC"}

package/dist/tools/public/index.js

@@ -0,0 +1,10 @@
+/**
+ * Public Tools - Index
+ * Aggregates all public tools
+ */
+import { healthTools } from './health.js';
+export { getHealth, healthTools } from './health.js';
+export const publicTools = [
+    ...healthTools,
+];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/public/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,GAAG,WAAW;CACf,CAAC"}

package/dist/tools/tool-router.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Dynamic Tool Router
+ * Auto-registers tool handlers by matching tool names to exported handler functions.
+ *
+ * Convention: tool name in snake_case maps to handler function in camelCase.
+ * Example: 'list_channels' -> listChannels, 'admin_get_plan' -> adminGetPlan
+ */
+import type { ApiClient } from '../client/api-client.js';
+/**
+ * Execute a tool by name
+ */
+export declare function executeTool(name: string, apiClient: ApiClient, args: any): Promise<any>;
+/**
+ * Check if a tool exists
+ */
+export declare function hasToolHandler(name: string): boolean;
+/**
+ * Get count of registered tools (useful for diagnostics)
+ */
+export declare function getRegisteredToolCount(): number;
+//# sourceMappingURL=tool-router.d.ts.map

package/dist/tools/tool-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-router.d.ts","sourceRoot":"","sources":["../../src/tools/tool-router.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAmHzD;;GAEG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAQ7F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C"}

package/dist/tools/tool-router.js

@@ -0,0 +1,118 @@
+/**
+ * Dynamic Tool Router
+ * Auto-registers tool handlers by matching tool names to exported handler functions.
+ *
+ * Convention: tool name in snake_case maps to handler function in camelCase.
+ * Example: 'list_channels' -> listChannels, 'admin_get_plan' -> adminGetPlan
+ */
+// Import all tool handlers (namespace imports)
+import * as publicHandlers from './public/index.js';
+import * as appHandlers from './app/index.js';
+import * as adminHandlers from './admin/index.js';
+import * as internalHandlers from './internal/index.js';
+// Import tool definition arrays
+import { publicTools } from './public/index.js';
+import { appTools } from './app/index.js';
+import { adminTools } from './admin/index.js';
+import { internalTools } from './internal/index.js';
+/**
+ * Tool registry mapping tool names to handlers
+ */
+const toolRegistry = new Map();
+/**
+ * Convert snake_case tool name to camelCase handler function name.
+ * Example: 'list_channels' -> 'listChannels'
+ *          'admin_get_plan' -> 'adminGetPlan'
+ */
+function snakeToCamel(name) {
+    return name.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+/**
+ * Generate candidate handler names for a tool.
+ *
+ * Tool naming conventions vary across scopes:
+ * - app:      'list_channels'           -> listChannels
+ * - admin:    'admin_list_plans'        -> listAdminPlans
+ * - internal: 'internal_list_companies' -> listCompanies
+ *
+ * This function returns all plausible camelCase names to try.
+ */
+function getCandidateNames(toolName, scope) {
+    const direct = snakeToCamel(toolName);
+    const candidates = [direct];
+    // For prefixed scopes, also try rearranged and stripped variants
+    const prefixes = ['admin_', 'internal_'];
+    for (const prefix of prefixes) {
+        if (toolName.startsWith(prefix)) {
+            const withoutPrefix = toolName.slice(prefix.length);
+            const prefixCapitalized = prefix.charAt(0).toUpperCase() + prefix.slice(1, -1); // 'Admin' or 'Internal'
+            const parts = withoutPrefix.split('_');
+            // Try inserting the prefix word after each possible verb position
+            // 'admin_bulk_delete_plans' -> try 'bulkAdminDeletePlans', 'bulkDeleteAdminPlans'
+            for (let i = 1; i <= parts.length; i++) {
+                const verbParts = parts.slice(0, i);
+                const restParts = parts.slice(i);
+                const verb = verbParts[0] + verbParts.slice(1).map(p => p.charAt(0).toUpperCase() + p.slice(1)).join('');
+                const rest = restParts.map(p => p.charAt(0).toUpperCase() + p.slice(1)).join('');
+                candidates.push(verb + prefixCapitalized + rest);
+            }
+            // 'internal_list_companies' -> 'listCompanies' (strip prefix entirely)
+            candidates.push(snakeToCamel(withoutPrefix));
+        }
+    }
+    return candidates;
+}
+/**
+ * Auto-register tools by matching tool definition names to handler functions.
+ * Tries multiple naming conventions for flexibility.
+ */
+function autoRegister(tools, handlers, scope) {
+    for (const tool of tools) {
+        const candidates = getCandidateNames(tool.name, scope);
+        let found = false;
+        for (const name of candidates) {
+            if (typeof handlers[name] === 'function') {
+                toolRegistry.set(tool.name, handlers[name]);
+                found = true;
+                break;
+            }
+        }
+        if (!found) {
+            console.error(`[tool-router] WARNING: No handler found for tool '${tool.name}' (tried: ${candidates.join(', ')}) in ${scope} handlers`);
+        }
+    }
+}
+/**
+ * Register all tool handlers
+ */
+function registerTools() {
+    autoRegister(publicTools, publicHandlers, 'public');
+    autoRegister(appTools, appHandlers, 'app');
+    autoRegister(adminTools, adminHandlers, 'admin');
+    autoRegister(internalTools, internalHandlers, 'internal');
+}
+// Initialize registry
+registerTools();
+/**
+ * Execute a tool by name
+ */
+export async function executeTool(name, apiClient, args) {
+    const handler = toolRegistry.get(name);
+    if (!handler) {
+        throw new Error(`Unknown tool: ${name}`);
+    }
+    return await handler(apiClient, args);
+}
+/**
+ * Check if a tool exists
+ */
+export function hasToolHandler(name) {
+    return toolRegistry.has(name);
+}
+/**
+ * Get count of registered tools (useful for diagnostics)
+ */
+export function getRegisteredToolCount() {
+    return toolRegistry.size;
+}
+//# sourceMappingURL=tool-router.js.map

package/dist/tools/tool-router.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Type definitions for the MCP Server
+ */
+export interface TenantConfig {
+    id: string;
+    name: string;
+    apiUrl: string;
+    apiKey: string;
+    scope: 'public' | 'app' | 'admin' | 'internal';
+    enabledTools?: string[];
+    /** Optional credentials for JWT-based auth (required for /admin/* endpoints) */
+    username?: string;
+    password?: string;
+}
+export interface TenantsConfig {
+    tenants: TenantConfig[];
+}
+export interface PaginationParams {
+    page?: number;
+    limit?: number;
+}
+export interface Channel {
+    id: number;
+    name: string;
+    gatewayType: number;
+    status: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface Contact {
+    id: number;
+    channelId: number;
+    phoneNumber: string;
+    name?: string;
+    email?: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface Message {
+    id: number;
+    channelId: number;
+    contactId: number;
+    content: string;
+    direction: 'inbound' | 'outbound';
+    status: string;
+    createdAt?: string;
+}
+export interface Broadcast {
+    id: number;
+    name: string;
+    channelId: number;
+    status: string;
+    scheduledAt?: string;
+    createdAt?: string;
+}
+export interface PlatformStats {
+    totalUsers: number;
+    activeUsers: number;
+    totalMessages: number;
+    totalChannels: number;
+}
+export interface UserAnalytics {
+    newUsers: number;
+    activeUsers: number;
+    period: string;
+}
+export interface RevenueStats {
+    totalRevenue: number;
+    mrr: number;
+    currency: string;
+    period: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,UAAU,CAAC;IAC/C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,GAAG,UAAU,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/index.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for the MCP Server
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@instantkom/mcp-server",
+  "version": "1.0.0",
+  "description": "Model Context Protocol Server for the instantKOM REST API. Lets Claude Code, Claude Desktop and other MCP-compatible AI assistants drive your instantKOM messengerzentrale.",
+  "main": "dist/index.public.js",
+  "types": "dist/index.public.d.ts",
+  "type": "module",
+  "bin": {
+    "instantkom-mcp": "./dist/index.public.js"
+  },
+  "files": [
+    "dist/index.public.js",
+    "dist/index.public.js.map",
+    "dist/index.public.d.ts",
+    "dist/index.public.d.ts.map",
+    "dist/client/**",
+    "dist/types/**",
+    "dist/tools/public/**",
+    "dist/tools/app/**",
+    "dist/tools/tool-router.js",
+    "dist/tools/tool-router.js.map",
+    "dist/tools/tool-router.d.ts",
+    "dist/tools/tool-router.d.ts.map",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc && cp src/config/tenants.json dist/config/tenants.json && chmod +x dist/index.js && chmod +x dist/index.public.js",
+    "build:public": "tsc && chmod +x dist/index.public.js",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:unit": "vitest run --project unit",
+    "test:contract": "vitest run --project contract",
+    "test:integration": "IKM_INTEGRATION_TEST=1 vitest run --project integration",
+    "test:coverage": "vitest run --coverage",
+    "check:api-coverage": "node scripts/check-api-coverage.js",
+    "check:public-package": "node scripts/check-public-package.cjs",
+    "prepublishOnly": "npm run build:public && npm run check:public-package"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "instantkom",
+    "messenger",
+    "whatsapp",
+    "telegram",
+    "signal",
+    "claude",
+    "anthropic",
+    "ai",
+    "api"
+  ],
+  "author": "instantKOM",
+  "license": "MIT",
+  "homepage": "https://github.com/instantKOM/mcp-server#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/instantKOM/mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/instantKOM/mcp-server/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "dotenv": "^17.4.2",
+    "node-fetch": "^3.3.2"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.2",
+    "@vitest/coverage-v8": "^4.1.5",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.0.18"
+  },
+  "overrides": {
+    "path-to-regexp": "^8.4.0",
+    "hono": "^4.12.16",
+    "ip-address": "^10.2.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}