@messegy/mcp 1.0.0

package/dist/tools/messages.js

@@ -0,0 +1,149 @@
+import { z } from 'zod';
+import { api } from '../api-client.js';
+import { enforcePlanQuota } from '../lib/quota-guard.js';
+export function registerMessageTools(server) {
+    /**
+     * 1. Send Single WhatsApp Message (Text or Media)
+     */
+    server.tool('messegy_send_whatsapp_message', 'Send a direct WhatsApp message (text, image, video, document, audio) to a customer phone number via Messegy WhatsApp Cloud API', {
+        to: z.string().describe('Recipient phone number with country code (e.g. 919876543210 or +14155552671)'),
+        type: z.enum(['text', 'image', 'video', 'document', 'audio']).default('text').describe('Message type'),
+        text: z.string().optional().describe('Text message body (required if type is text)'),
+        media_url: z.string().url().optional().describe('Direct publicly accessible URL for image, video, document, or audio'),
+        caption: z.string().optional().describe('Optional caption for media files'),
+        filename: z.string().optional().describe('Optional custom filename for document attachments'),
+    }, async (params) => {
+        // 1. Quota & Plan Limits Check
+        await enforcePlanQuota('send_message');
+        const cleanTo = params.to.replace(/[^\d]/g, '');
+        const payload = {
+            to: cleanTo,
+            type: params.type,
+        };
+        if (params.type === 'text') {
+            if (!params.text) {
+                return {
+                    content: [{ type: 'text', text: 'Error: "text" parameter is required when type is "text".' }],
+                    isError: true,
+                };
+            }
+            payload.message = params.text;
+            payload.text = { body: params.text };
+        }
+        else {
+            if (!params.media_url) {
+                return {
+                    content: [{ type: 'text', text: `Error: "media_url" parameter is required when type is "${params.type}".` }],
+                    isError: true,
+                };
+            }
+            payload[params.type] = {
+                link: params.media_url,
+                caption: params.caption,
+                filename: params.filename,
+            };
+        }
+        const result = await api.post('/v1/messages/send', payload);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `✅ WhatsApp message dispatched successfully to +${cleanTo}!\n\nResponse:\n${JSON.stringify(result, null, 2)}`,
+                },
+            ],
+        };
+    });
+    /**
+     * 2. Send Interactive Quick Reply Buttons
+     */
+    server.tool('messegy_send_interactive_buttons', 'Send an interactive WhatsApp message with up to 3 clickable quick-reply buttons', {
+        to: z.string().describe('Recipient phone number with country code'),
+        body_text: z.string().describe('Main body text of the message'),
+        header_text: z.string().optional().describe('Optional header text'),
+        footer_text: z.string().optional().describe('Optional small footer text'),
+        buttons: z
+            .array(z.object({
+            id: z.string().describe('Unique button identifier payload (e.g. btn_confirm, btn_cancel)'),
+            title: z.string().max(20).describe('Button label text (max 20 chars)'),
+        }))
+            .min(1)
+            .max(3)
+            .describe('List of 1 to 3 interactive buttons'),
+    }, async (params) => {
+        const cleanTo = params.to.replace(/[^\d]/g, '');
+        const payload = {
+            to: cleanTo,
+            type: 'interactive',
+            interactive: {
+                type: 'button',
+                header: params.header_text ? { type: 'text', text: params.header_text } : undefined,
+                body: { text: params.body_text },
+                footer: params.footer_text ? { text: params.footer_text } : undefined,
+                action: {
+                    buttons: params.buttons.map((b) => ({
+                        type: 'reply',
+                        reply: {
+                            id: b.id,
+                            title: b.title,
+                        },
+                    })),
+                },
+            },
+        };
+        const result = await api.post('/v1/messages/interactive', payload);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `✅ Interactive button message sent to +${cleanTo}!\n\n${JSON.stringify(result, null, 2)}`,
+                },
+            ],
+        };
+    });
+    /**
+     * 3. Send Interactive List Menu
+     */
+    server.tool('messegy_send_list_menu', 'Send an interactive WhatsApp dropdown list menu with structured sections and selectable rows (up to 10 rows)', {
+        to: z.string().describe('Recipient phone number with country code'),
+        button_text: z.string().max(20).describe('Label on the list menu trigger button (e.g. "Select Option")'),
+        body_text: z.string().describe('Main body description text'),
+        header_text: z.string().optional().describe('Optional header text'),
+        footer_text: z.string().optional().describe('Optional footer text'),
+        sections: z
+            .array(z.object({
+            title: z.string().describe('Section category title'),
+            rows: z.array(z.object({
+                id: z.string().describe('Unique row ID (e.g. opt_1)'),
+                title: z.string().max(24).describe('Row title (max 24 chars)'),
+                description: z.string().max(72).optional().describe('Optional row description'),
+            })),
+        }))
+            .describe('Sections containing menu items'),
+    }, async (params) => {
+        const cleanTo = params.to.replace(/[^\d]/g, '');
+        const payload = {
+            to: cleanTo,
+            type: 'interactive',
+            interactive: {
+                type: 'list',
+                header: params.header_text ? { type: 'text', text: params.header_text } : undefined,
+                body: { text: params.body_text },
+                footer: params.footer_text ? { text: params.footer_text } : undefined,
+                action: {
+                    button: params.button_text,
+                    sections: params.sections,
+                },
+            },
+        };
+        const result = await api.post('/v1/messages/interactive', payload);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `✅ Interactive list menu sent to +${cleanTo}!\n\n${JSON.stringify(result, null, 2)}`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=messages.js.map

package/dist/tools/messages.js.map

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

package/dist/tools/shopify.d.ts

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

package/dist/tools/shopify.js

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+import { api } from '../api-client.js';
+export function registerShopifyTools(server) {
+    /**
+     * 1. Send Abandoned Cart Recovery Message
+     */
+    server.tool('messegy_trigger_shopify_abandoned_cart', 'Trigger an automated WhatsApp abandoned checkout recovery message with customer name, item details, and direct checkout link', {
+        customer_phone: z.string().describe('Customer phone number with country code'),
+        customer_name: z.string().describe('Customer first name'),
+        checkout_url: z.string().url().describe('Direct Shopify abandoned checkout URL with auto-applied discount'),
+        cart_total: z.string().optional().describe('Cart total with currency symbol (e.g. "₹1,499" or "$49.99")'),
+        discount_code: z.string().optional().describe('Optional coupon code (e.g. "SAVE10")'),
+    }, async (params) => {
+        const cleanPhone = params.customer_phone.replace(/[^\d]/g, '');
+        const payload = {
+            phone: cleanPhone,
+            event: 'abandoned_checkout',
+            variables: {
+                name: params.customer_name,
+                checkout_url: params.checkout_url,
+                cart_total: params.cart_total,
+                discount_code: params.discount_code,
+            },
+        };
+        const result = await api.post('/v1/integrations/shopify/trigger', payload);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `🛒 Abandoned cart recovery WhatsApp message triggered for +${cleanPhone}!\n\n${JSON.stringify(result, null, 2)}`,
+                },
+            ],
+        };
+    });
+    /**
+     * 2. Send Order Confirmation / Fulfillment Tracking
+     */
+    server.tool('messegy_send_order_notification', 'Send an automated WhatsApp notification for order confirmation, shipping update, or tracking link', {
+        customer_phone: z.string().describe('Customer phone number with country code'),
+        order_number: z.string().describe('Order ID (e.g. "#1048")'),
+        event_type: z.enum(['order_created', 'order_shipped', 'order_delivered', 'cod_verification']).describe('Type of order event'),
+        tracking_url: z.string().url().optional().describe('Package tracking link'),
+        order_total: z.string().optional().describe('Order total with currency'),
+    }, async (params) => {
+        const cleanPhone = params.customer_phone.replace(/[^\d]/g, '');
+        const payload = {
+            phone: cleanPhone,
+            event: params.event_type,
+            variables: {
+                order_number: params.order_number,
+                tracking_url: params.tracking_url,
+                order_total: params.order_total,
+            },
+        };
+        const result = await api.post('/v1/integrations/shopify/trigger', payload);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `📦 Order notification [${params.event_type}] sent to +${cleanPhone}!\n\n${JSON.stringify(result, null, 2)}`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=shopify.js.map

package/dist/tools/shopify.js.map

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

package/dist/tools/templates.d.ts

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

package/dist/tools/templates.js

@@ -0,0 +1,160 @@
+import { z } from 'zod';
+import { api } from '../api-client.js';
+export function registerTemplateTools(server) {
+    /**
+     * 1. List Meta WhatsApp Templates
+     */
+    server.tool('messegy_list_templates', 'List all WhatsApp templates registered in your Messegy account, with status (APPROVED, PENDING, REJECTED) and category', {
+        status: z.enum(['ALL', 'APPROVED', 'PENDING', 'REJECTED']).optional().describe('Filter by template status'),
+        search: z.string().optional().describe('Search templates by name or keyword'),
+    }, async (params) => {
+        const queryParams = {};
+        if (params.status && params.status !== 'ALL') {
+            queryParams.status = params.status;
+        }
+        if (params.search) {
+            queryParams.search = params.search;
+        }
+        const result = await api.get('/v1/templates', queryParams);
+        const templates = result.data || result.templates || result;
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `📋 Found ${Array.isArray(templates) ? templates.length : 0} templates:\n\n${JSON.stringify(templates, null, 2)}`,
+                },
+            ],
+        };
+    });
+    /**
+     * 2. Send WhatsApp Template Message with Dynamic Variables
+     */
+    server.tool('messegy_send_template_message', 'Send a pre-approved Meta WhatsApp Template message with dynamic body parameters ({{1}}, {{2}}), header media, or button payloads', {
+        to: z.string().describe('Recipient phone number with country code'),
+        template_name: z.string().describe('Exact name of the approved template in Messegy / Meta (e.g. order_confirmation_v1)'),
+        language_code: z.string().default('en').describe('Language code of the template (e.g. "en", "en_US", "hi")'),
+        body_variables: z.array(z.string()).optional().describe('Ordered list of dynamic text values to replace {{1}}, {{2}}, etc. in the template body'),
+        header_media_url: z.string().url().optional().describe('Optional image/document/video URL if template has a media header'),
+        button_payloads: z.array(z.string()).optional().describe('Dynamic URL parameter or payload for template buttons'),
+    }, async (params) => {
+        const cleanTo = params.to.replace(/[^\d]/g, '');
+        const components = [];
+        // Header component if media provided
+        if (params.header_media_url) {
+            components.push({
+                type: 'header',
+                parameters: [
+                    {
+                        type: 'image',
+                        image: { link: params.header_media_url },
+                    },
+                ],
+            });
+        }
+        // Body parameters
+        if (params.body_variables && params.body_variables.length > 0) {
+            components.push({
+                type: 'body',
+                parameters: params.body_variables.map((val) => ({
+                    type: 'text',
+                    text: String(val),
+                })),
+            });
+        }
+        // Button parameters
+        if (params.button_payloads && params.button_payloads.length > 0) {
+            params.button_payloads.forEach((payload, idx) => {
+                components.push({
+                    type: 'button',
+                    sub_type: 'url',
+                    index: String(idx),
+                    parameters: [
+                        {
+                            type: 'text',
+                            text: payload,
+                        },
+                    ],
+                });
+            });
+        }
+        const payload = {
+            to: cleanTo,
+            template: {
+                name: params.template_name,
+                language: { code: params.language_code },
+                components,
+            },
+        };
+        const result = await api.post('/v1/messages/template', payload);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `✅ Template "${params.template_name}" sent to +${cleanTo}!\n\n${JSON.stringify(result, null, 2)}`,
+                },
+            ],
+        };
+    });
+    /**
+     * 3. Create & Submit New WhatsApp Template to Meta
+     */
+    server.tool('messegy_create_template', 'Submit a new WhatsApp Template (Marketing, Utility, or Authentication) directly to Meta for instant approval', {
+        name: z.string().regex(/^[a-z0-9_]+$/).describe('Template identifier in lowercase with underscores only (e.g. diwali_sale_2026)'),
+        category: z.enum(['MARKETING', 'UTILITY', 'AUTHENTICATION']).describe('Template Category'),
+        language: z.string().default('en_US').describe('Template language code (e.g. en_US, hi)'),
+        body_text: z.string().describe('Main template text containing {{1}}, {{2}} placeholder variables'),
+        header_type: z.enum(['NONE', 'TEXT', 'IMAGE', 'DOCUMENT', 'VIDEO']).default('NONE').describe('Header type'),
+        header_text: z.string().optional().describe('Text if header_type is TEXT'),
+        footer_text: z.string().optional().describe('Optional small footer text'),
+        buttons: z
+            .array(z.object({
+            type: z.enum(['QUICK_REPLY', 'URL', 'PHONE_NUMBER']),
+            text: z.string().describe('Button title'),
+            url: z.string().url().optional().describe('URL if type is URL'),
+            phone_number: z.string().optional().describe('Phone number if type is PHONE_NUMBER'),
+        }))
+            .optional()
+            .describe('Optional interactive buttons'),
+    }, async (params) => {
+        const components = [];
+        if (params.header_type !== 'NONE') {
+            components.push({
+                type: 'HEADER',
+                format: params.header_type,
+                text: params.header_type === 'TEXT' ? params.header_text : undefined,
+            });
+        }
+        components.push({
+            type: 'BODY',
+            text: params.body_text,
+        });
+        if (params.footer_text) {
+            components.push({
+                type: 'FOOTER',
+                text: params.footer_text,
+            });
+        }
+        if (params.buttons && params.buttons.length > 0) {
+            components.push({
+                type: 'BUTTONS',
+                buttons: params.buttons,
+            });
+        }
+        const payload = {
+            name: params.name,
+            category: params.category,
+            language: params.language,
+            components,
+        };
+        const result = await api.post('/v1/templates', payload);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `🚀 Template "${params.name}" submitted to Meta for approval!\n\n${JSON.stringify(result, null, 2)}`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=templates.js.map

package/dist/tools/templates.js.map

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

package/dist/web-app.d.ts

@@ -0,0 +1 @@
+export declare function getWebAppHtml(): string;