@denik.me/mcp 0.1.0

package/README.md

@@ -0,0 +1,43 @@
+# @denik/mcp
+
+Servidor MCP stdio para [Denik Agenda](https://denik.me). Expone tools para operar una org desde un agente (típicamente un bot de WhatsApp de equipo).
+
+## Instalación
+
+```bash
+npm i -g @denik/mcp
+```
+
+## Config (Claude Desktop)
+
+```json
+{
+  "mcpServers": {
+    "denik": {
+      "command": "denik-mcp",
+      "env": {
+        "DENIK_API_KEY": "dk_live_...",
+        "DENIK_BASE_URL": "https://denik.me"
+      }
+    }
+  }
+}
+```
+
+La API key se genera desde `Dashboard → Ajustes → API keys`.
+
+## Tools (Fase 1 — read-only)
+
+| Tool | Descripción |
+|---|---|
+| `get_today_summary` | Resumen del día (citas, ingresos, no-shows) |
+| `list_events` | Listar citas con filtros (rango, status, etc.) |
+| `get_event` | Detalle de una cita |
+| `list_services` | Servicios activos |
+| `get_service_public_url` | Link público de booking para compartir |
+| `find_customer` | Buscar clientes |
+| `get_customer_appointments` | Historial de un cliente |
+| `get_customer_points` | Puntos de lealtad |
+| `get_org_stats` | Stats en rango custom |
+
+Próximas fases: mutaciones (cancel/reschedule/mark_attendance), edición de landing, cupones.

package/dist/client.d.ts

@@ -0,0 +1 @@
+export declare function denikGet<T = unknown>(path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T>;

package/dist/client.js

@@ -0,0 +1,28 @@
+/**
+ * Fetch wrapper contra el backend de Denik.
+ * Lee `DENIK_API_KEY` y `DENIK_BASE_URL` del env.
+ */
+const BASE_URL = process.env.DENIK_BASE_URL ?? "https://denik.me";
+const API_KEY = process.env.DENIK_API_KEY;
+if (!API_KEY) {
+    // No hacer throw aquí — el servidor MCP debe poder arrancar para listar tools.
+    // El error sale al invocar una tool.
+    console.error("[denik-mcp] WARNING: DENIK_API_KEY env var is not set");
+}
+export async function denikGet(path, params = {}) {
+    if (!API_KEY)
+        throw new Error("DENIK_API_KEY env var is required");
+    const url = new URL(`/api/mcp/${path}`, BASE_URL);
+    for (const [k, v] of Object.entries(params)) {
+        if (v !== undefined)
+            url.searchParams.set(k, String(v));
+    }
+    const res = await fetch(url, {
+        headers: { "X-Denik-Api-Key": API_KEY, Accept: "application/json" },
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`Denik API ${res.status}: ${text}`);
+    }
+    return res.json();
+}

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { denikGet } from "./client.js";
+const server = new Server({ name: "denik-mcp", version: "0.1.0" }, { capabilities: { tools: {} } });
+// ==================== Tool definitions ====================
+const tools = [
+    {
+        name: "list_events",
+        description: "Lista citas del negocio. Útil para '¿qué tengo hoy?', '¿qué hay mañana?'. Acepta rango de fechas ISO y filtros.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                from: { type: "string", description: "ISO date inicio (inclusive)" },
+                to: { type: "string", description: "ISO date fin (inclusive)" },
+                status: { type: "string", enum: ["CONFIRMED", "pending", "CANCELLED"] },
+                serviceId: { type: "string" },
+                customerId: { type: "string" },
+                attended: { type: "boolean" },
+                limit: { type: "number", default: 50 },
+            },
+        },
+        handler: async (args) => denikGet("events", { intent: "list", ...args }),
+    },
+    {
+        name: "get_event",
+        description: "Devuelve el detalle de una cita por ID (incluye customer, service, meetingLink).",
+        inputSchema: {
+            type: "object",
+            required: ["eventId"],
+            properties: { eventId: { type: "string" } },
+        },
+        handler: async (args) => denikGet("events", { intent: "get", eventId: args.eventId }),
+    },
+    {
+        name: "list_services",
+        description: "Lista los servicios activos de la org. Úsalo para resolver IDs antes de agendar.",
+        inputSchema: { type: "object", properties: {} },
+        handler: async () => denikGet("services", { intent: "list" }),
+    },
+    {
+        name: "get_service_public_url",
+        description: "Devuelve el link público de booking de un servicio para compartir.",
+        inputSchema: {
+            type: "object",
+            required: ["serviceId"],
+            properties: { serviceId: { type: "string" } },
+        },
+        handler: async (args) => denikGet("services", { intent: "public_url", serviceId: args.serviceId }),
+    },
+    {
+        name: "find_customer",
+        description: "Busca clientes por nombre, email o teléfono. Hasta 20 resultados.",
+        inputSchema: {
+            type: "object",
+            required: ["q"],
+            properties: { q: { type: "string" } },
+        },
+        handler: async (args) => denikGet("customers", { intent: "find", q: args.q }),
+    },
+    {
+        name: "get_customer_appointments",
+        description: "Historial de citas de un cliente (últimas 50, más recientes primero).",
+        inputSchema: {
+            type: "object",
+            required: ["customerId"],
+            properties: { customerId: { type: "string" } },
+        },
+        handler: async (args) => denikGet("customers", { intent: "appointments", customerId: args.customerId }),
+    },
+    {
+        name: "get_customer_points",
+        description: "Puntos de lealtad acumulados de un cliente (cálculo en vivo sobre citas asistidas).",
+        inputSchema: {
+            type: "object",
+            required: ["customerId"],
+            properties: { customerId: { type: "string" } },
+        },
+        handler: async (args) => denikGet("customers", { intent: "points", customerId: args.customerId }),
+    },
+    {
+        name: "get_today_summary",
+        description: "Resumen del día: total de citas, confirmadas, canceladas, no-shows, ingresos. La tool 'estrella' del grupo.",
+        inputSchema: { type: "object", properties: {} },
+        handler: async () => denikGet("org", { intent: "today" }),
+    },
+    {
+        name: "get_org_stats",
+        description: "Estadísticas de la org en un rango custom (from/to ISO).",
+        inputSchema: {
+            type: "object",
+            required: ["from", "to"],
+            properties: {
+                from: { type: "string" },
+                to: { type: "string" },
+            },
+        },
+        handler: async (args) => denikGet("org", { intent: "stats", from: args.from, to: args.to }),
+    },
+];
+// ==================== MCP handlers ====================
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: tools.map((t) => ({
+        name: t.name,
+        description: t.description,
+        inputSchema: t.inputSchema,
+    })),
+}));
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const tool = tools.find((t) => t.name === req.params.name);
+    if (!tool) {
+        return {
+            content: [{ type: "text", text: `Unknown tool: ${req.params.name}` }],
+            isError: true,
+        };
+    }
+    try {
+        const result = await tool.handler(req.params.arguments ?? {});
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+// ==================== Start ====================
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error("[denik-mcp] server ready on stdio");

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@denik.me/mcp",
+  "version": "0.1.0",
+  "description": "Denik Agenda MCP stdio server — tools para operar una org desde un agente (p.ej. bot de WhatsApp).",
+  "type": "module",
+  "bin": {
+    "denik-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["mcp", "denik", "agenda", "whatsapp"],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}