@smsmasivos/mcp-server 0.1.0

package/README.md

@@ -0,0 +1,86 @@
+# @smsmasivos/mcp-server
+
+MCP server para [SMS Masivos](https://www.smsmasivos.com.mx) — plataforma de SMS masivos para Mexico y LATAM.
+
+Permite a Claude, Cursor, Windsurf y cualquier MCP client enviar SMS, consultar creditos, gestionar contactos y verificar numeros de telefono usando lenguaje natural.
+
+## Instalacion
+
+```bash
+npm install -g @smsmasivos/mcp-server
+```
+
+O ejecutar directamente:
+
+```bash
+npx @smsmasivos/mcp-server
+```
+
+## Configuracion
+
+Necesitas una API key de SMS Masivos. Obtenla en tu panel: https://app.smsmasivos.com.mx
+
+### Claude Desktop
+
+Agrega esto a tu configuracion de Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json` en Mac):
+
+```json
+{
+  "mcpServers": {
+    "smsmasivos": {
+      "command": "npx",
+      "args": ["-y", "@smsmasivos/mcp-server"],
+      "env": {
+        "SMSMASIVOS_API_KEY": "tu-api-key-aqui"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+SMSMASIVOS_API_KEY=tu-api-key npx @smsmasivos/mcp-server
+```
+
+### Cursor / Windsurf
+
+Agrega el MCP server en la configuracion de tu editor con los mismos parametros.
+
+## Tools disponibles
+
+| Tool | Descripcion |
+|------|-------------|
+| `check_balance` | Consulta creditos SMS disponibles |
+| `send_sms` | Envia SMS a uno o varios numeros (max 500) |
+| `list_agendas` | Lista tus agendas (listas de contactos) |
+| `get_contacts` | Obtiene contactos de una agenda |
+| `add_contact` | Agrega contacto a una agenda |
+| `get_campaign_stats` | Estadisticas de entrega de una campana |
+| `verify_phone` | Inicia verificacion OTP por SMS/voz/WhatsApp |
+| `check_verification` | Verifica codigo OTP |
+
+## Ejemplos
+
+Una vez configurado, puedes pedirle a Claude:
+
+- "Cuantos creditos me quedan?"
+- "Envia un SMS al 5512345678 con el texto: Tu cita es manana a las 10am"
+- "Muestrame mis agendas de contactos"
+- "Como fue la entrega de mi campana 12345?"
+- "Verifica el numero 5598765432 por SMS"
+
+## Desarrollo
+
+```bash
+git clone https://github.com/SMS-Masivos/mcp-server.git
+cd mcp-server
+npm install
+npm run build
+npm test
+```
+
+## Licencia
+
+MIT

package/dist/api-client.d.ts

@@ -0,0 +1,7 @@
+export interface ApiClientConfig {
+    apiKey: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+export type ApiCall = <T>(endpoint: string, params?: Record<string, unknown>) => Promise<T>;
+export declare function createApiClient(config: ApiClientConfig): ApiCall;

package/dist/api-client.js

@@ -0,0 +1,69 @@
+import { SmsmasivosError, AuthError, RateLimitError, NetworkError, TimeoutError, } from "./errors.js";
+const DEFAULT_BASE_URL = "https://api.smsmasivos.com.mx";
+const DEFAULT_TIMEOUT = 30_000;
+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 apiCall;
+}
+async function executeWithRetry(baseUrl, endpoint, apiKey, timeout, params, attempt = 1) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeout);
+    try {
+        const response = await fetch(`${baseUrl}${endpoint}`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                apikey: apiKey,
+            },
+            body: JSON.stringify(params ?? {}),
+            signal: controller.signal,
+        });
+        clearTimeout(timer);
+        if (response.status === 401) {
+            throw new AuthError();
+        }
+        if (response.status === 429) {
+            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);
+            }
+            throw new RateLimitError();
+        }
+        let body;
+        try {
+            body = (await response.json());
+        }
+        catch {
+            throw new NetworkError("Respuesta inválida de la API (JSON malformado)");
+        }
+        if (body.success === false) {
+            throw SmsmasivosError.fromApiResponse(body);
+        }
+        return body;
+    }
+    catch (error) {
+        clearTimeout(timer);
+        if (error instanceof SmsmasivosError) {
+            throw error;
+        }
+        if (error instanceof DOMException && error.name === "AbortError") {
+            if (attempt < 2) {
+                return executeWithRetry(baseUrl, endpoint, apiKey, timeout, params, attempt + 1);
+            }
+            throw new TimeoutError();
+        }
+        if (error instanceof TypeError) {
+            throw new NetworkError(error.message);
+        }
+        throw new NetworkError(String(error));
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,30 @@
+export declare class SmsmasivosError extends Error {
+    code: string;
+    statusCode: number;
+    constructor(message: string, code: string, statusCode?: number);
+    static fromApiResponse(body: {
+        success: boolean;
+        message?: string;
+        code?: string;
+        status?: number;
+    }): SmsmasivosError;
+}
+export declare class AuthError extends SmsmasivosError {
+    constructor(message?: string);
+}
+export declare class InsufficientCreditsError extends SmsmasivosError {
+    constructor(message?: string);
+}
+export declare class ValidationError extends SmsmasivosError {
+    constructor(message: string, code?: string);
+}
+export declare class RateLimitError extends SmsmasivosError {
+    retryAfter?: number;
+    constructor(retryAfter?: number);
+}
+export declare class NetworkError extends SmsmasivosError {
+    constructor(message?: string);
+}
+export declare class TimeoutError extends NetworkError {
+    constructor(message?: string);
+}

package/dist/errors.js

@@ -0,0 +1,61 @@
+export class SmsmasivosError extends Error {
+    code;
+    statusCode;
+    constructor(message, code, statusCode = 200) {
+        super(message);
+        this.name = "SmsmasivosError";
+        this.code = code;
+        this.statusCode = statusCode;
+    }
+    static fromApiResponse(body) {
+        const message = body.message ?? "Unknown API error";
+        const code = body.code ?? "unknown";
+        if (code === "auth_01" || body.status === 401) {
+            return new AuthError(message);
+        }
+        if (code === "sms_06") {
+            return new InsufficientCreditsError(message);
+        }
+        return new ValidationError(message, code);
+    }
+}
+export class AuthError extends SmsmasivosError {
+    constructor(message = "API key inválida o expirada") {
+        super(message, "auth_01", 401);
+        this.name = "AuthError";
+    }
+}
+export class InsufficientCreditsError extends SmsmasivosError {
+    constructor(message = "Créditos insuficientes") {
+        super(message, "sms_06", 402);
+        this.name = "InsufficientCreditsError";
+    }
+}
+export class ValidationError extends SmsmasivosError {
+    constructor(message, code = "validation") {
+        super(message, code);
+        this.name = "ValidationError";
+    }
+}
+export class RateLimitError extends SmsmasivosError {
+    retryAfter;
+    constructor(retryAfter) {
+        super("Rate limit excedido. Intenta de nuevo en unos segundos.", "rate_limit", 429);
+        this.name = "RateLimitError";
+        this.retryAfter = retryAfter;
+    }
+}
+export class NetworkError extends SmsmasivosError {
+    constructor(message = "Error de conexión con la API") {
+        super(message, "network_error", 0);
+        this.name = "NetworkError";
+    }
+}
+export class TimeoutError extends NetworkError {
+    constructor(message = "La solicitud excedió el tiempo de espera") {
+        super(message);
+        this.name = "TimeoutError";
+        this.code = "timeout";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,IAAI,CAAS;IACb,UAAU,CAAS;IAEnB,YAAY,OAAe,EAAE,IAAY,EAAE,aAAqB,GAAG;QACjE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,eAAe,CAAC,IAKtB;QACC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,mBAAmB,CAAC;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC;QAEpC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC9C,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO,IAAI,wBAAwB,CAAC,OAAO,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,IAAI,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;CACF;AAED,MAAM,OAAO,SAAU,SAAQ,eAAe;IAC5C,YAAY,UAAkB,6BAA6B;QACzD,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,eAAe;IAC3D,YAAY,UAAkB,wBAAwB;QACpD,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,eAAe;IAClD,YAAY,OAAe,EAAE,OAAe,YAAY;QACtD,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,eAAe;IACjD,UAAU,CAAU;IAEpB,YAAY,UAAmB;QAC7B,KAAK,CAAC,yDAAyD,EAAE,YAAY,EAAE,GAAG,CAAC,CAAC;QACpF,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,eAAe;IAC/C,YAAY,UAAkB,8BAA8B;QAC1D,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,YAAY;IAC5C,YAAY,UAAkB,0CAA0C;QACtE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;IACxB,CAAC;CACF"}

package/dist/schemas.d.ts

@@ -0,0 +1,117 @@
+import { z } from "zod";
+export declare const checkBalanceInput: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const sendSmsInput: z.ZodObject<{
+    numbers: z.ZodEffects<z.ZodString, string, string>;
+    message: z.ZodString;
+    country_code: z.ZodDefault<z.ZodString>;
+    sandbox: z.ZodOptional<z.ZodEnum<["0", "1"]>>;
+    sender: z.ZodOptional<z.ZodString>;
+    date: z.ZodOptional<z.ZodString>;
+    shorten_url: z.ZodOptional<z.ZodEnum<["0", "1"]>>;
+    flash: z.ZodOptional<z.ZodEnum<["0", "1"]>>;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    numbers: string;
+    country_code: string;
+    date?: string | undefined;
+    sandbox?: "0" | "1" | undefined;
+    sender?: string | undefined;
+    shorten_url?: "0" | "1" | undefined;
+    flash?: "0" | "1" | undefined;
+}, {
+    message: string;
+    numbers: string;
+    date?: string | undefined;
+    country_code?: string | undefined;
+    sandbox?: "0" | "1" | undefined;
+    sender?: string | undefined;
+    shorten_url?: "0" | "1" | undefined;
+    flash?: "0" | "1" | undefined;
+}>;
+export declare const listAgendasInput: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const getContactsInput: z.ZodObject<{
+    list_key: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    list_key: string;
+}, {
+    list_key: string;
+}>;
+export declare const addContactInput: z.ZodObject<{
+    list_key: z.ZodString;
+    number: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    country_code: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    custom_field_1: z.ZodOptional<z.ZodString>;
+    custom_field_2: z.ZodOptional<z.ZodString>;
+    custom_field_3: z.ZodOptional<z.ZodString>;
+    custom_field_4: z.ZodOptional<z.ZodString>;
+    birthday_date: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    number: string;
+    country_code: string;
+    list_key: string;
+    name?: string | undefined;
+    email?: string | undefined;
+    custom_field_1?: string | undefined;
+    custom_field_2?: string | undefined;
+    custom_field_3?: string | undefined;
+    custom_field_4?: string | undefined;
+    birthday_date?: string | undefined;
+}, {
+    number: string;
+    list_key: string;
+    country_code?: string | undefined;
+    name?: string | undefined;
+    email?: string | undefined;
+    custom_field_1?: string | undefined;
+    custom_field_2?: string | undefined;
+    custom_field_3?: string | undefined;
+    custom_field_4?: string | undefined;
+    birthday_date?: string | undefined;
+}>;
+export declare const getCampaignStatsInput: z.ZodObject<{
+    campaign_id: z.ZodString;
+    sandbox: z.ZodOptional<z.ZodEnum<["0", "1"]>>;
+}, "strip", z.ZodTypeAny, {
+    campaign_id: string;
+    sandbox?: "0" | "1" | undefined;
+}, {
+    campaign_id: string;
+    sandbox?: "0" | "1" | undefined;
+}>;
+export declare const verifyPhoneInput: z.ZodObject<{
+    phone_number: z.ZodString;
+    country_code: z.ZodDefault<z.ZodString>;
+    code_type: z.ZodOptional<z.ZodEnum<["numeric", "alphanumeric"]>>;
+    expiration_date: z.ZodOptional<z.ZodString>;
+    voice: z.ZodOptional<z.ZodEnum<["0", "1"]>>;
+    whatsapp: z.ZodOptional<z.ZodEnum<["0", "1"]>>;
+}, "strip", z.ZodTypeAny, {
+    country_code: string;
+    phone_number: string;
+    code_type?: "numeric" | "alphanumeric" | undefined;
+    expiration_date?: string | undefined;
+    voice?: "0" | "1" | undefined;
+    whatsapp?: "0" | "1" | undefined;
+}, {
+    phone_number: string;
+    country_code?: string | undefined;
+    code_type?: "numeric" | "alphanumeric" | undefined;
+    expiration_date?: string | undefined;
+    voice?: "0" | "1" | undefined;
+    whatsapp?: "0" | "1" | undefined;
+}>;
+export declare const checkVerificationInput: z.ZodObject<{
+    phone_number: z.ZodString;
+    country_code: z.ZodDefault<z.ZodString>;
+    verification_code: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    country_code: string;
+    phone_number: string;
+    verification_code: string;
+}, {
+    phone_number: string;
+    verification_code: string;
+    country_code?: string | undefined;
+}>;

package/dist/schemas.js

@@ -0,0 +1,69 @@
+import { z } from "zod";
+export const checkBalanceInput = z.object({});
+export const sendSmsInput = z.object({
+    numbers: z
+        .string()
+        .describe("Números de teléfono separados por coma, sin código de país (ej: '5512345678,5598765432'). Máximo 500.")
+        .transform((val) => val.replace(/\+/g, "")),
+    message: z.string().min(1).describe("Texto del mensaje SMS"),
+    country_code: z
+        .string()
+        .default("52")
+        .describe("Código de país (ej: '52' para México, '1' para USA)"),
+    sandbox: z
+        .enum(["0", "1"])
+        .optional()
+        .describe("Enviar en modo sandbox (no envía realmente, no consume créditos). '1' para activar."),
+    sender: z.string().optional().describe("Remitente personalizado (si tu cuenta lo permite)"),
+    date: z
+        .string()
+        .optional()
+        .describe("Fecha de envío programado en formato 'YYYY-MM-DD HH:mm:ss' (hora de México)"),
+    shorten_url: z
+        .enum(["0", "1"])
+        .optional()
+        .describe("'1' para acortar automáticamente URLs en el mensaje"),
+    flash: z.enum(["0", "1"]).optional().describe("'1' para enviar como SMS flash (se muestra sin guardar)"),
+});
+export const listAgendasInput = z.object({});
+export const getContactsInput = z.object({
+    list_key: z.string().describe("Clave única de la agenda (list_key). Obtenla con list_agendas."),
+});
+export const addContactInput = z.object({
+    list_key: z.string().describe("Clave única de la agenda donde agregar el contacto"),
+    number: z.string().describe("Número de teléfono del contacto (mínimo 10 dígitos)"),
+    name: z.string().optional().describe("Nombre del contacto"),
+    email: z.string().optional().describe("Email del contacto"),
+    country_code: z.string().optional().default("52").describe("Código de país (default: 52 México)"),
+    custom_field_1: z.string().optional().describe("Campo personalizado 1"),
+    custom_field_2: z.string().optional().describe("Campo personalizado 2"),
+    custom_field_3: z.string().optional().describe("Campo personalizado 3"),
+    custom_field_4: z.string().optional().describe("Campo personalizado 4"),
+    birthday_date: z.string().optional().describe("Fecha de cumpleaños en formato YYYY-MM-DD"),
+});
+export const getCampaignStatsInput = z.object({
+    campaign_id: z
+        .string()
+        .describe("ID de la campaña SMS. Obtenlo del resultado de send_sms (campo campaignId)."),
+    sandbox: z.enum(["0", "1"]).optional().describe("'1' si la campaña fue enviada en modo sandbox"),
+});
+export const verifyPhoneInput = z.object({
+    phone_number: z.string().describe("Número de teléfono sin código de país (ej: '5512345678')"),
+    country_code: z.string().default("52").describe("Código de país (default: 52 México)"),
+    code_type: z
+        .enum(["numeric", "alphanumeric"])
+        .optional()
+        .describe("Tipo de código: 'numeric' (solo dígitos) o 'alphanumeric'"),
+    expiration_date: z
+        .string()
+        .optional()
+        .describe("Fecha de expiración del código en formato 'YYYY-MM-DD HH:mm:ss'"),
+    voice: z.enum(["0", "1"]).optional().describe("'1' para enviar el código por llamada de voz"),
+    whatsapp: z.enum(["0", "1"]).optional().describe("'1' para enviar el código por WhatsApp"),
+});
+export const checkVerificationInput = z.object({
+    phone_number: z.string().describe("Número de teléfono que recibió el código"),
+    country_code: z.string().default("52").describe("Código de país"),
+    verification_code: z.string().describe("Código de verificación ingresado por el usuario"),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/dist/stdio.d.ts

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

package/dist/stdio.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createApiClient } from "./api-client.js";
+import { registerAllTools } from "./tools/index.js";
+const apiKey = process.env.SMSMASIVOS_API_KEY;
+if (!apiKey) {
+    process.stderr.write("Error: La variable de entorno SMSMASIVOS_API_KEY es requerida.\n" +
+        "Configúrala con tu API key de SMS Masivos.\n");
+    process.exit(1);
+}
+const server = new McpServer({ name: "smsmasivos", version: "0.1.0" }, {
+    instructions: "Servidor MCP para SMS Masivos — plataforma de SMS masivos para México y LATAM. " +
+        "Usa check_balance antes de enviar SMS para verificar créditos disponibles. " +
+        "Usa sandbox='1' en send_sms para pruebas sin envío real. " +
+        "El código de país por defecto es 52 (México).",
+});
+const apiCall = createApiClient({ apiKey });
+registerAllTools(server, apiCall);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=stdio.js.map

package/dist/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;AAE9C,IAAI,CAAC,MAAM,EAAE,CAAC;IACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,kEAAkE;QAChE,8CAA8C,CACjD,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,EACxC;IACE,YAAY,EACV,iFAAiF;QACjF,6EAA6E;QAC7E,2DAA2D;QAC3D,+CAA+C;CAClD,CACF,CAAC;AAEF,MAAM,OAAO,GAAG,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;AAC5C,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAElC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/tools/add-contact.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiCall } from "../api-client.js";
+export declare function registerAddContact(server: McpServer, apiCall: ApiCall): void;

package/dist/tools/add-contact.js

@@ -0,0 +1,23 @@
+import { addContactInput } from "../schemas.js";
+import { SmsmasivosError } from "../errors.js";
+export function registerAddContact(server, apiCall) {
+    server.tool("add_contact", "Agrega un nuevo contacto a una agenda existente en SMS Masivos. Requiere el list_key de la agenda y el número de teléfono. Si el número ya existe en la agenda, se actualiza.", addContactInput.shape, async (params) => {
+        try {
+            const result = await apiCall("/contacts/add", params);
+            const c = result.callback;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `✓ Contacto agregado: ${c.name || "(sin nombre)"} — ${c.number} (ID: ${c.id})`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof SmsmasivosError ? error.message : String(error);
+            return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=add-contact.js.map

package/dist/tools/add-contact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-contact.js","sourceRoot":"","sources":["../../src/tools/add-contact.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAW/C,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,OAAgB;IACpE,MAAM,CAAC,IAAI,CACT,aAAa,EACb,+KAA+K,EAC/K,eAAe,CAAC,KAAK,EACrB,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAqB,eAAe,EAAE,MAAM,CAAC,CAAC;YAC1E,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;YAC1B,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,wBAAwB,CAAC,CAAC,IAAI,IAAI,cAAc,MAAM,CAAC,CAAC,MAAM,SAAS,CAAC,CAAC,EAAE,GAAG;qBACrF;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC5F,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/check-balance.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiCall } from "../api-client.js";
+export declare function registerCheckBalance(server: McpServer, apiCall: ApiCall): void;

package/dist/tools/check-balance.js

@@ -0,0 +1,22 @@
+import { checkBalanceInput } from "../schemas.js";
+import { SmsmasivosError } from "../errors.js";
+export function registerCheckBalance(server, apiCall) {
+    server.tool("check_balance", "Consulta el saldo de créditos SMS disponibles en tu cuenta de SMS Masivos. Cada SMS consume 1 crédito. Usa esta herramienta para verificar saldo antes de enviar mensajes.", checkBalanceInput.shape, async () => {
+        try {
+            const result = await apiCall("/credits/consult");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Créditos disponibles: ${result.credit}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof SmsmasivosError ? error.message : String(error);
+            return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=check-balance.js.map

package/dist/tools/check-balance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-balance.js","sourceRoot":"","sources":["../../src/tools/check-balance.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAM/C,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,OAAgB;IACtE,MAAM,CAAC,IAAI,CACT,eAAe,EACf,4KAA4K,EAC5K,iBAAiB,CAAC,KAAK,EACvB,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAkB,kBAAkB,CAAC,CAAC;YAClE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,yBAAyB,MAAM,CAAC,MAAM,EAAE;qBAC/C;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC5F,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/check-verification.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiCall } from "../api-client.js";
+export declare function registerCheckVerification(server: McpServer, apiCall: ApiCall): void;

package/dist/tools/check-verification.js

@@ -0,0 +1,22 @@
+import { checkVerificationInput } from "../schemas.js";
+import { SmsmasivosError } from "../errors.js";
+export function registerCheckVerification(server, apiCall) {
+    server.tool("check_verification", "Verifica un código OTP previamente enviado a un número de teléfono con verify_phone. Ingresa el mismo número, código de país y el código que el usuario recibió.", checkVerificationInput.shape, async (params) => {
+        try {
+            const result = await apiCall("/protected/json/phones/verification/check", params);
+            if (result.success) {
+                return {
+                    content: [{ type: "text", text: "✓ Código verificado correctamente." }],
+                };
+            }
+            return {
+                content: [{ type: "text", text: `✗ Verificación fallida: ${result.message}` }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof SmsmasivosError ? error.message : String(error);
+            return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=check-verification.js.map

package/dist/tools/check-verification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-verification.js","sourceRoot":"","sources":["../../src/tools/check-verification.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAO/C,MAAM,UAAU,yBAAyB,CAAC,MAAiB,EAAE,OAAgB;IAC3E,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,kKAAkK,EAClK,sBAAsB,CAAC,KAAK,EAC5B,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,2CAA2C,EAC3C,MAAM,CACP,CAAC;YACF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,oCAAoC,EAAE,CAAC;iBACjF,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,2BAA2B,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;aACxF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC5F,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-campaign-stats.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiCall } from "../api-client.js";
+export declare function registerGetCampaignStats(server: McpServer, apiCall: ApiCall): void;

package/dist/tools/get-campaign-stats.js

@@ -0,0 +1,25 @@
+import { getCampaignStatsInput } from "../schemas.js";
+import { SmsmasivosError } from "../errors.js";
+export function registerGetCampaignStats(server, apiCall) {
+    server.tool("get_campaign_stats", "Obtiene las estadísticas de entrega de una campaña SMS por su ID. Muestra: efectividad (%), entregados, fallidos, pendientes y no cobrados. Solo funciona para campañas que ya terminaron de procesarse.", getCampaignStatsInput.shape, async (params) => {
+        try {
+            const result = await apiCall("/reports/details", params);
+            const d = result.details;
+            const lines = [
+                `Estadísticas de campaña ${params.campaign_id}:`,
+                `  Efectividad: ${d.effectiveness}%`,
+                `  Total mensajes: ${d.totals}`,
+                `  Entregados: ${d.delivered}`,
+                `  Fallidos: ${d.failed}`,
+                `  Pendientes: ${d.pending}`,
+                `  No cobrados: ${d.not_charged}`,
+            ];
+            return { content: [{ type: "text", text: lines.join("\n") }] };
+        }
+        catch (error) {
+            const message = error instanceof SmsmasivosError ? error.message : String(error);
+            return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=get-campaign-stats.js.map

package/dist/tools/get-campaign-stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-campaign-stats.js","sourceRoot":"","sources":["../../src/tools/get-campaign-stats.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAa/C,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,OAAgB;IAC1E,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,0MAA0M,EAC1M,qBAAqB,CAAC,KAAK,EAC3B,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAwB,kBAAkB,EAAE,MAAM,CAAC,CAAC;YAChF,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;YACzB,MAAM,KAAK,GAAG;gBACZ,2BAA2B,MAAM,CAAC,WAAW,GAAG;gBAChD,kBAAkB,CAAC,CAAC,aAAa,GAAG;gBACpC,qBAAqB,CAAC,CAAC,MAAM,EAAE;gBAC/B,iBAAiB,CAAC,CAAC,SAAS,EAAE;gBAC9B,eAAe,CAAC,CAAC,MAAM,EAAE;gBACzB,iBAAiB,CAAC,CAAC,OAAO,EAAE;gBAC5B,kBAAkB,CAAC,CAAC,WAAW,EAAE;aAClC,CAAC;YACF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAC1E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC5F,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-contacts.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiCall } from "../api-client.js";
+export declare function registerGetContacts(server: McpServer, apiCall: ApiCall): void;

package/dist/tools/get-contacts.js

@@ -0,0 +1,22 @@
+import { getContactsInput } from "../schemas.js";
+import { SmsmasivosError } from "../errors.js";
+export function registerGetContacts(server, apiCall) {
+    server.tool("get_contacts", "Obtiene todos los contactos de una agenda específica usando su list_key. Usa list_agendas primero para obtener el list_key.", getContactsInput.shape, async (params) => {
+        try {
+            const result = await apiCall("/agendas/get_contacts", params);
+            const contacts = result.result ?? [];
+            if (contacts.length === 0) {
+                return { content: [{ type: "text", text: "Esta agenda no tiene contactos." }] };
+            }
+            const lines = contacts.map((c) => `- ${c.contact_name || "(sin nombre)"}: ${c.contact_number} ${c.contact_email ? `(${c.contact_email})` : ""}`);
+            return {
+                content: [{ type: "text", text: `${contacts.length} contacto(s):\n${lines.join("\n")}` }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof SmsmasivosError ? error.message : String(error);
+            return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=get-contacts.js.map

package/dist/tools/get-contacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-contacts.js","sourceRoot":"","sources":["../../src/tools/get-contacts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAa/C,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,OAAgB;IACrE,MAAM,CAAC,IAAI,CACT,cAAc,EACd,6HAA6H,EAC7H,gBAAgB,CAAC,KAAK,EACtB,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAsB,uBAAuB,EAAE,MAAM,CAAC,CAAC;YACnF,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;YAErC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,iCAAiC,EAAE,CAAC,EAAE,CAAC;YAC3F,CAAC;YAED,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CACxB,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,YAAY,IAAI,cAAc,KAAK,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACrH,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC,MAAM,kBAAkB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;aACnG,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC5F,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiCall } from "../api-client.js";
+export declare function registerAllTools(server: McpServer, apiCall: ApiCall): void;

package/dist/tools/index.js

@@ -0,0 +1,19 @@
+import { registerCheckBalance } from "./check-balance.js";
+import { registerSendSms } from "./send-sms.js";
+import { registerListAgendas } from "./list-agendas.js";
+import { registerGetContacts } from "./get-contacts.js";
+import { registerAddContact } from "./add-contact.js";
+import { registerGetCampaignStats } from "./get-campaign-stats.js";
+import { registerVerifyPhone } from "./verify-phone.js";
+import { registerCheckVerification } from "./check-verification.js";
+export function registerAllTools(server, apiCall) {
+    registerCheckBalance(server, apiCall);
+    registerSendSms(server, apiCall);
+    registerListAgendas(server, apiCall);
+    registerGetContacts(server, apiCall);
+    registerAddContact(server, apiCall);
+    registerGetCampaignStats(server, apiCall);
+    registerVerifyPhone(server, apiCall);
+    registerCheckVerification(server, apiCall);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,OAAgB;IAClE,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,wBAAwB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC"}

package/dist/tools/list-agendas.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiCall } from "../api-client.js";
+export declare function registerListAgendas(server: McpServer, apiCall: ApiCall): void;

package/dist/tools/list-agendas.js

@@ -0,0 +1,22 @@
+import { listAgendasInput } from "../schemas.js";
+import { SmsmasivosError } from "../errors.js";
+export function registerListAgendas(server, apiCall) {
+    server.tool("list_agendas", "Lista todas las agendas (listas de contactos) de tu cuenta en SMS Masivos. Cada agenda tiene un list_key único que necesitas para obtener contactos o agregar nuevos.", listAgendasInput.shape, async () => {
+        try {
+            const result = await apiCall("/agendas/get");
+            const agendas = result.result ?? [];
+            if (agendas.length === 0) {
+                return { content: [{ type: "text", text: "No tienes agendas creadas." }] };
+            }
+            const lines = agendas.map((a) => `- ${a.agenda_name} (${a.agenda_description || "sin descripción"}) — key: ${a.list_key}`);
+            return {
+                content: [{ type: "text", text: `${agendas.length} agenda(s):\n${lines.join("\n")}` }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof SmsmasivosError ? error.message : String(error);
+            return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=list-agendas.js.map

package/dist/tools/list-agendas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-agendas.js","sourceRoot":"","sources":["../../src/tools/list-agendas.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAa/C,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,OAAgB;IACrE,MAAM,CAAC,IAAI,CACT,cAAc,EACd,uKAAuK,EACvK,gBAAgB,CAAC,KAAK,EACtB,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAsB,cAAc,CAAC,CAAC;YAClE,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;YAEpC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,4BAA4B,EAAE,CAAC,EAAE,CAAC;YACtF,CAAC;YAED,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CACvB,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,kBAAkB,IAAI,iBAAiB,YAAY,CAAC,CAAC,QAAQ,EAAE,CAChG,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,gBAAgB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;aAChG,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC5F,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/send-sms.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiCall } from "../api-client.js";
+export declare function registerSendSms(server: McpServer, apiCall: ApiCall): void;

package/dist/tools/send-sms.js

@@ -0,0 +1,25 @@
+import { sendSmsInput } from "../schemas.js";
+import { SmsmasivosError } from "../errors.js";
+export function registerSendSms(server, apiCall) {
+    server.tool("send_sms", "Envía uno o varios mensajes SMS a través de SMS Masivos. Requiere números de teléfono (separados por coma, máximo 500), texto del mensaje y código de país. Usa sandbox='1' para pruebas sin envío real. El código de país por defecto es 52 (México).", sendSmsInput.shape, async (params) => {
+        try {
+            const result = await apiCall("/sms/send", {
+                ...params,
+                showCampaignId: "true",
+            });
+            const lines = [
+                `✓ ${result.total_messages} mensaje(s) enviado(s)`,
+                `Créditos restantes: ${result.credit}`,
+            ];
+            if (result.campaignId) {
+                lines.push(`ID de campaña: ${result.campaignId} (úsalo con get_campaign_stats para ver resultados)`);
+            }
+            return { content: [{ type: "text", text: lines.join("\n") }] };
+        }
+        catch (error) {
+            const message = error instanceof SmsmasivosError ? error.message : String(error);
+            return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=send-sms.js.map

package/dist/tools/send-sms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-sms.js","sourceRoot":"","sources":["../../src/tools/send-sms.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAS/C,MAAM,UAAU,eAAe,CAAC,MAAiB,EAAE,OAAgB;IACjE,MAAM,CAAC,IAAI,CACT,UAAU,EACV,wPAAwP,EACxP,YAAY,CAAC,KAAK,EAClB,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAkB,WAAW,EAAE;gBACzD,GAAG,MAAM;gBACT,cAAc,EAAE,MAAM;aACvB,CAAC,CAAC;YAEH,MAAM,KAAK,GAAG;gBACZ,KAAK,MAAM,CAAC,cAAc,wBAAwB;gBAClD,uBAAuB,MAAM,CAAC,MAAM,EAAE;aACvC,CAAC;YACF,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtB,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,UAAU,qDAAqD,CAAC,CAAC;YACvG,CAAC;YAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAC1E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC5F,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/verify-phone.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiCall } from "../api-client.js";
+export declare function registerVerifyPhone(server: McpServer, apiCall: ApiCall): void;

package/dist/tools/verify-phone.js

@@ -0,0 +1,22 @@
+import { verifyPhoneInput } from "../schemas.js";
+import { SmsmasivosError } from "../errors.js";
+export function registerVerifyPhone(server, apiCall) {
+    server.tool("verify_phone", "Inicia una verificación de número de teléfono enviando un código OTP por SMS. Opcionalmente puede enviarse por llamada de voz o WhatsApp. Después usa check_verification para verificar el código que ingrese el usuario.", verifyPhoneInput.shape, async (params) => {
+        try {
+            const result = await apiCall("/protected/json/phones/verification/start", params);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `✓ Código de verificación enviado a ${result.number}. Referencia: ${result.reference}. Créditos restantes: ${result.credit}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof SmsmasivosError ? error.message : String(error);
+            return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=verify-phone.js.map

package/dist/tools/verify-phone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-phone.js","sourceRoot":"","sources":["../../src/tools/verify-phone.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAQ/C,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,OAAgB;IACrE,MAAM,CAAC,IAAI,CACT,cAAc,EACd,2NAA2N,EAC3N,gBAAgB,CAAC,KAAK,EACtB,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,2CAA2C,EAC3C,MAAM,CACP,CAAC;YACF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,sCAAsC,MAAM,CAAC,MAAM,iBAAiB,MAAM,CAAC,SAAS,yBAAyB,MAAM,CAAC,MAAM,EAAE;qBACnI;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC5F,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@smsmasivos/mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for SMS Masivos — bulk SMS platform for Mexico/LATAM",
+  "type": "module",
+  "main": "dist/stdio.js",
+  "bin": {
+    "smsmasivos-mcp": "dist/stdio.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/stdio.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "keywords": [
+    "mcp",
+    "sms",
+    "smsmasivos",
+    "mexico",
+    "latam",
+    "bulk-sms",
+    "model-context-protocol"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SMS-Masivos/mcp-server.git"
+  }
+}