@servicialo/mcp-server 0.1.0

package/README.md

@@ -0,0 +1,86 @@
+# @servicialo/mcp-server
+
+MCP server for the [Servicialo](https://servicialo.com) protocol. Connects AI agents to professional services via the [Coordinalo](https://coordinalo.com) REST API.
+
+## Quick Start
+
+```bash
+npx -y @servicialo/mcp-server
+```
+
+### Claude Desktop Configuration
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "servicialo": {
+      "command": "npx",
+      "args": ["-y", "@servicialo/mcp-server"],
+      "env": {
+        "SERVICIALO_API_KEY": "your_api_key",
+        "SERVICIALO_ORG_ID": "your_org_id"
+      }
+    }
+  }
+}
+```
+
+## Environment Variables
+
+| Variable | Required | Description |
+|---|---|---|
+| `SERVICIALO_API_KEY` | Yes | Bearer token for the Coordinalo API |
+| `SERVICIALO_ORG_ID` | Yes | Organization slug (e.g., `mamapro`) |
+| `SERVICIALO_BASE_URL` | No | API base URL (default: `https://coordinalo.com`) |
+
+## Available Tools (11)
+
+### Scheduling (4)
+
+| Tool | Description |
+|---|---|
+| `scheduling.check_availability` | Check available slots for a provider/service in a date range |
+| `scheduling.book` | Book a new session |
+| `scheduling.reschedule` | Reschedule an existing session |
+| `scheduling.cancel` | Cancel a session |
+
+### Clients (3)
+
+| Tool | Description |
+|---|---|
+| `clients.list` | List clients with search and pagination |
+| `clients.get` | Get client details with stats |
+| `clients.create` | Create a new client |
+
+### Payments (3)
+
+| Tool | Description |
+|---|---|
+| `payments.get_balance` | Get client balance (available sessions, pending amount) |
+| `payments.charge` | Create a sale/charge for a service |
+| `payments.record` | Record a payment received against a sale |
+
+### Notifications (1)
+
+| Tool | Description |
+|---|---|
+| `notifications.send` | Send a notification to a client (reminder, confirmation, etc.) |
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Watch mode
+npm run dev
+```
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,20 @@
+/**
+ * HTTP client for Coordinalo REST API.
+ * Wraps native fetch with auth headers and base URL.
+ */
+export interface ClientConfig {
+    baseUrl: string;
+    apiKey: string;
+    orgId: string;
+}
+export declare class CoordinaloClient {
+    private baseUrl;
+    private apiKey;
+    private orgId;
+    constructor(config: ClientConfig);
+    private headers;
+    get(path: string, params?: Record<string, string | number | undefined>): Promise<unknown>;
+    post(path: string, body?: unknown): Promise<unknown>;
+    put(path: string, body?: unknown): Promise<unknown>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;gBAEV,MAAM,EAAE,YAAY;IAMhC,OAAO,CAAC,OAAO;IAQT,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAuBzF,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAepD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;CAc1D"}

package/dist/client.js

@@ -0,0 +1,65 @@
+/**
+ * HTTP client for Coordinalo REST API.
+ * Wraps native fetch with auth headers and base URL.
+ */
+export class CoordinaloClient {
+    baseUrl;
+    apiKey;
+    orgId;
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/+$/, '');
+        this.apiKey = config.apiKey;
+        this.orgId = config.orgId;
+    }
+    headers() {
+        return {
+            'Authorization': `Bearer ${this.apiKey}`,
+            'Content-Type': 'application/json',
+            'X-Org-Id': this.orgId,
+        };
+    }
+    async get(path, params) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined) {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        const res = await fetch(url.toString(), {
+            method: 'GET',
+            headers: this.headers(),
+        });
+        if (!res.ok) {
+            const body = await res.text();
+            throw new Error(`GET ${path} failed (${res.status}): ${body}`);
+        }
+        return res.json();
+    }
+    async post(path, body) {
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method: 'POST',
+            headers: this.headers(),
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`POST ${path} failed (${res.status}): ${text}`);
+        }
+        return res.json();
+    }
+    async put(path, body) {
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method: 'PUT',
+            headers: this.headers(),
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`PUT ${path} failed (${res.status}): ${text}`);
+        }
+        return res.json();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CoordinaloClient } from './client.js';
+import { schedulingTools } from './tools/scheduling.js';
+import { clientsTools } from './tools/clients.js';
+import { paymentsTools } from './tools/payments.js';
+import { notificationsTools } from './tools/notifications.js';
+// --- Validate env vars ---
+const API_KEY = process.env.SERVICIALO_API_KEY;
+const ORG_ID = process.env.SERVICIALO_ORG_ID;
+const BASE_URL = process.env.SERVICIALO_BASE_URL || 'https://coordinalo.com';
+if (!API_KEY) {
+    console.error('Error: SERVICIALO_API_KEY is required. Set it as an environment variable.');
+    process.exit(1);
+}
+if (!ORG_ID) {
+    console.error('Error: SERVICIALO_ORG_ID is required. Set it as an environment variable.');
+    process.exit(1);
+}
+// --- Init client ---
+const apiClient = new CoordinaloClient({
+    baseUrl: BASE_URL,
+    apiKey: API_KEY,
+    orgId: ORG_ID,
+});
+// --- Init MCP server ---
+const server = new McpServer({
+    name: 'servicialo',
+    version: '0.1.0',
+});
+const allTools = {
+    ...schedulingTools,
+    ...clientsTools,
+    ...paymentsTools,
+    ...notificationsTools,
+};
+for (const [name, tool] of Object.entries(allTools)) {
+    server.tool(name, tool.description, tool.schema.shape, async (args) => {
+        try {
+            const result = await tool.handler(apiClient, args);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+// --- Connect via stdio ---
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# 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,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG9D,4BAA4B;AAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;AAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;AAC7C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,wBAAwB,CAAC;AAE7E,IAAI,CAAC,OAAO,EAAE,CAAC;IACb,OAAO,CAAC,KAAK,CAAC,2EAA2E,CAAC,CAAC;IAC3F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,CAAC,MAAM,EAAE,CAAC;IACZ,OAAO,CAAC,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAC1F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,sBAAsB;AACtB,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC;IACrC,OAAO,EAAE,QAAQ;IACjB,MAAM,EAAE,OAAO;IACf,KAAK,EAAE,MAAM;CACd,CAAC,CAAC;AAEH,0BAA0B;AAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAUH,MAAM,QAAQ,GAA4B;IACxC,GAAG,eAAqD;IACxD,GAAG,YAAkD;IACrD,GAAG,aAAmD;IACtD,GAAG,kBAAwD;CAC5D,CAAC;AAEF,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;IACpD,MAAM,CAAC,IAAI,CACT,IAAI,EACJ,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,MAAM,CAAC,KAAK,EACjB,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAA+B,CAAC,CAAC;YAC9E,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtC;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,UAAU,OAAO,EAAE;qBAC1B;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED,4BAA4B;AAC5B,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/clients.d.ts

@@ -0,0 +1,138 @@
+import { z } from 'zod';
+import type { CoordinaloClient } from '../client.js';
+declare const ActorSchema: z.ZodObject<{
+    type: z.ZodEnum<["client", "provider", "organization", "agent"]>;
+    id: z.ZodString;
+    on_behalf_of: z.ZodOptional<z.ZodObject<{
+        type: z.ZodString;
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        id: string;
+    }, {
+        type: string;
+        id: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    type: "client" | "provider" | "organization" | "agent";
+    id: string;
+    on_behalf_of?: {
+        type: string;
+        id: string;
+    } | undefined;
+}, {
+    type: "client" | "provider" | "organization" | "agent";
+    id: string;
+    on_behalf_of?: {
+        type: string;
+        id: string;
+    } | undefined;
+}>;
+export declare const clientsTools: {
+    'clients.list': {
+        description: string;
+        schema: z.ZodObject<{
+            search: z.ZodOptional<z.ZodString>;
+            limit: z.ZodDefault<z.ZodNumber>;
+            page: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            limit: number;
+            page: number;
+            search?: string | undefined;
+        }, {
+            search?: string | undefined;
+            limit?: number | undefined;
+            page?: number | undefined;
+        }>;
+        handler: (client: CoordinaloClient, args: {
+            search?: string;
+            limit?: number;
+            page?: number;
+        }) => Promise<unknown>;
+    };
+    'clients.get': {
+        description: string;
+        schema: z.ZodObject<{
+            client_id: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            client_id: string;
+        }, {
+            client_id: string;
+        }>;
+        handler: (client: CoordinaloClient, args: {
+            client_id: string;
+        }) => Promise<unknown>;
+    };
+    'clients.create': {
+        description: string;
+        schema: z.ZodObject<{
+            name: z.ZodString;
+            last_name: z.ZodString;
+            email: z.ZodOptional<z.ZodString>;
+            phone: z.ZodOptional<z.ZodString>;
+            actor: z.ZodObject<{
+                type: z.ZodEnum<["client", "provider", "organization", "agent"]>;
+                id: z.ZodString;
+                on_behalf_of: z.ZodOptional<z.ZodObject<{
+                    type: z.ZodString;
+                    id: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    type: string;
+                    id: string;
+                }, {
+                    type: string;
+                    id: string;
+                }>>;
+            }, "strip", z.ZodTypeAny, {
+                type: "client" | "provider" | "organization" | "agent";
+                id: string;
+                on_behalf_of?: {
+                    type: string;
+                    id: string;
+                } | undefined;
+            }, {
+                type: "client" | "provider" | "organization" | "agent";
+                id: string;
+                on_behalf_of?: {
+                    type: string;
+                    id: string;
+                } | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            actor: {
+                type: "client" | "provider" | "organization" | "agent";
+                id: string;
+                on_behalf_of?: {
+                    type: string;
+                    id: string;
+                } | undefined;
+            };
+            name: string;
+            last_name: string;
+            email?: string | undefined;
+            phone?: string | undefined;
+        }, {
+            actor: {
+                type: "client" | "provider" | "organization" | "agent";
+                id: string;
+                on_behalf_of?: {
+                    type: string;
+                    id: string;
+                } | undefined;
+            };
+            name: string;
+            last_name: string;
+            email?: string | undefined;
+            phone?: string | undefined;
+        }>;
+        handler: (client: CoordinaloClient, args: {
+            name: string;
+            last_name: string;
+            email?: string;
+            phone?: string;
+            actor: z.infer<typeof ActorSchema>;
+        }) => Promise<unknown>;
+    };
+};
+export {};
+//# sourceMappingURL=clients.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clients.d.ts","sourceRoot":"","sources":["../../src/tools/clients.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOf,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;0BAQG,gBAAgB,QAAQ;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;0BAe1E,gBAAgB,QAAQ;YAAE,SAAS,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAe7C,gBAAgB,QAAQ;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;SAAE;;CAW1J,CAAC"}

package/dist/tools/clients.js

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+const ActorSchema = z.object({
+    type: z.enum(['client', 'provider', 'organization', 'agent']),
+    id: z.string(),
+    on_behalf_of: z.object({
+        type: z.string(),
+        id: z.string(),
+    }).optional(),
+});
+export const clientsTools = {
+    'clients.list': {
+        description: 'Lista los clientes de la organización con búsqueda y paginación',
+        schema: z.object({
+            search: z.string().optional().describe('Texto para buscar por nombre, email o teléfono'),
+            limit: z.number().default(20).describe('Cantidad de resultados por página'),
+            page: z.number().default(1).describe('Número de página'),
+        }),
+        handler: async (client, args) => {
+            const result = await client.get('/api/v1/clients', {
+                search: args.search,
+                limit: args.limit ?? 20,
+                page: args.page ?? 1,
+            });
+            return result;
+        },
+    },
+    'clients.get': {
+        description: 'Obtiene el detalle de un cliente incluyendo estadísticas (sesiones totales, monto gastado, última sesión)',
+        schema: z.object({
+            client_id: z.string().describe('ID del cliente'),
+        }),
+        handler: async (client, args) => {
+            const result = await client.get(`/api/v1/clients/${args.client_id}`);
+            return result;
+        },
+    },
+    'clients.create': {
+        description: 'Crea un nuevo cliente en la organización',
+        schema: z.object({
+            name: z.string().describe('Nombre del cliente'),
+            last_name: z.string().describe('Apellido del cliente'),
+            email: z.string().email().optional().describe('Email del cliente'),
+            phone: z.string().optional().describe('Teléfono del cliente'),
+            actor: ActorSchema.describe('Quién realiza la acción'),
+        }),
+        handler: async (client, args) => {
+            const result = await client.post('/api/v1/clients', {
+                name: args.name,
+                lastName: args.last_name,
+                email: args.email,
+                phone: args.phone,
+                actor: args.actor,
+            });
+            return result;
+        },
+    },
+};
+//# sourceMappingURL=clients.js.map

package/dist/tools/clients.js.map

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

package/dist/tools/notifications.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import type { CoordinaloClient } from '../client.js';
+export declare const notificationsTools: {
+    'notifications.send': {
+        description: string;
+        schema: z.ZodObject<{
+            client_id: z.ZodString;
+            type: z.ZodEnum<["reminder", "confirmation", "cancellation", "custom"]>;
+            session_id: z.ZodOptional<z.ZodString>;
+            message: z.ZodOptional<z.ZodString>;
+            channel: z.ZodOptional<z.ZodEnum<["whatsapp", "email", "sms"]>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "custom" | "reminder" | "confirmation" | "cancellation";
+            client_id: string;
+            message?: string | undefined;
+            session_id?: string | undefined;
+            channel?: "email" | "whatsapp" | "sms" | undefined;
+        }, {
+            type: "custom" | "reminder" | "confirmation" | "cancellation";
+            client_id: string;
+            message?: string | undefined;
+            session_id?: string | undefined;
+            channel?: "email" | "whatsapp" | "sms" | undefined;
+        }>;
+        handler: (client: CoordinaloClient, args: {
+            client_id: string;
+            type: string;
+            session_id?: string;
+            message?: string;
+            channel?: string;
+        }) => Promise<unknown>;
+    };
+};
+//# sourceMappingURL=notifications.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../src/tools/notifications.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;0BAUH,gBAAgB,QAAQ;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE;;CAW/I,CAAC"}

package/dist/tools/notifications.js

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+export const notificationsTools = {
+    'notifications.send': {
+        description: 'Envía una notificación (recordatorio, confirmación, etc.) a un cliente por el canal configurado',
+        schema: z.object({
+            client_id: z.string().describe('ID del cliente destinatario'),
+            type: z.enum(['reminder', 'confirmation', 'cancellation', 'custom']).describe('Tipo de notificación'),
+            session_id: z.string().optional().describe('ID de la sesión relacionada (si aplica)'),
+            message: z.string().optional().describe('Mensaje personalizado (para type=custom)'),
+            channel: z.enum(['whatsapp', 'email', 'sms']).optional().describe('Canal de envío (default: el preferido del cliente)'),
+        }),
+        handler: async (client, args) => {
+            const result = await client.post('/api/v1/notifications', {
+                clientId: args.client_id,
+                type: args.type,
+                sessionId: args.session_id,
+                message: args.message,
+                channel: args.channel,
+            });
+            return result;
+        },
+    },
+};
+//# sourceMappingURL=notifications.js.map

package/dist/tools/notifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.js","sourceRoot":"","sources":["../../src/tools/notifications.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,oBAAoB,EAAE;QACpB,WAAW,EAAE,iGAAiG;QAC9G,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YACf,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;YAC7D,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YACrG,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;YACrF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;YACnF,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;SACxH,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,MAAwB,EAAE,IAAkG,EAAE,EAAE;YAC9I,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE;gBACxD,QAAQ,EAAE,IAAI,CAAC,SAAS;gBACxB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,SAAS,EAAE,IAAI,CAAC,UAAU;gBAC1B,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAChB,CAAC;KACF;CACF,CAAC"}

package/dist/tools/payments.d.ts

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+import type { CoordinaloClient } from '../client.js';
+export declare const paymentsTools: {
+    'payments.get_balance': {
+        description: string;
+        schema: z.ZodObject<{
+            client_id: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            client_id: string;
+        }, {
+            client_id: string;
+        }>;
+        handler: (client: CoordinaloClient, args: {
+            client_id: string;
+        }) => Promise<{
+            client_id: string;
+            sessions_available: {} | null;
+            pending_amount: {} | null;
+            total_sessions: {} | null;
+            total_spent: {} | null;
+        }>;
+    };
+    'payments.charge': {
+        description: string;
+        schema: z.ZodObject<{
+            client_id: z.ZodString;
+            service_id: z.ZodString;
+            provider_id: z.ZodString;
+            amount: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            provider_id: string;
+            service_id: string;
+            client_id: string;
+            amount: number;
+        }, {
+            provider_id: string;
+            service_id: string;
+            client_id: string;
+            amount: number;
+        }>;
+        handler: (client: CoordinaloClient, args: {
+            client_id: string;
+            service_id: string;
+            provider_id: string;
+            amount: number;
+        }) => Promise<unknown>;
+    };
+    'payments.record': {
+        description: string;
+        schema: z.ZodObject<{
+            venta_id: z.ZodString;
+            amount: z.ZodNumber;
+            method: z.ZodEnum<["efectivo", "transferencia", "mercadopago", "tarjeta"]>;
+            reference: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            method: "efectivo" | "transferencia" | "mercadopago" | "tarjeta";
+            amount: number;
+            venta_id: string;
+            reference?: string | undefined;
+        }, {
+            method: "efectivo" | "transferencia" | "mercadopago" | "tarjeta";
+            amount: number;
+            venta_id: string;
+            reference?: string | undefined;
+        }>;
+        handler: (client: CoordinaloClient, args: {
+            venta_id: string;
+            amount: number;
+            method: string;
+            reference?: string;
+        }) => Promise<unknown>;
+    };
+};
+//# sourceMappingURL=payments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payments.d.ts","sourceRoot":"","sources":["../../src/tools/payments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,eAAO,MAAM,aAAa;;;;;;;;;;0BAME,gBAAgB,QAAQ;YAAE,SAAS,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;0BAsB7C,gBAAgB,QAAQ;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;0BAoBtG,gBAAgB,QAAQ;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE;;CAU3H,CAAC"}

package/dist/tools/payments.js

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+export const paymentsTools = {
+    'payments.get_balance': {
+        description: 'Consulta el saldo de un cliente: sesiones disponibles y monto pendiente',
+        schema: z.object({
+            client_id: z.string().describe('ID del cliente'),
+        }),
+        handler: async (client, args) => {
+            const data = await client.get(`/api/v1/clients/${args.client_id}`);
+            const stats = data.stats;
+            const balance = data.balance;
+            return {
+                client_id: args.client_id,
+                sessions_available: balance?.available ?? null,
+                pending_amount: balance?.pending ?? null,
+                total_sessions: stats?.total_sessions ?? null,
+                total_spent: stats?.total_spent ?? null,
+            };
+        },
+    },
+    'payments.charge': {
+        description: 'Crea una venta (cargo) para un cliente por un servicio',
+        schema: z.object({
+            client_id: z.string().describe('ID del cliente'),
+            service_id: z.string().describe('ID del servicio'),
+            provider_id: z.string().describe('ID del proveedor'),
+            amount: z.number().describe('Monto unitario del cargo'),
+        }),
+        handler: async (client, args) => {
+            const result = await client.post('/api/v1/sales', {
+                clientId: args.client_id,
+                serviceId: args.service_id,
+                providerId: args.provider_id,
+                quantity: 1,
+                unitPrice: args.amount,
+            });
+            return result;
+        },
+    },
+    'payments.record': {
+        description: 'Registra un cobro (pago recibido) contra una venta existente',
+        schema: z.object({
+            venta_id: z.string().describe('ID de la venta a la que se aplica el cobro'),
+            amount: z.number().describe('Monto cobrado'),
+            method: z.enum(['efectivo', 'transferencia', 'mercadopago', 'tarjeta']).describe('Método de pago'),
+            reference: z.string().optional().describe('Referencia o número de transacción'),
+        }),
+        handler: async (client, args) => {
+            const result = await client.post('/api/v1/cobros', {
+                ventaId: args.venta_id,
+                amount: args.amount,
+                paymentMethod: args.method,
+                reference: args.reference,
+            });
+            return result;
+        },
+    },
+};
+//# sourceMappingURL=payments.js.map

package/dist/tools/payments.js.map

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

package/dist/tools/scheduling.d.ts

@@ -0,0 +1,267 @@
+import { z } from 'zod';
+import type { CoordinaloClient } from '../client.js';
+declare const ActorSchema: z.ZodObject<{
+    type: z.ZodEnum<["client", "provider", "organization", "agent"]>;
+    id: z.ZodString;
+    on_behalf_of: z.ZodOptional<z.ZodObject<{
+        type: z.ZodString;
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        id: string;
+    }, {
+        type: string;
+        id: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    type: "client" | "provider" | "organization" | "agent";
+    id: string;
+    on_behalf_of?: {
+        type: string;
+        id: string;
+    } | undefined;
+}, {
+    type: "client" | "provider" | "organization" | "agent";
+    id: string;
+    on_behalf_of?: {
+        type: string;
+        id: string;
+    } | undefined;
+}>;
+export declare const schedulingTools: {
+    'scheduling.check_availability': {
+        description: string;
+        schema: z.ZodObject<{
+            provider_id: z.ZodString;
+            service_id: z.ZodString;
+            date_range: z.ZodObject<{
+                from: z.ZodString;
+                to: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                from: string;
+                to: string;
+            }, {
+                from: string;
+                to: string;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            provider_id: string;
+            service_id: string;
+            date_range: {
+                from: string;
+                to: string;
+            };
+        }, {
+            provider_id: string;
+            service_id: string;
+            date_range: {
+                from: string;
+                to: string;
+            };
+        }>;
+        handler: (client: CoordinaloClient, args: {
+            provider_id: string;
+            service_id: string;
+            date_range: {
+                from: string;
+                to: string;
+            };
+        }) => Promise<unknown>;
+    };
+    'scheduling.book': {
+        description: string;
+        schema: z.ZodObject<{
+            service_id: z.ZodString;
+            provider_id: z.ZodString;
+            client_id: z.ZodString;
+            starts_at: z.ZodString;
+            actor: z.ZodObject<{
+                type: z.ZodEnum<["client", "provider", "organization", "agent"]>;
+                id: z.ZodString;
+                on_behalf_of: z.ZodOptional<z.ZodObject<{
+                    type: z.ZodString;
+                    id: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    type: string;
+                    id: string;
+                }, {
+                    type: string;
+                    id: string;
+                }>>;
+            }, "strip", z.ZodTypeAny, {
+                type: "client" | "provider" | "organization" | "agent";
+                id: string;
+                on_behalf_of?: {
+                    type: string;
+                    id: string;
+                } | undefined;
+            }, {
+                type: "client" | "provider" | "organization" | "agent";
+                id: string;
+                on_behalf_of?: {
+                    type: string;
+                    id: string;
+                } | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            provider_id: string;
+            service_id: string;
+            client_id: string;
+            starts_at: string;
+            actor: {
+                type: "client" | "provider" | "organization" | "agent";
+                id: string;
+                on_behalf_of?: {
+                    type: string;
+                    id: string;
+                } | undefined;
+            };
+        }, {
+            provider_id: string;
+            service_id: string;
+            client_id: string;
+            starts_at: string;
+            actor: {
+                type: "client" | "provider" | "organization" | "agent";
+                id: string;
+                on_behalf_of?: {
+                    type: string;
+                    id: string;
+                } | undefined;
+            };
+        }>;
+        handler: (client: CoordinaloClient, args: {
+            service_id: string;
+            provider_id: string;
+            client_id: string;
+            starts_at: string;
+            actor: z.infer<typeof ActorSchema>;
+        }) => Promise<unknown>;
+    };
+    'scheduling.reschedule': {
+        description: string;
+        schema: z.ZodObject<{
+            session_id: z.ZodString;
+            new_datetime: z.ZodString;
+            actor: z.ZodObject<{
+                type: z.ZodEnum<["client", "provider", "organization", "agent"]>;
+                id: z.ZodString;
+                on_behalf_of: z.ZodOptional<z.ZodObject<{
+                    type: z.ZodString;
+                    id: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    type: string;
+                    id: string;
+                }, {
+                    type: string;
+                    id: string;
+                }>>;
+            }, "strip", z.ZodTypeAny, {
+                type: "client" | "provider" | "organization" | "agent";
+                id: string;
+                on_behalf_of?: {
+                    type: string;
+                    id: string;
+                } | undefined;
+            }, {
+                type: "client" | "provider" | "organization" | "agent";
+                id: string;
+                on_behalf_of?: {
+                    type: string;
+                    id: string;
+                } | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            actor: {
+                type: "client" | "provider" | "organization" | "agent";
+                id: string;
+                on_behalf_of?: {
+                    type: string;
+                    id: string;
+                } | undefined;
+            };
+            session_id: string;
+            new_datetime: string;
+        }, {
+            actor: {
+                type: "client" | "provider" | "organization" | "agent";
+                id: string;
+                on_behalf_of?: {
+                    type: string;
+                    id: string;
+                } | undefined;
+            };
+            session_id: string;
+            new_datetime: string;
+        }>;
+        handler: (client: CoordinaloClient, args: {
+            session_id: string;
+            new_datetime: string;
+            actor: z.infer<typeof ActorSchema>;
+        }) => Promise<unknown>;
+    };
+    'scheduling.cancel': {
+        description: string;
+        schema: z.ZodObject<{
+            session_id: z.ZodString;
+            reason: z.ZodOptional<z.ZodString>;
+            actor: z.ZodObject<{
+                type: z.ZodEnum<["client", "provider", "organization", "agent"]>;
+                id: z.ZodString;
+                on_behalf_of: z.ZodOptional<z.ZodObject<{
+                    type: z.ZodString;
+                    id: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    type: string;
+                    id: string;
+                }, {
+                    type: string;
+                    id: string;
+                }>>;
+            }, "strip", z.ZodTypeAny, {
+                type: "client" | "provider" | "organization" | "agent";
+                id: string;
+                on_behalf_of?: {
+                    type: string;
+                    id: string;
+                } | undefined;
+            }, {
+                type: "client" | "provider" | "organization" | "agent";
+                id: string;
+                on_behalf_of?: {
+                    type: string;
+                    id: string;
+                } | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            actor: {
+                type: "client" | "provider" | "organization" | "agent";
+                id: string;
+                on_behalf_of?: {
+                    type: string;
+                    id: string;
+                } | undefined;
+            };
+            session_id: string;
+            reason?: string | undefined;
+        }, {
+            actor: {
+                type: "client" | "provider" | "organization" | "agent";
+                id: string;
+                on_behalf_of?: {
+                    type: string;
+                    id: string;
+                } | undefined;
+            };
+            session_id: string;
+            reason?: string | undefined;
+        }>;
+        handler: (client: CoordinaloClient, args: {
+            session_id: string;
+            reason?: string;
+            actor: z.infer<typeof ActorSchema>;
+        }) => Promise<unknown>;
+    };
+};
+export {};
+//# sourceMappingURL=scheduling.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scheduling.d.ts","sourceRoot":"","sources":["../../src/tools/scheduling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOf,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAWA,gBAAgB,QAAQ;YAAE,WAAW,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,EAAE,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAmB7G,gBAAgB,QAAQ;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAmB7I,gBAAgB,QAAQ;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAgBxG,gBAAgB,QAAQ;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;SAAE;;CAQ9H,CAAC"}

package/dist/tools/scheduling.js

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+const ActorSchema = z.object({
+    type: z.enum(['client', 'provider', 'organization', 'agent']),
+    id: z.string(),
+    on_behalf_of: z.object({
+        type: z.string(),
+        id: z.string(),
+    }).optional(),
+});
+export const schedulingTools = {
+    'scheduling.check_availability': {
+        description: 'Consulta los horarios disponibles de un proveedor para un servicio en un rango de fechas',
+        schema: z.object({
+            provider_id: z.string().describe('ID del proveedor'),
+            service_id: z.string().describe('ID del servicio'),
+            date_range: z.object({
+                from: z.string().describe('Fecha inicio (ISO date, ej: 2025-03-01)'),
+                to: z.string().describe('Fecha fin (ISO date, ej: 2025-03-07)'),
+            }),
+        }),
+        handler: async (client, args) => {
+            const result = await client.get(`/api/v1/providers/${args.provider_id}/slots`, {
+                service_id: args.service_id,
+                from: args.date_range.from,
+                to: args.date_range.to,
+            });
+            return result;
+        },
+    },
+    'scheduling.book': {
+        description: 'Agenda una nueva sesión para un cliente con un proveedor',
+        schema: z.object({
+            service_id: z.string().describe('ID del servicio'),
+            provider_id: z.string().describe('ID del proveedor'),
+            client_id: z.string().describe('ID del cliente'),
+            starts_at: z.string().describe('Fecha y hora de inicio (ISO datetime)'),
+            actor: ActorSchema.describe('Quién realiza la acción'),
+        }),
+        handler: async (client, args) => {
+            const result = await client.post('/api/v1/sessions', {
+                serviceId: args.service_id,
+                providerId: args.provider_id,
+                clientId: args.client_id,
+                startTime: args.starts_at,
+                actor: args.actor,
+            });
+            return result;
+        },
+    },
+    'scheduling.reschedule': {
+        description: 'Reagenda una sesión existente a una nueva fecha/hora',
+        schema: z.object({
+            session_id: z.string().describe('ID de la sesión a reagendar'),
+            new_datetime: z.string().describe('Nueva fecha y hora (ISO datetime)'),
+            actor: ActorSchema.describe('Quién realiza la acción'),
+        }),
+        handler: async (client, args) => {
+            const result = await client.put(`/api/v1/sessions/${args.session_id}`, {
+                startTime: args.new_datetime,
+                actor: args.actor,
+            });
+            return result;
+        },
+    },
+    'scheduling.cancel': {
+        description: 'Cancela una sesión existente',
+        schema: z.object({
+            session_id: z.string().describe('ID de la sesión a cancelar'),
+            reason: z.string().optional().describe('Motivo de la cancelación'),
+            actor: ActorSchema.describe('Quién realiza la acción'),
+        }),
+        handler: async (client, args) => {
+            const result = await client.post(`/api/v1/sessions/${args.session_id}/cancel`, {
+                reason: args.reason,
+                actor: args.actor,
+            });
+            return result;
+        },
+    },
+};
+//# sourceMappingURL=scheduling.js.map

package/dist/tools/scheduling.js.map

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

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@servicialo/mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for the Servicialo protocol — connects AI agents to professional services via Coordinalo API",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "servicialo-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.4",
+    "typescript": "^5.7.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "servicialo",
+    "coordinalo",
+    "ai-agents",
+    "professional-services",
+    "model-context-protocol"
+  ]
+}