mirlo-mcp 1.0.1 → 1.0.3

package/dist/client.d.ts

@@ -24,12 +24,13 @@ export declare class MirloClient {
     getTicket(id: string): Promise<any>;
     createTicket(data: Record<string, unknown>): Promise<any>;
     updateTicket(id: string, data: Record<string, unknown>): Promise<any>;
+    addTicketNote(ticketId: string, data: Record<string, unknown>): Promise<any>;
     listTasks(filters?: Record<string, string>): Promise<any>;
     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

@@ -86,6 +86,9 @@ export class MirloClient {
     async updateTicket(id, data) {
         return this.request('PATCH', `/crm/tickets/${id}`, data);
     }
+    async addTicketNote(ticketId, data) {
+        return this.request('POST', `/crm/tickets/${ticketId}/notes`, data);
+    }
     // ── CRM: Tasks ──
     async listTasks(filters) {
         const params = filters ? '?' + new URLSearchParams(filters).toString() : '';
@@ -102,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

@@ -175,6 +175,20 @@ const createTicket = {
     }),
     handler: async (client, args) => client.createTicket({ ...args, source: 'api' }),
 };
+const addTicketNote = {
+    name: 'mirlo_add_ticket_note',
+    description: 'Add a comment/note to a ticket. Can be internal or public (visible to customer).',
+    schema: z.object({
+        ticket_id: z.string().describe('Ticket UUID'),
+        body: z.string().describe('Note content (text or HTML)'),
+        is_public: z.boolean().optional().default(false).describe('true = visible to customer on public ticket page'),
+        author_member_id: z.string().optional().describe('Author member UUID (if omitted, uses API key owner)'),
+    }),
+    handler: async (client, args) => {
+        const { ticket_id, body, is_public, author_member_id } = args;
+        return client.addTicketNote(ticket_id, { body_html: body, is_public, author_member_id: author_member_id || 'system' });
+    },
+};
 // ── CRM: Tasks ──
 const listTasks = {
     name: 'mirlo_list_tasks',
@@ -228,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',
@@ -279,7 +295,7 @@ export const ALL_TOOLS = [
     listDeals, getDeal, createDeal, updateDeal, moveDealStage,
     listContacts, getContact, createContact,
     listAccounts, createAccount,
-    listTickets, createTicket,
+    listTickets, createTicket, addTicketNote,
     listTasks, createTask, completeTask,
     listPipelines,
     // Messaging

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mirlo-mcp",
-  "version": "1.0.1",
+  "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

@@ -114,6 +114,10 @@ export class MirloClient {
     return this.request<any>('PATCH', `/crm/tickets/${id}`, data);
   }
 
+  async addTicketNote(ticketId: string, data: Record<string, unknown>) {
+    return this.request<any>('POST', `/crm/tickets/${ticketId}/notes`, data);
+  }
+
   // ── CRM: Tasks ──
 
   async listTasks(filters?: Record<string, string>) {
@@ -136,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

@@ -203,6 +203,21 @@ const createTicket: ToolDef = {
   handler: async (client, args) => client.createTicket({ ...args, source: 'api' }),
 };
 
+const addTicketNote: ToolDef = {
+  name: 'mirlo_add_ticket_note',
+  description: 'Add a comment/note to a ticket. Can be internal or public (visible to customer).',
+  schema: z.object({
+    ticket_id: z.string().describe('Ticket UUID'),
+    body: z.string().describe('Note content (text or HTML)'),
+    is_public: z.boolean().optional().default(false).describe('true = visible to customer on public ticket page'),
+    author_member_id: z.string().optional().describe('Author member UUID (if omitted, uses API key owner)'),
+  }),
+  handler: async (client, args) => {
+    const { ticket_id, body, is_public, author_member_id } = args;
+    return client.addTicketNote(ticket_id, { body_html: body, is_public, author_member_id: author_member_id || 'system' });
+  },
+};
+
 // ── CRM: Tasks ──
 
 const listTasks: ToolDef = {
@@ -263,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 = {
@@ -321,7 +338,7 @@ export const ALL_TOOLS: ToolDef[] = [
   listDeals, getDeal, createDeal, updateDeal, moveDealStage,
   listContacts, getContact, createContact,
   listAccounts, createAccount,
-  listTickets, createTicket,
+  listTickets, createTicket, addTicketNote,
   listTasks, createTask, completeTask,
   listPipelines,
   // Messaging