@smsmasivos/mcp-server 0.2.3 → 0.3.1

package/README.md

@@ -9,10 +9,10 @@ Conecta tu asistente de IA con SMS Masivos para enviar mensajes, gestionar conta
 
 ## Features
 
-- **Envio de SMS** — individuales o masivos, hasta 500 numeros por llamada
-- **Campanas** — lista tus campanas y consulta estadisticas de entrega
-- **Agendas y contactos** — gestiona listas de contactos
-- **Verificacion OTP** — envia y valida codigos por SMS, voz o WhatsApp
+- **19 tools** — SMS, campanas, contactos, verificacion OTP, lealtad, monederos y metricas
+- **FAQ integrado** — 5 recursos de ayuda accesibles desde tu asistente
+- **Prompts guiados** — 4 flujos paso a paso para tareas comunes
+- **Telemetria** — metricas de uso por sesion (latencia, errores, sandbox vs produccion)
 - **Sandbox** — prueba sin enviar mensajes reales ni gastar creditos
 - **Compatible** — funciona con Claude, Cursor, Windsurf y cualquier cliente MCP
 
@@ -102,18 +102,78 @@ Si tienes [Bun](https://bun.sh) instalado, reemplaza `npx` por `bunx` en cualqui
 
 ## Tools disponibles
 
+### SMS y campanas
+
 | Tool | Descripcion |
 |------|-------------|
 | `check_balance` | Consulta creditos SMS disponibles |
 | `send_sms` | Envia SMS a uno o varios numeros (max 500) |
 | `list_campaigns` | Lista campanas con filtros por fecha |
 | `get_campaign_stats` | Estadisticas de entrega de una campana |
+
+### Contactos y agendas
+
+| Tool | Descripcion |
+|------|-------------|
 | `list_agendas` | Lista agendas de contactos |
 | `get_contacts` | Obtiene contactos de una agenda |
 | `add_contact` | Agrega contacto a una agenda |
+| `delete_contact` | Elimina un contacto de una agenda |
+
+### Verificacion OTP
+
+| Tool | Descripcion |
+|------|-------------|
 | `verify_phone` | Inicia verificacion OTP (SMS, voz o WhatsApp) |
 | `check_verification` | Verifica codigo OTP |
 
+### Programa de lealtad
+
+| Tool | Descripcion |
+|------|-------------|
+| `list_loyalty_cards` | Lista tarjetas de lealtad de tu cuenta |
+| `add_loyalty_contact` | Agrega contacto a una tarjeta de lealtad |
+| `get_loyalty_contact` | Consulta sellos y canjes de un contacto |
+| `register_loyalty_sale` | Registra venta y agrega sellos |
+
+### Monedero electronico
+
+| Tool | Descripcion |
+|------|-------------|
+| `list_wallets` | Lista monederos de tu cuenta |
+| `add_wallet_contact` | Agrega contacto a un monedero |
+| `get_wallet_contact` | Consulta saldo de un contacto |
+| `update_wallet_balance` | Agrega o resta saldo a un contacto |
+
+### Utilidades
+
+| Tool | Descripcion |
+|------|-------------|
+| `get_metrics` | Metricas de uso de la sesion (latencia, errores, sandbox vs prod) |
+
+## FAQ Resources
+
+El servidor incluye 5 recursos de ayuda accesibles via MCP resources:
+
+| Resource | Descripcion |
+|----------|-------------|
+| `getting-started` | Como obtener tu API key y configurar el server |
+| `common-errors` | Errores frecuentes y como solucionarlos |
+| `limits-and-pricing` | Limites de la API y precios |
+| `sandbox-mode` | Como usar el modo sandbox para pruebas |
+| `tool-examples` | Ejemplos de uso de cada tool |
+
+## Prompts guiados
+
+Flujos paso a paso que tu asistente puede ejecutar:
+
+| Prompt | Descripcion |
+|--------|-------------|
+| `enviar-campana` | Verificar saldo, enviar SMS y consultar estadisticas |
+| `consultar-lealtad` | Listar tarjetas y consultar sellos de clientes |
+| `gestionar-contactos` | Ver agendas, contactos y agregar nuevos |
+| `verificar-numero` | Enviar codigo OTP y validarlo |
+
 ## Ejemplos
 
 Una vez configurado, puedes pedirle a tu asistente:
@@ -124,6 +184,9 @@ Una vez configurado, puedes pedirle a tu asistente:
 - "Como fue la entrega de la campana 12345?"
 - "Verifica el numero 5598765432 por WhatsApp"
 - "Agrega a Juan (5512345678) a mi agenda de recordatorios"
+- "Muestrame mis tarjetas de lealtad"
+- "Cuantos sellos tiene el cliente 5512345678?"
+- "Agrega $50 al monedero del cliente 5598765432"
 
 ## Desarrollo
 

package/dist/api-client.d.ts

@@ -1,6 +1,8 @@
 export interface ApiClientConfig {
     apiKey: string;
     baseUrl?: string;
+    cfAccessClientId?: string;
+    cfAccessClientSecret?: string;
     timeout?: number;
 }
 export type ApiCall = <T>(endpoint: string, params?: Record<string, unknown>) => Promise<T>;

package/dist/api-client.js

@@ -5,21 +5,26 @@ export function createApiClient(config) {
     const baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
     const timeout = config.timeout ?? DEFAULT_TIMEOUT;
     async function apiCall(endpoint, params) {
-        return executeWithRetry(baseUrl, endpoint, config.apiKey, timeout, params);
+        return executeWithRetry(baseUrl, endpoint, config.apiKey, timeout, params, config.cfAccessClientId, config.cfAccessClientSecret);
     }
     return apiCall;
 }
-async function executeWithRetry(baseUrl, endpoint, apiKey, timeout, params, attempt = 1) {
+async function executeWithRetry(baseUrl, endpoint, apiKey, timeout, params, cfAccessClientId, cfAccessClientSecret, attempt = 1) {
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), timeout);
     try {
+        const headers = {
+            "Content-Type": "application/json",
+            apikey: apiKey,
+        };
+        if (cfAccessClientId && cfAccessClientSecret) {
+            headers["CF-Access-Client-Id"] = cfAccessClientId;
+            headers["CF-Access-Client-Secret"] = cfAccessClientSecret;
+        }
         const response = await fetch(`${baseUrl}${endpoint}`, {
             method: "POST",
-            headers: {
-                "Content-Type": "application/json",
-                apikey: apiKey,
-            },
-            body: JSON.stringify(params ?? {}),
+            headers,
+            body: JSON.stringify({ source: "mcp", ...params }),
             signal: controller.signal,
         });
         clearTimeout(timer);
@@ -30,7 +35,7 @@ async function executeWithRetry(baseUrl, endpoint, apiKey, timeout, params, atte
             if (attempt < 2) {
                 const retryAfter = parseInt(response.headers.get("Retry-After") ?? "2", 10);
                 await sleep(retryAfter * 1000);
-                return executeWithRetry(baseUrl, endpoint, apiKey, timeout, params, attempt + 1);
+                return executeWithRetry(baseUrl, endpoint, apiKey, timeout, params, cfAccessClientId, cfAccessClientSecret, attempt + 1);
             }
             throw new RateLimitError();
         }
@@ -53,7 +58,7 @@ async function executeWithRetry(baseUrl, endpoint, apiKey, timeout, params, atte
         }
         if (error instanceof DOMException && error.name === "AbortError") {
             if (attempt < 2) {
-                return executeWithRetry(baseUrl, endpoint, apiKey, timeout, params, attempt + 1);
+                return executeWithRetry(baseUrl, endpoint, apiKey, timeout, params, cfAccessClientId, cfAccessClientSecret, attempt + 1);
             }
             throw new TimeoutError();
         }

package/dist/api-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,SAAS,EACT,cAAc,EACd,YAAY,EACZ,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,MAAM,gBAAgB,GAAG,+BAA+B,CAAC;AACzD,MAAM,eAAe,GAAG,MAAM,CAAC;AAU/B,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,gBAAgB,CAAC;IACnD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,eAAe,CAAC;IAElD,KAAK,UAAU,OAAO,CAAI,QAAgB,EAAE,MAAgC;QAC1E,OAAO,gBAAgB,CAAI,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAChF,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,OAAe,EACf,QAAgB,EAChB,MAAc,EACd,OAAe,EACf,MAAgC,EAChC,UAAkB,CAAC;IAEnB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IAE5D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,GAAG,QAAQ,EAAE,EAAE;YACpD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,MAAM,EAAE,MAAM;aACf;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC;YAClC,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QAEH,YAAY,CAAC,KAAK,CAAC,CAAC;QAEpB,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,MAAM,IAAI,SAAS,EAAE,CAAC;QACxB,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAChB,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC5E,MAAM,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;gBAC/B,OAAO,gBAAgB,CAAI,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;YACtF,CAAC;YACD,MAAM,IAAI,cAAc,EAAE,CAAC;QAC7B,CAAC;QAED,IAAI,IAA6B,CAAC;QAClC,IAAI,CAAC;YACH,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA4B,CAAC;QAC5D,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,YAAY,CAAC,gDAAgD,CAAC,CAAC;QAC3E,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YAC3B,MAAM,eAAe,CAAC,eAAe,CACnC,IAA8E,CAC/E,CAAC;QACJ,CAAC;QAED,OAAO,IAAS,CAAC;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,YAAY,CAAC,KAAK,CAAC,CAAC;QAEpB,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;YACrC,MAAM,KAAK,CAAC;QACd,CAAC;QAED,IAAI,KAAK,YAAY,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACjE,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAChB,OAAO,gBAAgB,CAAI,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;YACtF,CAAC;YACD,MAAM,IAAI,YAAY,EAAE,CAAC;QAC3B,CAAC;QAED,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;YAC/B,MAAM,IAAI,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC;QAED,MAAM,IAAI,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACxC,CAAC;AACH,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}

package/dist/metrics.d.ts

@@ -0,0 +1,22 @@
+export interface MetricsSnapshot {
+    toolCalls: Record<string, number>;
+    errorCounts: Record<string, number>;
+    avgLatency: Record<string, number>;
+    p95Latency: Record<string, number>;
+    sandboxCalls: number;
+    productionCalls: number;
+    uptimeSeconds: number;
+}
+export declare class MetricsCollector {
+    private toolCalls;
+    private errorCounts;
+    private latencies;
+    private sandboxCalls;
+    private productionCalls;
+    private startTime;
+    recordCall(toolName: string, latencyMs: number, isSandbox: boolean): void;
+    recordError(toolName: string, errorType: string): void;
+    getSnapshot(): MetricsSnapshot;
+    reset(): void;
+}
+export declare const metrics: MetricsCollector;

package/dist/metrics.js

@@ -0,0 +1,55 @@
+const MAX_LATENCIES = 1000;
+export class MetricsCollector {
+    toolCalls = new Map();
+    errorCounts = new Map();
+    latencies = new Map();
+    sandboxCalls = 0;
+    productionCalls = 0;
+    startTime = Date.now();
+    recordCall(toolName, latencyMs, isSandbox) {
+        this.toolCalls.set(toolName, (this.toolCalls.get(toolName) ?? 0) + 1);
+        const arr = this.latencies.get(toolName) ?? [];
+        arr.push(latencyMs);
+        if (arr.length > MAX_LATENCIES)
+            arr.shift();
+        this.latencies.set(toolName, arr);
+        if (isSandbox)
+            this.sandboxCalls++;
+        else
+            this.productionCalls++;
+    }
+    recordError(toolName, errorType) {
+        const key = `${toolName}:${errorType}`;
+        this.errorCounts.set(key, (this.errorCounts.get(key) ?? 0) + 1);
+    }
+    getSnapshot() {
+        const avgLatency = {};
+        const p95Latency = {};
+        for (const [tool, arr] of this.latencies) {
+            if (arr.length === 0)
+                continue;
+            avgLatency[tool] = Math.round(arr.reduce((a, b) => a + b, 0) / arr.length);
+            const sorted = [...arr].sort((a, b) => a - b);
+            p95Latency[tool] = sorted[Math.floor(sorted.length * 0.95)] ?? sorted[sorted.length - 1];
+        }
+        return {
+            toolCalls: Object.fromEntries(this.toolCalls),
+            errorCounts: Object.fromEntries(this.errorCounts),
+            avgLatency,
+            p95Latency,
+            sandboxCalls: this.sandboxCalls,
+            productionCalls: this.productionCalls,
+            uptimeSeconds: Math.round((Date.now() - this.startTime) / 1000),
+        };
+    }
+    reset() {
+        this.toolCalls.clear();
+        this.errorCounts.clear();
+        this.latencies.clear();
+        this.sandboxCalls = 0;
+        this.productionCalls = 0;
+        this.startTime = Date.now();
+    }
+}
+export const metrics = new MetricsCollector();
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

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

package/dist/prompts/index.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAllPrompts(server: McpServer): void;

package/dist/prompts/index.js

@@ -0,0 +1,59 @@
+export function registerAllPrompts(server) {
+    server.registerPrompt("enviar-campana", {
+        title: "Enviar campaña SMS",
+        description: "Flujo guiado para enviar una campaña SMS: verificar saldo, enviar mensaje, consultar estadísticas.",
+    }, async () => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: "Quiero enviar una campaña SMS. Guíame paso a paso: primero verifica mi saldo con check_balance, luego ayúdame a redactar y enviar el mensaje con send_sms, y después consulta las estadísticas con get_campaign_stats.",
+                },
+            },
+        ],
+    }));
+    server.registerPrompt("consultar-lealtad", {
+        title: "Consultar programa de lealtad",
+        description: "Flujo guiado para consultar tarjetas de lealtad y datos de contactos.",
+    }, async () => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: "Quiero revisar mi programa de lealtad. Primero lista mis tarjetas con list_loyalty_cards, luego ayúdame a consultar los sellos de un cliente con get_loyalty_contact.",
+                },
+            },
+        ],
+    }));
+    server.registerPrompt("gestionar-contactos", {
+        title: "Gestionar contactos",
+        description: "Flujo guiado para ver agendas, consultar contactos y agregar nuevos.",
+    }, async () => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: "Quiero gestionar mis contactos. Primero muéstrame mis agendas con list_agendas, luego los contactos de una agenda con get_contacts, y ayúdame a agregar nuevos con add_contact si necesito.",
+                },
+            },
+        ],
+    }));
+    server.registerPrompt("verificar-numero", {
+        title: "Verificar número de teléfono",
+        description: "Flujo guiado para enviar un código OTP y verificar un número de teléfono.",
+    }, async () => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: "Quiero verificar un número de teléfono por SMS. Usa verify_phone para enviar el código OTP, y cuando me den el código usa check_verification para validarlo.",
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,MAAM,CAAC,cAAc,CAAC,gBAAgB,EAAE;QACtC,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,oGAAoG;KAClH,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACd,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,wNAAwN;iBAC/N;aACF;SACF;KACF,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,cAAc,CAAC,mBAAmB,EAAE;QACzC,KAAK,EAAE,+BAA+B;QACtC,WAAW,EAAE,uEAAuE;KACrF,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACd,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,uKAAuK;iBAC9K;aACF;SACF;KACF,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,cAAc,CAAC,qBAAqB,EAAE;QAC3C,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,sEAAsE;KACpF,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACd,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,6LAA6L;iBACpM;aACF;SACF;KACF,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,cAAc,CAAC,kBAAkB,EAAE;QACxC,KAAK,EAAE,8BAA8B;QACrC,WAAW,EAAE,2EAA2E;KACzF,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACd,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,8JAA8J;iBACrK;aACF;SACF;KACF,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/resources/faq.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerFaqResources(server: McpServer): void;

package/dist/resources/faq.js

@@ -0,0 +1,173 @@
+const FAQ_ENTRIES = {
+    "getting-started": {
+        title: "Primeros pasos",
+        description: "Cómo obtener tu API key y configurar el MCP server",
+        content: `# Primeros pasos con SMS Masivos MCP
+
+## Obtener tu API key
+
+1. Inicia sesión en [smsmasivos.com.mx](https://smsmasivos.com.mx)
+2. Ve a **Configuración** → **API**
+3. Copia tu API key
+
+## Configurar en Claude Desktop
+
+Agrega esto a tu archivo de configuración de Claude Desktop (\`claude_desktop_config.json\`):
+
+\`\`\`json
+{
+  "mcpServers": {
+    "smsmasivos": {
+      "command": "npx",
+      "args": ["-y", "@smsmasivos/mcp-server"],
+      "env": {
+        "SMSMASIVOS_API_KEY": "tu-api-key-aquí"
+      }
+    }
+  }
+}
+\`\`\`
+
+## Verificar conexión
+
+Pregunta a Claude: "¿Cuántos créditos SMS tengo?" — si responde con tu saldo, todo está configurado.
+`,
+    },
+    "common-errors": {
+        title: "Errores comunes",
+        description: "Soluciones a los errores más frecuentes",
+        content: `# Errores comunes
+
+## AuthError — API key inválida o no proporcionada
+- Verifica que \`SMSMASIVOS_API_KEY\` esté configurada correctamente
+- Asegúrate de que la API key esté activa en tu panel
+
+## RateLimitError — Demasiadas solicitudes
+- La API tiene límites de velocidad por Cloudflare
+- El MCP reintenta automáticamente una vez con el header Retry-After
+- Si persiste, espera unos segundos entre operaciones
+
+## NetworkError — Error de conexión
+- Verifica tu conexión a internet
+- El servidor puede estar en mantenimiento temporal
+- El MCP reintenta automáticamente en caso de timeout
+
+## "Créditos insuficientes"
+- Usa \`check_balance\` para verificar tu saldo
+- Recarga créditos en smsmasivos.com.mx → Créditos
+
+## "Número inválido"
+- Los números deben tener 10 dígitos (sin código de país)
+- No incluyas el prefijo +52
+- Ejemplo correcto: \`5512345678\`
+`,
+    },
+    "limits-and-pricing": {
+        title: "Límites y créditos",
+        description: "Información sobre créditos, límites por request y rate limiting",
+        content: `# Límites y créditos
+
+## Créditos
+- Cada SMS consume **1 crédito**
+- Consulta tu saldo con \`check_balance\`
+- Los envíos en modo sandbox (\`sandbox='1'\`) **no consumen créditos**
+
+## Límites por request
+- **Máximo 500 números** por llamada a \`send_sms\`
+- Para envíos masivos mayores, divide en lotes de 500
+
+## Rate limiting
+- La API está protegida por Cloudflare
+- Límite general: ~60 requests por minuto
+- El MCP maneja reintentos automáticamente
+
+## Verificación OTP
+- Cada verificación consume **1 crédito**
+- Los códigos expiran por defecto en 10 minutos
+`,
+    },
+    "sandbox-mode": {
+        title: "Modo sandbox",
+        description: "Cómo usar el modo sandbox para pruebas sin envío real",
+        content: `# Modo sandbox
+
+El modo sandbox permite probar el flujo completo sin enviar mensajes reales ni consumir créditos.
+
+## Cómo activar
+- En \`send_sms\`: usa \`sandbox='1'\`
+- En \`list_campaigns\`: usa \`sandbox='1'\` para ver campañas de prueba
+- En \`get_campaign_stats\`: usa \`sandbox='1'\` si la campaña fue de sandbox
+
+## Comportamiento
+- El SMS **no se envía** realmente
+- **No se consumen créditos**
+- Se genera un ID de campaña válido
+- Las estadísticas muestran "en proceso" brevemente y luego datos simulados
+
+## Cuándo usar
+- Pruebas de integración
+- Validar flujos antes de envíos reales
+- Desarrollo y debugging
+`,
+    },
+    "tool-examples": {
+        title: "Ejemplos de uso",
+        description: "Ejemplos prácticos de cada tool disponible",
+        content: `# Ejemplos de uso
+
+## Consultar saldo
+> "¿Cuántos créditos tengo?"
+→ Usa \`check_balance\`
+
+## Enviar SMS
+> "Envía 'Hola mundo' al 5512345678"
+→ Usa \`send_sms\` con numbers y message
+
+## SMS programado
+> "Programa un SMS para mañana a las 10am"
+→ Usa \`send_sms\` con el parámetro date
+
+## SMS en sandbox
+> "Envía un mensaje de prueba sin enviar realmente"
+→ Usa \`send_sms\` con sandbox='1'
+
+## Ver campañas
+> "¿Cuáles son mis últimas campañas?"
+→ Usa \`list_campaigns\`
+
+## Estadísticas de campaña
+> "¿Cómo fue la entrega de la campaña 12345?"
+→ Usa \`get_campaign_stats\` con el campaign_id
+
+## Gestionar agendas
+> "¿Qué agendas tengo?"
+→ Usa \`list_agendas\`, luego \`get_contacts\` con el list_key
+
+## Verificación OTP
+> "Verifica el número 5512345678"
+→ Usa \`verify_phone\`, luego \`check_verification\` con el código
+
+## Lealtad
+> "¿Cuántos sellos tiene el cliente 5512345678?"
+→ Usa \`list_loyalty_cards\` para obtener el key, luego \`get_loyalty_contact\`
+
+## Monedero
+> "¿Cuál es el saldo del cliente en mi monedero?"
+→ Usa \`list_wallets\` para obtener el key, luego \`get_wallet_contact\`
+`,
+    },
+};
+export function registerFaqResources(server) {
+    for (const [key, entry] of Object.entries(FAQ_ENTRIES)) {
+        server.registerResource(entry.title, `smsmasivos://faq/${key}`, { description: entry.description, mimeType: "text/markdown" }, () => ({
+            contents: [
+                {
+                    uri: `smsmasivos://faq/${key}`,
+                    text: entry.content,
+                    mimeType: "text/markdown",
+                },
+            ],
+        }));
+    }
+}
+//# sourceMappingURL=faq.js.map

package/dist/resources/faq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faq.js","sourceRoot":"","sources":["../../src/resources/faq.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAA4E;IAC3F,iBAAiB,EAAE;QACjB,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,oDAAoD;QACjE,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BZ;KACE;IACD,eAAe,EAAE;QACf,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,yCAAyC;QACtD,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;CAwBZ;KACE;IACD,oBAAoB,EAAE;QACpB,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,iEAAiE;QAC9E,OAAO,EAAE;;;;;;;;;;;;;;;;;;;CAmBZ;KACE;IACD,cAAc,EAAE;QACd,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,uDAAuD;QACpE,OAAO,EAAE;;;;;;;;;;;;;;;;;;;CAmBZ;KACE;IACD,eAAe,EAAE;QACf,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,4CAA4C;QACzD,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCZ;KACE;CACF,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACvD,MAAM,CAAC,gBAAgB,CACrB,KAAK,CAAC,KAAK,EACX,oBAAoB,GAAG,EAAE,EACzB,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,QAAQ,EAAE,eAAe,EAAE,EAC7D,GAAG,EAAE,CAAC,CAAC;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,oBAAoB,GAAG,EAAE;oBAC9B,IAAI,EAAE,KAAK,CAAC,OAAO;oBACnB,QAAQ,EAAE,eAAe;iBAC1B;aACF;SACF,CAAC,CACH,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/resources/index.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAllResources(server: McpServer): void;

package/dist/resources/index.js

@@ -0,0 +1,5 @@
+import { registerFaqResources } from "./faq.js";
+export function registerAllResources(server) {
+    registerFaqResources(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEhD,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/schemas.d.ts

@@ -83,6 +83,7 @@ export declare const getCampaignStatsInput: z.ZodObject<{
 export declare const verifyPhoneInput: z.ZodObject<{
     phone_number: z.ZodString;
     country_code: z.ZodDefault<z.ZodString>;
+    company: z.ZodString;
     code_type: z.ZodOptional<z.ZodEnum<["numeric", "alphanumeric"]>>;
     expiration_date: z.ZodOptional<z.ZodString>;
     voice: z.ZodOptional<z.ZodEnum<["0", "1"]>>;
@@ -90,12 +91,14 @@ export declare const verifyPhoneInput: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     country_code: string;
     phone_number: string;
+    company: string;
     code_type?: "numeric" | "alphanumeric" | undefined;
     expiration_date?: string | undefined;
     voice?: "0" | "1" | undefined;
     whatsapp?: "0" | "1" | undefined;
 }, {
     phone_number: string;
+    company: string;
     country_code?: string | undefined;
     code_type?: "numeric" | "alphanumeric" | undefined;
     expiration_date?: string | undefined;
@@ -131,3 +134,99 @@ export declare const checkVerificationInput: z.ZodObject<{
     verification_code: string;
     country_code?: string | undefined;
 }>;
+export declare const deleteContactInput: z.ZodObject<{
+    list_key: z.ZodString;
+    number: z.ZodString;
+    email: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    number: string;
+    list_key: string;
+    email?: string | undefined;
+}, {
+    number: string;
+    list_key: string;
+    email?: string | undefined;
+}>;
+export declare const listLoyaltyCardsInput: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const addLoyaltyContactInput: z.ZodObject<{
+    loyalty_key: z.ZodString;
+    phone: z.ZodString;
+    customer_name: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    loyalty_key: string;
+    phone: string;
+    customer_name?: string | undefined;
+}, {
+    loyalty_key: string;
+    phone: string;
+    customer_name?: string | undefined;
+}>;
+export declare const getLoyaltyContactInput: z.ZodObject<{
+    loyalty_key: z.ZodString;
+    phone: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    loyalty_key: string;
+    phone?: string | undefined;
+}, {
+    loyalty_key: string;
+    phone?: string | undefined;
+}>;
+export declare const registerLoyaltySaleInput: z.ZodObject<{
+    loyalty_key: z.ZodString;
+    phone: z.ZodString;
+    stamps_quantity: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    loyalty_key: string;
+    phone: string;
+    stamps_quantity: number;
+}, {
+    loyalty_key: string;
+    phone: string;
+    stamps_quantity: number;
+}>;
+export declare const listWalletsInput: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const addWalletContactInput: z.ZodObject<{
+    wallet_key: z.ZodString;
+    phone: z.ZodString;
+    customer_name: z.ZodString;
+    usertool_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    phone: string;
+    customer_name: string;
+    wallet_key: string;
+    usertool_id: number;
+}, {
+    phone: string;
+    customer_name: string;
+    wallet_key: string;
+    usertool_id: number;
+}>;
+export declare const getWalletContactInput: z.ZodObject<{
+    wallet_key: z.ZodString;
+    phone: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    wallet_key: string;
+    phone?: string | undefined;
+}, {
+    wallet_key: string;
+    phone?: string | undefined;
+}>;
+export declare const updateWalletBalanceInput: z.ZodObject<{
+    wallet_key: z.ZodString;
+    phone: z.ZodString;
+    transaction_type: z.ZodEnum<["1", "2"]>;
+    transaction_amount: z.ZodNumber;
+    usertool_id: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    phone: string;
+    wallet_key: string;
+    usertool_id: number;
+    transaction_type: "2" | "1";
+    transaction_amount: number;
+}, {
+    phone: string;
+    wallet_key: string;
+    usertool_id: number;
+    transaction_type: "2" | "1";
+    transaction_amount: number;
+}>;