mirlo-mcp 1.0.2 → 1.0.3

package/dist/client.d.ts

@@ -29,8 +29,8 @@ export declare class MirloClient {
     createTask(data: Record<string, unknown>): Promise<any>;
     completeTask(id: string): Promise<any>;
     listPipelines(): Promise<any>;
-    sendMessage(to: string, body: string, channel?: string): Promise<any>;
-    sendTemplate(to: string, templateId: string, params?: Record<string, string>): Promise<any>;
+    sendMessage(organizationAddress: string, contactAddress: string, text: string, service?: string): Promise<any>;
+    sendTemplate(organizationAddress: string, to: string, metaTemplateId: string, components?: any[]): Promise<any>;
     listConversations(filters?: Record<string, string>): Promise<any>;
     listMessages(conversationId: string, limit?: number): Promise<any>;
     listCalls(filters?: Record<string, string>): Promise<any>;

package/dist/client.js

@@ -105,11 +105,24 @@ export class MirloClient {
         return this.request('GET', '/crm/pipelines');
     }
     // ── Messaging ──
-    async sendMessage(to, body, channel = 'whatsapp') {
-        return this.request('POST', '/messages', { to, body, channel });
+    // Messages API is v2 with org in path
+    async sendMessage(organizationAddress, contactAddress, text, service = 'whatsapp') {
+        // v2 messages endpoint — org resolved from API key
+        return this.request('POST', '/messages', {
+            organization_address: organizationAddress,
+            service,
+            contact_address: contactAddress,
+            direction: 'outgoing',
+            content: { kind: 'text', text },
+        });
     }
-    async sendTemplate(to, templateId, params) {
-        return this.request('POST', '/messages/templates', { to, template_id: templateId, params });
+    async sendTemplate(organizationAddress, to, metaTemplateId, components) {
+        return this.request('POST', '/messages/send-template', {
+            organization_address: organizationAddress,
+            to,
+            meta_template_id: metaTemplateId,
+            components,
+        });
     }
     async listConversations(filters) {
         const params = filters ? '?' + new URLSearchParams(filters).toString() : '';

package/dist/tools.js

@@ -242,23 +242,25 @@ const listPipelines = {
 // ── Messaging ──
 const sendMessage = {
     name: 'mirlo_send_message',
-    description: 'Send a WhatsApp or SMS message to a phone number.',
+    description: 'Send a WhatsApp message to a phone number. Only works within the 24h window after the contact messaged you. Use send_template for first contact.',
     schema: z.object({
-        to: z.string().describe('Recipient phone number (E.164 format)'),
-        body: z.string().describe('Message text'),
-        channel: z.enum(['whatsapp', 'sms']).optional().default('whatsapp'),
+        organization_address: z.string().describe('Your WhatsApp Phone Number ID (from Mirlo dashboard)'),
+        contact_address: z.string().describe('Recipient phone number WITHOUT + prefix (e.g. 5215512345678)'),
+        text: z.string().describe('Message text'),
+        service: z.enum(['whatsapp', 'instagram', 'messenger']).optional().default('whatsapp'),
     }),
-    handler: async (client, args) => client.sendMessage(args.to, args.body, args.channel),
+    handler: async (client, args) => client.sendMessage(args.organization_address, args.contact_address, args.text, args.service),
 };
 const sendTemplate = {
     name: 'mirlo_send_template',
-    description: 'Send a pre-approved WhatsApp template message.',
+    description: 'Send a pre-approved WhatsApp template message. Works outside the 24h window.',
     schema: z.object({
-        to: z.string().describe('Recipient phone number'),
-        template_id: z.string().describe('Template ID'),
-        params: z.record(z.string(), z.string()).optional().describe('Template parameters'),
+        organization_address: z.string().describe('Your WhatsApp Phone Number ID'),
+        to: z.string().describe('Recipient phone number with + prefix (e.g. +525512345678)'),
+        meta_template_id: z.string().describe('Meta-approved template ID'),
+        components: z.any().optional().describe('Template components array with parameters'),
     }),
-    handler: async (client, args) => client.sendTemplate(args.to, args.template_id, args.params),
+    handler: async (client, args) => client.sendTemplate(args.organization_address, args.to, args.meta_template_id, args.components),
 };
 const listConversations = {
     name: 'mirlo_list_conversations',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mirlo-mcp",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Mirlo MCP Server — CRM, Messaging & Voice tools for Claude, GPT, and other LLMs",
   "type": "module",
   "main": "dist/index.js",

package/src/client.ts

@@ -140,13 +140,26 @@ export class MirloClient {
   }
 
   // ── Messaging ──
-
-  async sendMessage(to: string, body: string, channel = 'whatsapp') {
-    return this.request<any>('POST', '/messages', { to, body, channel });
+  // Messages API is v2 with org in path
+
+  async sendMessage(organizationAddress: string, contactAddress: string, text: string, service = 'whatsapp') {
+    // v2 messages endpoint — org resolved from API key
+    return this.request<any>('POST', '/messages', {
+      organization_address: organizationAddress,
+      service,
+      contact_address: contactAddress,
+      direction: 'outgoing',
+      content: { kind: 'text', text },
+    });
   }
 
-  async sendTemplate(to: string, templateId: string, params?: Record<string, string>) {
-    return this.request<any>('POST', '/messages/templates', { to, template_id: templateId, params });
+  async sendTemplate(organizationAddress: string, to: string, metaTemplateId: string, components?: any[]) {
+    return this.request<any>('POST', '/messages/send-template', {
+      organization_address: organizationAddress,
+      to,
+      meta_template_id: metaTemplateId,
+      components,
+    });
   }
 
   async listConversations(filters?: Record<string, string>) {

package/src/tools.ts

@@ -278,24 +278,26 @@ const listPipelines: ToolDef = {
 
 const sendMessage: ToolDef = {
   name: 'mirlo_send_message',
-  description: 'Send a WhatsApp or SMS message to a phone number.',
+  description: 'Send a WhatsApp message to a phone number. Only works within the 24h window after the contact messaged you. Use send_template for first contact.',
   schema: z.object({
-    to: z.string().describe('Recipient phone number (E.164 format)'),
-    body: z.string().describe('Message text'),
-    channel: z.enum(['whatsapp', 'sms']).optional().default('whatsapp'),
+    organization_address: z.string().describe('Your WhatsApp Phone Number ID (from Mirlo dashboard)'),
+    contact_address: z.string().describe('Recipient phone number WITHOUT + prefix (e.g. 5215512345678)'),
+    text: z.string().describe('Message text'),
+    service: z.enum(['whatsapp', 'instagram', 'messenger']).optional().default('whatsapp'),
   }),
-  handler: async (client, args) => client.sendMessage(args.to, args.body, args.channel),
+  handler: async (client, args) => client.sendMessage(args.organization_address, args.contact_address, args.text, args.service),
 };
 
 const sendTemplate: ToolDef = {
   name: 'mirlo_send_template',
-  description: 'Send a pre-approved WhatsApp template message.',
+  description: 'Send a pre-approved WhatsApp template message. Works outside the 24h window.',
   schema: z.object({
-    to: z.string().describe('Recipient phone number'),
-    template_id: z.string().describe('Template ID'),
-    params: z.record(z.string(), z.string()).optional().describe('Template parameters'),
+    organization_address: z.string().describe('Your WhatsApp Phone Number ID'),
+    to: z.string().describe('Recipient phone number with + prefix (e.g. +525512345678)'),
+    meta_template_id: z.string().describe('Meta-approved template ID'),
+    components: z.any().optional().describe('Template components array with parameters'),
   }),
-  handler: async (client, args) => client.sendTemplate(args.to, args.template_id, args.params),
+  handler: async (client, args) => client.sendTemplate(args.organization_address, args.to, args.meta_template_id, args.components),
 };
 
 const listConversations: ToolDef = {