@lionchat/mcp-server 0.1.0

package/dist/config.js

@@ -0,0 +1,57 @@
+// AIDEV-NOTE: Config module for LionChat MCP server
+// Reads configuration from CLI args (--key=value) and env vars, CLI takes priority
+// AIDEV-NOTE: Parse CLI args from process.argv looking for --key=value and --flag patterns
+function getCliArg(name) {
+    const prefix = `--${name}=`;
+    for (const arg of process.argv) {
+        if (arg.startsWith(prefix)) {
+            return arg.slice(prefix.length);
+        }
+        // AIDEV-NOTE: Boolean flag support (--flag without =value)
+        if (arg === `--${name}`) {
+            return 'true';
+        }
+    }
+    return undefined;
+}
+// AIDEV-NOTE: Categories come as comma-separated string, parse into array or null
+function parseCategories(raw) {
+    if (!raw || raw.trim() === '') {
+        return null;
+    }
+    return raw
+        .split(',')
+        .map((c) => c.trim())
+        .filter((c) => c.length > 0);
+}
+// AIDEV-NOTE: Priority: CLI args > env vars > defaults
+export function loadConfig() {
+    const apiToken = getCliArg('token') ?? process.env.LIONCHAT_API_TOKEN ?? undefined;
+    const accountId = getCliArg('account') ?? process.env.LIONCHAT_ACCOUNT_ID ?? undefined;
+    const baseUrl = getCliArg('base-url') ??
+        process.env.LIONCHAT_BASE_URL ??
+        'https://app.lionchat.com.br';
+    const categoriesRaw = getCliArg('categories') ?? process.env.LIONCHAT_CATEGORIES ?? undefined;
+    const includePublicApiRaw = getCliArg('include-public-api') ??
+        process.env.LIONCHAT_INCLUDE_PUBLIC_API ??
+        undefined;
+    // AIDEV-NOTE: Validate required fields with actionable error messages
+    if (!apiToken) {
+        throw new Error('Error: LIONCHAT_API_TOKEN is required.\n' +
+            'Set it as an environment variable or pass --token=YOUR_TOKEN\n' +
+            'Get your token at: Login > Profile Settings');
+    }
+    if (!accountId) {
+        throw new Error('Error: LIONCHAT_ACCOUNT_ID is required.\n' +
+            'Set it as an environment variable or pass --account=YOUR_ACCOUNT_ID\n' +
+            'Find your account ID at: Login > Settings > Account');
+    }
+    return {
+        apiToken,
+        accountId,
+        baseUrl,
+        categories: parseCategories(categoriesRaw),
+        includePublicApi: includePublicApiRaw === 'true' || includePublicApiRaw === '1',
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,mFAAmF;AAUnF,2FAA2F;AAC3F,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,MAAM,GAAG,KAAK,IAAI,GAAG,CAAC;IAC5B,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;QACD,2DAA2D;QAC3D,IAAI,GAAG,KAAK,KAAK,IAAI,EAAE,EAAE,CAAC;YACxB,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,kFAAkF;AAClF,SAAS,eAAe,CAAC,GAAuB;IAC9C,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,GAAG;SACP,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,UAAU;IACxB,MAAM,QAAQ,GACZ,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,SAAS,CAAC;IAEpE,MAAM,SAAS,GACb,SAAS,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,SAAS,CAAC;IAEvE,MAAM,OAAO,GACX,SAAS,CAAC,UAAU,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAC7B,6BAA6B,CAAC;IAEhC,MAAM,aAAa,GACjB,SAAS,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,SAAS,CAAC;IAE1E,MAAM,mBAAmB,GACvB,SAAS,CAAC,oBAAoB,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,2BAA2B;QACvC,SAAS,CAAC;IAEZ,sEAAsE;IACtE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,0CAA0C;YACxC,gEAAgE;YAChE,6CAA6C,CAChD,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,2CAA2C;YACzC,uEAAuE;YACvE,qDAAqD,CACxD,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ;QACR,SAAS;QACT,OAAO;QACP,UAAU,EAAE,eAAe,CAAC,aAAa,CAAC;QAC1C,gBAAgB,EACd,mBAAmB,KAAK,MAAM,IAAI,mBAAmB,KAAK,GAAG;KAChE,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, resolve } from 'path';
+import { loadConfig } from './config.js';
+import { LionChatClient } from './client.js';
+import { registerTools } from './tools.js';
+// AIDEV-NOTE: Read version from package.json to avoid hardcoding in multiple places
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(resolve(__dirname, '..', 'package.json'), 'utf-8'));
+const VERSION = pkg.version;
+async function main() {
+    try {
+        // AIDEV-NOTE: Load configuration from env vars (LIONCHAT_BASE_URL, LIONCHAT_API_TOKEN, etc.)
+        const config = loadConfig();
+        // AIDEV-NOTE: Warn if base URL is not HTTPS (token would be sent in cleartext)
+        if (!config.baseUrl.startsWith('https://') &&
+            !config.baseUrl.includes('localhost') &&
+            !config.baseUrl.includes('127.0.0.1')) {
+            console.error('WARNING: Base URL is not HTTPS. API token may be transmitted in cleartext.');
+        }
+        // AIDEV-NOTE: Create MCP server instance with name and version from package.json
+        const server = new McpServer({
+            name: 'lionchat-mcp-server',
+            version: VERSION,
+        });
+        // AIDEV-NOTE: Create HTTP client that wraps fetch calls to LionChat API
+        const client = new LionChatClient(config);
+        // AIDEV-NOTE: Register tools from endpoints.json, filtered by config.categories if set
+        const toolCount = registerTools(server, config, client);
+        // AIDEV-NOTE: Use stderr for logs — stdout is reserved for MCP JSON-RPC protocol
+        console.error(`LionChat MCP Server v${VERSION}`);
+        console.error(`Base URL: ${config.baseUrl}`);
+        console.error(`Account: ${config.accountId}`);
+        console.error(`Tools registered: ${toolCount}`);
+        if (config.categories) {
+            console.error(`Categories filter: ${config.categories.join(', ')}`);
+        }
+        // AIDEV-NOTE: Connect via stdio transport (stdin/stdout JSON-RPC)
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,oFAAoF;AACpF,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AACxF,MAAM,OAAO,GAAW,GAAG,CAAC,OAAO,CAAC;AAEpC,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,6FAA6F;QAC7F,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAE5B,+EAA+E;QAC/E,IACE,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC;YACtC,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;YACrC,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EACrC,CAAC;YACD,OAAO,CAAC,KAAK,CAAC,4EAA4E,CAAC,CAAC;QAC9F,CAAC;QAED,iFAAiF;QACjF,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;YAC3B,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;QAEH,wEAAwE;QACxE,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;QAE1C,uFAAuF;QACvF,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAExD,iFAAiF;QACjF,OAAO,CAAC,KAAK,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;QACjD,OAAO,CAAC,KAAK,CAAC,aAAa,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7C,OAAO,CAAC,KAAK,CAAC,YAAY,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,KAAK,CAAC,qBAAqB,SAAS,EAAE,CAAC,CAAC;QAChD,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,sBAAsB,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,kEAAkE;QAClE,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { Config } from './config.js';
+import { LionChatClient } from './client.js';
+export declare function registerTools(server: McpServer, config: Config, client: LionChatClient): number;

package/dist/tools.js

@@ -0,0 +1,280 @@
+// AIDEV-NOTE: Tool registration module for LionChat MCP server
+// Reads endpoints.json and registers each endpoint as an MCP tool with Zod schemas
+import { z } from 'zod';
+import { substitutePath, buildQueryString, formatResponse, separateParams, } from './utils.js';
+import { readFileSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+// AIDEV-NOTE: Map HTTP method to tool annotations for MCP client hinting
+function getToolAnnotations(method) {
+    switch (method.toUpperCase()) {
+        case 'GET':
+            return { readOnlyHint: true, destructiveHint: false, idempotentHint: true };
+        case 'POST':
+            return { readOnlyHint: false, destructiveHint: false, idempotentHint: false };
+        case 'PATCH':
+        case 'PUT':
+            return { readOnlyHint: false, destructiveHint: false, idempotentHint: true };
+        case 'DELETE':
+            return { readOnlyHint: false, destructiveHint: true, idempotentHint: true };
+        default:
+            return { readOnlyHint: false, destructiveHint: false, idempotentHint: false };
+    }
+}
+// AIDEV-NOTE: Normalize category names to URL-safe slugs (lowercase, underscores, no accents)
+// AIDEV-NOTE: Category slug map — Portuguese category names to English slugs.
+// Used for --categories filter matching. Slugs match the tool ID prefix pattern.
+const CATEGORY_SLUG_MAP = {
+    'conta': 'account',
+    'respostas rapidas': 'canned_responses',
+    'contatos': 'contacts',
+    'conversas': 'conversations',
+    'caixas de entrada': 'inboxes',
+    'mensagens': 'messages',
+    'times': 'teams',
+    'labels': 'labels',
+    'filtros personalizados': 'custom_filters',
+    'macros': 'macros',
+    'busca': 'search',
+    'notificacoes': 'notifications',
+    'anuncios': 'announcements',
+    'empresas': 'companies',
+    'ofertas': 'offers',
+    'upload': 'upload',
+    'agenda / tarefas': 'tasks',
+    'variaveis da conta': 'account_variables',
+    'mensagens agendadas': 'scheduled_messages',
+    'funis': 'funnels',
+    'itens': 'kanban_items',
+    'operacoes em massa': 'kanban_bulk',
+    'agentes (kanban)': 'kanban_agents',
+    'checklist': 'kanban_checklist',
+    'notas': 'kanban_notes',
+    'contatos (cliente)': 'public_contacts',
+    'conversas (cliente)': 'public_conversations',
+    'mensagens (cliente)': 'public_messages',
+    'pesquisa csat': 'public_csat',
+    'sessoes': 'flow_sessions',
+    'tipos de evento': 'booking_event_types',
+    'publica': 'public_booking',
+    'chamadas': 'voip_calls',
+    'flows': 'flows',
+    'assistentes': 'captain_assistants',
+    'base de conhecimento': 'captain_documents',
+    'regras de automacao': 'automation_rules',
+    'roles personalizados': 'custom_roles',
+    'politicas de capacidade': 'capacity_policies',
+    'sla': 'sla',
+    'acesso de suporte': 'support_access',
+    'dashboard apps': 'dashboard_apps',
+    'grupos whatsapp': 'waha_groups',
+    'templates whatsapp': 'whatsapp_templates',
+    'csat template': 'csat_template',
+    'migracao de inbox': 'inbox_migration',
+    'google calendar': 'google_calendar',
+    'politicas de atribuicao': 'assignment_policies',
+    'webhooks': 'webhooks',
+    'integracoes e-commerce': 'ecommerce_webhooks',
+    'meta lead ads': 'meta_lead',
+    'config kanban': 'kanban_config',
+    'kanban v2': 'kanban_v2',
+    'portais': 'portals',
+    'config de notificacao': 'notification_settings',
+    'relatorios': 'reports',
+    'prompts salvos': 'copilot_prompts',
+    'membros de inbox': 'inbox_members',
+    'disponibilidade': 'agent_availability',
+    'csat': 'csat',
+    'atributos personalizados': 'custom_attributes',
+    'agentes': 'agents',
+};
+function slugify(text) {
+    const normalized = text
+        .normalize('NFD')
+        .replace(/[\u0300-\u036f]/g, '')
+        .toLowerCase()
+        .trim();
+    return CATEGORY_SLUG_MAP[normalized] || normalized.replace(/[^a-z0-9]+/g, '_').replace(/^_+|_+$/g, '');
+}
+// AIDEV-NOTE: Map endpoint param type strings to Zod schema types
+function paramTypeToZod(param) {
+    let schema;
+    switch (param.type) {
+        case 'integer':
+            schema = z.number().int();
+            break;
+        case 'number':
+            schema = z.number();
+            break;
+        case 'boolean':
+            schema = z.boolean();
+            break;
+        case 'object':
+            schema = z.record(z.unknown());
+            break;
+        case 'array':
+            schema = z.array(z.unknown());
+            break;
+        case 'file':
+            schema = z
+                .string()
+                .describe('File path or URL — file upload not supported in MCP v1');
+            break;
+        case 'string':
+        default:
+            schema = z.string();
+            break;
+    }
+    // AIDEV-NOTE: Add param description unless already set (file type sets its own)
+    if (param.type !== 'file' && param.description) {
+        schema = schema.describe(param.description);
+    }
+    if (!param.required) {
+        schema = schema.optional();
+    }
+    return schema;
+}
+// AIDEV-NOTE: Build Zod object schema from endpoint params, skipping account_id (auto-injected)
+function buildZodSchema(params) {
+    const shape = {};
+    for (const param of params) {
+        // AIDEV-NOTE: account_id is auto-injected from config, never exposed to MCP client
+        if (param.name === 'account_id') {
+            continue;
+        }
+        shape[param.name] = paramTypeToZod(param);
+    }
+    return z.object(shape);
+}
+// AIDEV-NOTE: Check if endpoint has any file-type params (unsupported in MCP v1)
+function hasFileParam(params) {
+    return params.some((p) => p.type === 'file');
+}
+// AIDEV-NOTE: Register a single API endpoint as an MCP tool
+function registerSingleTool(server, config, client, endpoint) {
+    const schema = buildZodSchema(endpoint.params);
+    const annotations = getToolAnnotations(endpoint.method);
+    const hasFile = hasFileParam(endpoint.params);
+    // AIDEV-NOTE: Prepend file upload warning to description when endpoint needs file params
+    let description = `[${endpoint.method.toUpperCase()}] ${endpoint.description}`;
+    if (hasFile) {
+        description =
+            '⚠️ This endpoint requires file upload which is not yet supported via MCP.\n\n' +
+                description;
+    }
+    server.tool(endpoint.id, description, schema.shape, annotations, async (params) => {
+        try {
+            // AIDEV-NOTE: Block execution if file param was actually provided
+            if (hasFile) {
+                const fileParams = endpoint.params.filter((p) => p.type === 'file');
+                for (const fp of fileParams) {
+                    if (params[fp.name] !== undefined && params[fp.name] !== null) {
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: 'File upload is not supported via MCP. Use the LionChat web interface or direct API calls.',
+                                },
+                            ],
+                            isError: true,
+                        };
+                    }
+                }
+            }
+            const { pathParams, queryParams, bodyParams } = separateParams(params, endpoint.params);
+            const path = substitutePath(endpoint.path, config.accountId, pathParams);
+            const queryStr = buildQueryString(queryParams);
+            const fullPath = queryStr ? `${path}${queryStr}` : path;
+            const result = await client.request({
+                method: endpoint.method,
+                path: fullPath,
+                body: Object.keys(bodyParams).length > 0 ? bodyParams : undefined,
+            });
+            return {
+                content: [{ type: 'text', text: formatResponse(result) }],
+            };
+        }
+        catch (err) {
+            // AIDEV-NOTE: Return actionable error messages from LionChatApiError to the LLM
+            // instead of letting MCP SDK swallow them into generic protocol errors
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: 'text', text: message }],
+                isError: true,
+            };
+        }
+    });
+}
+// AIDEV-NOTE: Meta tool — tests connectivity by calling GET /api/v1/profile
+function registerPingTool(server, config, client) {
+    server.tool('lionchat_ping', 'Test connectivity to the LionChat API. Returns your user profile if the token is valid.', {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async () => {
+        try {
+            const result = await client.request({
+                method: 'GET',
+                path: '/api/v1/profile',
+            });
+            return {
+                content: [{ type: 'text', text: formatResponse(result) }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: 'text', text: message }],
+                isError: true,
+            };
+        }
+    });
+}
+// AIDEV-NOTE: Meta tool — lists all available categories with tool counts (no API call)
+function registerListCategoriesTool(server, allEndpoints) {
+    // AIDEV-NOTE: Pre-compute category counts at registration time (static data)
+    const categoryCounts = new Map();
+    for (const ep of allEndpoints) {
+        const slug = slugify(ep.category);
+        categoryCounts.set(slug, (categoryCounts.get(slug) ?? 0) + 1);
+    }
+    const categoryList = Array.from(categoryCounts.entries())
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([slug, count]) => `${slug}: ${count} tools`)
+        .join('\n');
+    server.tool('lionchat_list_categories', 'List all available API categories and how many tools each has. Use category slugs with the --categories config flag to filter tools.', {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async () => {
+        return {
+            content: [{ type: 'text', text: categoryList }],
+        };
+    });
+}
+// AIDEV-NOTE: Main entry point — reads endpoints.json, filters, and registers all tools + meta tools
+export function registerTools(server, config, client) {
+    // AIDEV-NOTE: Resolve endpoints.json relative to compiled dist/ directory (one level up)
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    const endpointsPath = resolve(__dirname, '..', 'endpoints.json');
+    let endpoints;
+    try {
+        endpoints = JSON.parse(readFileSync(endpointsPath, 'utf-8'));
+    }
+    catch (err) {
+        throw new Error(`Failed to load endpoints.json from ${endpointsPath}. ` +
+            `Reinstall with: npm install @lionchat/mcp-server\n` +
+            `Original error: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    let filtered = endpoints;
+    // AIDEV-NOTE: Filter by category slugs if configured via --categories or env var
+    if (config.categories) {
+        const allowedSlugs = new Set(config.categories.map(slugify));
+        filtered = endpoints.filter((e) => allowedSlugs.has(slugify(e.category)));
+    }
+    // AIDEV-NOTE: Exclude public API endpoints unless explicitly opted in
+    if (!config.includePublicApi) {
+        filtered = filtered.filter((e) => !e.id.startsWith('lionchat_public_'));
+    }
+    // AIDEV-NOTE: Register each filtered endpoint as an MCP tool
+    for (const endpoint of filtered) {
+        registerSingleTool(server, config, client, endpoint);
+    }
+    // AIDEV-NOTE: Always register meta tools regardless of category filters
+    registerPingTool(server, config, client);
+    registerListCategoriesTool(server, endpoints);
+    return filtered.length + 2; // +2 for ping and list_categories
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,12 @@
+export interface SeparatedParams {
+    pathParams: Record<string, unknown>;
+    queryParams: Record<string, string>;
+    bodyParams: Record<string, unknown>;
+}
+export declare function substitutePath(pathTemplate: string, accountId: string, params: Record<string, unknown>): string;
+export declare function buildQueryString(params: Record<string, unknown>): string;
+export declare function formatResponse(data: unknown): string;
+export declare function separateParams(input: Record<string, unknown>, paramDefs: Array<{
+    name: string;
+    location: string;
+}>): SeparatedParams;

package/dist/utils.js

@@ -0,0 +1,80 @@
+// AIDEV-NOTE: Utility module for LionChat MCP server
+// Path substitution, query string building, param separation, and response formatting
+// AIDEV-NOTE: Replace {account_id} and other {param} placeholders in URL path templates
+export function substitutePath(pathTemplate, accountId, params) {
+    let result = pathTemplate.replace('{account_id}', accountId);
+    for (const [key, value] of Object.entries(params)) {
+        result = result.replace(`{${key}}`, String(value));
+    }
+    // AIDEV-NOTE: Catch any unsubstituted placeholders — caller forgot a required param
+    const missing = result.match(/\{(\w+)\}/);
+    if (missing) {
+        throw new Error(`Missing required path parameter: ${missing[0]}`);
+    }
+    return result;
+}
+// AIDEV-NOTE: Convert params object to URL query string, skipping nulls and handling arrays
+export function buildQueryString(params) {
+    const parts = [];
+    for (const [key, value] of Object.entries(params)) {
+        if (value === null || value === undefined) {
+            continue;
+        }
+        if (Array.isArray(value)) {
+            // AIDEV-NOTE: Arrays expand to repeated keys: key=val1&key=val2
+            for (const item of value) {
+                if (item !== null && item !== undefined) {
+                    parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(item))}`);
+                }
+            }
+        }
+        else {
+            parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
+        }
+    }
+    return parts.length > 0 ? `?${parts.join('&')}` : '';
+}
+// AIDEV-NOTE: Format API response data for MCP client consumption
+// Truncates at 50k chars to avoid overwhelming the LLM context
+const MAX_RESPONSE_LENGTH = 50000;
+export function formatResponse(data) {
+    const text = typeof data === 'string' ? data : JSON.stringify(data, null, 2);
+    if (text.length > MAX_RESPONSE_LENGTH) {
+        return (text.slice(0, MAX_RESPONSE_LENGTH) +
+            '\n\n[Response truncated at 50,000 characters. Use pagination parameters (page, limit) to fetch smaller result sets.]');
+    }
+    return text;
+}
+// AIDEV-NOTE: Route each input param to path/query/body based on endpoint parameter definitions
+export function separateParams(input, paramDefs) {
+    const pathParams = {};
+    const queryParams = {};
+    const bodyParams = {};
+    // AIDEV-NOTE: Build a lookup map for O(1) location resolution per param
+    const locationMap = new Map();
+    for (const def of paramDefs) {
+        locationMap.set(def.name, def.location);
+    }
+    for (const [key, value] of Object.entries(input)) {
+        const location = locationMap.get(key);
+        switch (location) {
+            case 'path':
+                pathParams[key] = value;
+                break;
+            case 'query':
+                if (value !== null && value !== undefined) {
+                    queryParams[key] = String(value);
+                }
+                break;
+            case 'body':
+                bodyParams[key] = value;
+                break;
+            default:
+                // AIDEV-NOTE: Params not in definitions go to body (catch-all for nested/extra fields)
+                bodyParams[key] = value;
+                break;
+        }
+    }
+    return { pathParams, queryParams, bodyParams };
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,sFAAsF;AAStF,wFAAwF;AACxF,MAAM,UAAU,cAAc,CAC5B,YAAoB,EACpB,SAAiB,EACjB,MAA+B;IAE/B,IAAI,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IAE7D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,GAAG,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,oFAAoF;IACpF,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC1C,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,oCAAoC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,gBAAgB,CAAC,MAA+B;IAC9D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC1C,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,gEAAgE;YAChE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;oBACxC,KAAK,CAAC,IAAI,CACR,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CACjE,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CACR,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAClE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACvD,CAAC;AAED,kEAAkE;AAClE,+DAA+D;AAC/D,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAElC,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,MAAM,IAAI,GACR,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAElE,IAAI,IAAI,CAAC,MAAM,GAAG,mBAAmB,EAAE,CAAC;QACtC,OAAO,CACL,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC;YAClC,sHAAsH,CACvH,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,cAAc,CAC5B,KAA8B,EAC9B,SAAoD;IAEpD,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,MAAM,UAAU,GAA4B,EAAE,CAAC;IAE/C,wEAAwE;IACxE,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEtC,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,MAAM;gBACT,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBACxB,MAAM;YACR,KAAK,OAAO;gBACV,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBAC1C,WAAW,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;gBACnC,CAAC;gBACD,MAAM;YACR,KAAK,MAAM;gBACT,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBACxB,MAAM;YACR;gBACE,uFAAuF;gBACvF,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBACxB,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AACjD,CAAC"}