@instantkom/mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 instantKOM, Inh. Simon Theophil
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,274 @@
+# instantKOM MCP Server
+
+Model Context Protocol (MCP) Server for the instantKOM REST API. This server enables AI assistants like Claude to interact directly with the instantKOM API through standardized MCP tools.
+
+## Features
+
+- **Multi-Tenant Support**: Configure different access levels for internal use and customers
+- **Scoped Access**: Public, App, and Admin level tools based on tenant configuration
+- **230+ Tools**: Full CRUD coverage for Channels, Contacts, Messages, Newsletters, Bots, Flows, Analytics and more
+- **Type-Safe**: Built with TypeScript for robust type checking
+- **Flexible Authentication**: Bearer token authentication with configurable API keys
+
+## Distribution
+
+- **Public package** (recommended for customers): `npx -y @instantkom/mcp-server` -- ships only public app tools (no admin/internal)
+- **Public repo**: https://github.com/instantKOM/mcp-server (mirror of `services/mcp-server/` from this monorepo)
+- **Internal**: this folder; includes admin tools and tenant config
+
+## Quick Start
+
+### Installation
+
+```bash
+cd services/mcp-server
+npm install
+```
+
+### Configuration
+
+1. Copy the example environment file:
+```bash
+cp .env.example .env
+```
+
+2. Edit `.env` to select your tenant:
+```env
+TENANT_ID=internal
+```
+
+3. (Optional) Configure tenants in `src/config/tenants.json`
+
+### Development
+
+Run the server in development mode:
+```bash
+npm run dev
+```
+
+### Build and Run
+
+Build the TypeScript code:
+```bash
+npm run build
+```
+
+Run the compiled server:
+```bash
+npm start
+```
+
+## Usage with Claude Code / Claude Desktop
+
+### Public package (customers)
+
+```json
+{
+  "mcpServers": {
+    "instantkom": {
+      "command": "npx",
+      "args": ["-y", "@instantkom/mcp-server"],
+      "env": {
+        "INSTANTKOM_API_KEY": "ik_live_..."
+      }
+    }
+  }
+}
+```
+
+### Local internal build (developers)
+
+```json
+{
+  "mcpServers": {
+    "instantkom": {
+      "command": "node",
+      "args": [
+        "/path/to/instantkom/services/mcp-server/dist/index.js"
+      ],
+      "env": {
+        "TENANT_ID": "internal"
+      }
+    }
+  }
+}
+```
+
+For development with tsx (auto-reload):
+```json
+{
+  "mcpServers": {
+    "instantkom": {
+      "command": "npx",
+      "args": [
+        "tsx",
+        "/path/to/instantkom/services/mcp-server/src/index.ts"
+      ],
+      "env": {
+        "TENANT_ID": "internal"
+      }
+    }
+  }
+}
+```
+
+After updating the configuration, restart Claude Code to load the MCP server.
+
+## Available Tools (overview)
+
+The server ships **230+ tools** covering all instantKOM resource types. The full list with parameters is documented at https://api.instantkom.app/api-docs (each REST endpoint has a corresponding MCP tool).
+
+### Public scope (no auth required)
+- `get_health`
+
+### App scope (app + admin tenants)
+
+| Category | Examples | Approx. count |
+|----------|----------|---------------|
+| Channels | `list_channels`, `get_channel`, `create_channel`, `update_channel`, `delete_channel` | 7 |
+| Contacts | `list_contacts`, `get_contact`, `create_contact`, ... | 5 |
+| Messages | `list_messages`, `send_message`, `get_message`, ... | 10 |
+| Broadcasts (Newsletters) | `list_broadcasts`, `create_broadcast`, `send_broadcast`, ... | 6 |
+| Bots & Flows | bot CRUD, flow nodes, flow edges | 38 |
+| Templates & Tags | template + tag CRUD, tag assignment | 21 |
+| Analytics | dashboard, broadcasts, contacts, messages KPIs | 5 |
+| Segmentation & QR | segmentation CRUD, QR codes, shortlinks | 13 |
+| Tickets, Webhooks, Polls, Events, Media, Custom Fields, Object Folders, ... | full CRUD | 100+ |
+
+### Admin scope (internal tenants only)
+Includes platform-level analytics, user/team/billing operations, and feature flag management. Not part of the public package.
+
+## Multi-Tenant Configuration
+
+Edit `src/config/tenants.json` to configure different tenants:
+
+```json
+{
+  "tenants": [
+    {
+      "id": "internal",
+      "name": "instantKOM Internal",
+      "apiUrl": "http://localhost:3002",
+      "apiKey": "your-api-key",
+      "scope": "admin"
+    },
+    {
+      "id": "customer-readonly",
+      "name": "Customer Read-Only",
+      "apiUrl": "https://api.instantkom.app",
+      "apiKey": "customer-api-key",
+      "scope": "app",
+      "enabledTools": ["list_*", "get_*"]
+    }
+  ]
+}
+```
+
+### Tenant Configuration Options
+
+- `id`: Unique identifier (used in TENANT_ID env var)
+- `name`: Display name
+- `apiUrl`: REST API base URL
+- `apiKey`: Bearer token for authentication
+- `scope`: Access level (`public`, `app`, `admin`)
+- `enabledTools` (optional): Whitelist specific tools (supports wildcards)
+
+## Environment Variables
+
+- `TENANT_ID`: Tenant identifier (default: `internal`)
+- `API_URL`: Override tenant's API URL
+- `API_KEY`: Override tenant's API key
+- `LOG_LEVEL`: Logging level (error, warn, info, debug)
+
+## Architecture
+
+```
+services/mcp-server/
+├── src/
+│   ├── index.ts              # MCP Server entry point
+│   ├── config/
+│   │   ├── config.ts         # Configuration loader
+│   │   └── tenants.json      # Tenant configurations
+│   ├── client/
+│   │   └── api-client.ts     # HTTP client for REST API
+│   ├── types/
+│   │   └── index.ts          # TypeScript type definitions
+│   └── tools/
+│       ├── public/           # Public tools (health)
+│       ├── app/              # App-level tools (channels, contacts, etc.)
+│       └── admin/            # Admin-level tools (analytics)
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+## Development
+
+### Adding New Tools
+
+1. Create a new file in the appropriate directory (`tools/public/`, `tools/app/`, or `tools/admin/`)
+2. Export tool definitions and handler functions
+3. Import and register in `src/index.ts`
+4. Add types to `src/types/index.ts` if needed
+
+Example:
+```typescript
+// tools/app/example.ts
+export async function exampleTool(apiClient: ApiClient, args: any): Promise<any> {
+  const response = await apiClient.get('/v1/example');
+  return {
+    content: [{ type: 'text', text: JSON.stringify(response.data, null, 2) }],
+  };
+}
+
+export const exampleTools = [
+  {
+    name: 'example_tool',
+    description: 'Example tool description',
+    inputSchema: {
+      type: 'object',
+      properties: { /* ... */ },
+      required: [],
+    },
+  },
+];
+```
+
+### Testing
+
+The MCP server can be tested by:
+1. Using Claude Code with the server configured
+2. Testing API endpoints with the manual test script in `services/api/manual-tests/`
+3. Checking logs in stderr (the server uses stdio for MCP communication)
+
+## Security
+
+- API keys are passed as Bearer tokens
+- Tenant configurations support scope-based access control
+- Tool-level permissions via `enabledTools` whitelist
+- All API communication over HTTPS in production
+
+## Troubleshooting
+
+**Server won't start:**
+- Check that the tenant ID exists in `tenants.json`
+- Verify API key is correctly configured
+- Ensure Node.js version is 18 or higher
+
+**Tools not appearing:**
+- Check tenant scope (`public` < `app` < `admin`)
+- Verify `enabledTools` whitelist if configured
+- Restart Claude Code after configuration changes
+
+**API errors:**
+- Verify API URL is correct and accessible
+- Check API key is valid
+- Review stderr logs for detailed error messages
+
+## License
+
+MIT
+
+## Support
+
+For issues and questions, please refer to the main instantKOM repository.

package/dist/client/api-client.d.ts

@@ -0,0 +1,76 @@
+/**
+ * HTTP Client for instantKOM REST API
+ * Handles authentication and request/response transformation
+ */
+import type { TenantConfig } from '../types/index.js';
+export declare class ApiClient {
+    private baseUrl;
+    private apiKey;
+    private tenantId;
+    private scope;
+    private username?;
+    private password?;
+    private jwtAccessToken?;
+    private jwtRefreshToken?;
+    private jwtExpiresAt?;
+    constructor(tenant: TenantConfig);
+    /**
+     * Login and cache JWT tokens. Throws if 2FA is required or login fails.
+     */
+    private loginJwt;
+    /**
+     * Refresh the JWT access token using the stored refresh token.
+     * Returns false if refresh fails (caller should re-login).
+     */
+    private refreshJwt;
+    /**
+     * Returns a valid JWT access token, refreshing or re-logging in as needed.
+     */
+    private ensureJwtToken;
+    /**
+     * Make an authenticated request to the API.
+     * Returns parsed response data directly. Throws on HTTP errors.
+     */
+    private request;
+    /**
+     * Invalidate cached JWT tokens. Next request will trigger a fresh login.
+     */
+    resetAuth(): void;
+    /**
+     * GET request
+     */
+    get<T>(path: string, queryParams?: Record<string, any>): Promise<T>;
+    /**
+     * GET request for binary responses.
+     */
+    getBinary(path: string, queryParams?: Record<string, any>): Promise<{
+        buffer: Buffer;
+        contentType: string | null;
+        contentDisposition: string | null;
+    }>;
+    /**
+     * POST request
+     */
+    post<T>(path: string, body?: any): Promise<T>;
+    /**
+     * PUT request
+     */
+    put<T>(path: string, body?: any): Promise<T>;
+    /**
+     * PATCH request
+     */
+    patch<T>(path: string, body?: any): Promise<T>;
+    /**
+     * DELETE request
+     */
+    delete<T>(path: string, body?: any): Promise<T>;
+    /**
+     * Get the base URL
+     */
+    getBaseUrl(): string;
+    /**
+     * Get the tenant ID
+     */
+    getTenantId(): string;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/client/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/client/api-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,CAAS;IAG1B,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,YAAY,CAAC,CAAS;gBAElB,MAAM,EAAE,YAAY;IAWhC;;OAEG;YACW,QAAQ;IAoBtB;;;OAGG;YACW,UAAU;IAoBxB;;OAEG;YACW,cAAc;IAa5B;;;OAGG;YACW,OAAO;IA4DrB;;OAEG;IACH,SAAS,IAAI,IAAI;IAOjB;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAIzE;;OAEG;IACG,SAAS,CACb,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAChC,OAAO,CAAC;QACT,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;KACnC,CAAC;IA4CF;;OAEG;IACG,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAInD;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAIlD;;OAEG;IACG,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAIpD;;OAEG;IACG,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAIrD;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,WAAW,IAAI,MAAM;CAGtB"}

package/dist/client/api-client.js

@@ -0,0 +1,234 @@
+/**
+ * HTTP Client for instantKOM REST API
+ * Handles authentication and request/response transformation
+ */
+import fetch from 'node-fetch';
+export class ApiClient {
+    baseUrl;
+    apiKey;
+    tenantId;
+    scope;
+    username;
+    password;
+    // JWT token cache
+    jwtAccessToken;
+    jwtRefreshToken;
+    jwtExpiresAt; // ms timestamp
+    constructor(tenant) {
+        this.baseUrl = tenant.apiUrl;
+        this.apiKey = tenant.apiKey;
+        this.tenantId = tenant.id;
+        this.scope = tenant.scope;
+        // App-scope tenants use the Public API (/v1/*) which only accepts API keys.
+        // Only admin-scope tenants use JWT authentication.
+        this.username = tenant.scope === 'admin' ? tenant.username : undefined;
+        this.password = tenant.scope === 'admin' ? tenant.password : undefined;
+    }
+    /**
+     * Login and cache JWT tokens. Throws if 2FA is required or login fails.
+     */
+    async loginJwt() {
+        const url = new URL('/auth/login', this.baseUrl);
+        const response = await fetch(url.toString(), {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', 'User-Agent': 'instantKOM-MCP-Server/1.0.0' },
+            body: JSON.stringify({ username: this.username, password: this.password }),
+        });
+        const data = await response.json();
+        if (!response.ok) {
+            throw new Error(`JWT login failed (${response.status}): ${data?.message || response.statusText}`);
+        }
+        if (data.requiresTwoFactor) {
+            throw new Error('JWT login requires 2FA — use a service account without 2FA enabled');
+        }
+        this.jwtAccessToken = data.accessToken;
+        this.jwtRefreshToken = data.refreshToken;
+        this.jwtExpiresAt = Date.now() + (data.expiresIn ?? 900) * 1000;
+        console.error(`[API] JWT login successful (tenant: ${this.tenantId}), expires in ${data.expiresIn}s`);
+    }
+    /**
+     * Refresh the JWT access token using the stored refresh token.
+     * Returns false if refresh fails (caller should re-login).
+     */
+    async refreshJwt() {
+        try {
+            const url = new URL('/auth/refresh', this.baseUrl);
+            const response = await fetch(url.toString(), {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', 'User-Agent': 'instantKOM-MCP-Server/1.0.0' },
+                body: JSON.stringify({ refreshToken: this.jwtRefreshToken }),
+            });
+            if (!response.ok)
+                return false;
+            const data = await response.json();
+            this.jwtAccessToken = data.accessToken;
+            if (data.refreshToken)
+                this.jwtRefreshToken = data.refreshToken;
+            this.jwtExpiresAt = Date.now() + (data.expiresIn ?? 900) * 1000;
+            console.error('[API] JWT token refreshed');
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Returns a valid JWT access token, refreshing or re-logging in as needed.
+     */
+    async ensureJwtToken() {
+        const buffer = 60_000; // 1 min safety margin before expiry
+        if (this.jwtAccessToken && this.jwtExpiresAt && Date.now() < this.jwtExpiresAt - buffer) {
+            return this.jwtAccessToken;
+        }
+        if (this.jwtRefreshToken) {
+            const refreshed = await this.refreshJwt();
+            if (refreshed)
+                return this.jwtAccessToken;
+        }
+        await this.loginJwt();
+        return this.jwtAccessToken;
+    }
+    /**
+     * Make an authenticated request to the API.
+     * Returns parsed response data directly. Throws on HTTP errors.
+     */
+    async request(method, path, body, queryParams) {
+        // Build URL with query parameters
+        const url = new URL(path.startsWith('/') ? path : `/${path}`, this.baseUrl);
+        if (queryParams) {
+            Object.entries(queryParams).forEach(([key, value]) => {
+                if (value !== undefined && value !== null) {
+                    url.searchParams.append(key, String(value));
+                }
+            });
+        }
+        // Resolve auth: JWT (if credentials configured) or API key
+        const token = this.username && this.password
+            ? await this.ensureJwtToken()
+            : this.apiKey;
+        // Prepare request options
+        const options = {
+            method,
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${token}`,
+                'User-Agent': 'instantKOM-MCP-Server/1.0.0',
+            },
+        };
+        if (body && (method === 'POST' || method === 'PUT' || method === 'PATCH' || method === 'DELETE')) {
+            options.body = JSON.stringify(body);
+        }
+        console.error(`[API] ${method} ${url.pathname}${url.search}`);
+        // Make the request
+        const response = await fetch(url.toString(), options);
+        const responseText = await response.text();
+        // Try to parse JSON response
+        let data;
+        try {
+            data = responseText ? JSON.parse(responseText) : null;
+        }
+        catch {
+            data = responseText;
+        }
+        // Handle error responses
+        if (!response.ok) {
+            const message = data?.message || response.statusText;
+            console.error(`[API] Error ${response.status}: ${responseText}`);
+            throw new Error(`HTTP ${response.status}: ${message}`);
+        }
+        return data;
+    }
+    /**
+     * Invalidate cached JWT tokens. Next request will trigger a fresh login.
+     */
+    resetAuth() {
+        this.jwtAccessToken = undefined;
+        this.jwtRefreshToken = undefined;
+        this.jwtExpiresAt = undefined;
+        console.error(`[API] Auth cache cleared (tenant: ${this.tenantId})`);
+    }
+    /**
+     * GET request
+     */
+    async get(path, queryParams) {
+        return this.request('GET', path, undefined, queryParams);
+    }
+    /**
+     * GET request for binary responses.
+     */
+    async getBinary(path, queryParams) {
+        const url = new URL(path.startsWith('/') ? path : `/${path}`, this.baseUrl);
+        if (queryParams) {
+            Object.entries(queryParams).forEach(([key, value]) => {
+                if (value !== undefined && value !== null) {
+                    url.searchParams.append(key, String(value));
+                }
+            });
+        }
+        const token = this.username && this.password
+            ? await this.ensureJwtToken()
+            : this.apiKey;
+        const response = await fetch(url.toString(), {
+            method: 'GET',
+            headers: {
+                'Authorization': `Bearer ${token}`,
+                'User-Agent': 'instantKOM-MCP-Server/1.0.0',
+            },
+        });
+        if (!response.ok) {
+            const responseText = await response.text();
+            let data;
+            try {
+                data = responseText ? JSON.parse(responseText) : null;
+            }
+            catch {
+                data = responseText;
+            }
+            const message = data?.message || response.statusText;
+            throw new Error(`HTTP ${response.status}: ${message}`);
+        }
+        const arrayBuffer = await response.arrayBuffer();
+        return {
+            buffer: Buffer.from(arrayBuffer),
+            contentType: response.headers.get('content-type'),
+            contentDisposition: response.headers.get('content-disposition'),
+        };
+    }
+    /**
+     * POST request
+     */
+    async post(path, body) {
+        return this.request('POST', path, body);
+    }
+    /**
+     * PUT request
+     */
+    async put(path, body) {
+        return this.request('PUT', path, body);
+    }
+    /**
+     * PATCH request
+     */
+    async patch(path, body) {
+        return this.request('PATCH', path, body);
+    }
+    /**
+     * DELETE request
+     */
+    async delete(path, body) {
+        return this.request('DELETE', path, body);
+    }
+    /**
+     * Get the base URL
+     */
+    getBaseUrl() {
+        return this.baseUrl;
+    }
+    /**
+     * Get the tenant ID
+     */
+    getTenantId() {
+        return this.tenantId;
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/client/api-client.js.map

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

package/dist/index.public.d.ts

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+/**
+ * instantKOM MCP Server - Public Entry Point
+ *
+ * Simplified standalone server for customers.
+ * Reads INSTANTKOM_API_KEY from environment — no tenants.json required.
+ *
+ * Usage:
+ *   npx @instantkom/mcp-server
+ *
+ * Config in Claude Code (.mcp.json):
+ *   {
+ *     "mcpServers": {
+ *       "instantkom": {
+ *         "command": "npx",
+ *         "args": ["-y", "@instantkom/mcp-server"],
+ *         "env": { "INSTANTKOM_API_KEY": "ik_live_..." }
+ *       }
+ *     }
+ *   }
+ */
+export {};
+//# sourceMappingURL=index.public.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.public.d.ts","sourceRoot":"","sources":["../src/index.public.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;GAmBG"}