mirlo-mcp 1.0.2 → 1.0.4

package/dist/client.d.ts

@@ -4,7 +4,9 @@
 export declare class MirloClient {
     private readonly baseUrl;
     private readonly apiKey;
+    private orgId;
     constructor(apiKey: string, baseUrl?: string);
+    private getMessagesBaseUrl;
     private request;
     listDeals(filters?: Record<string, string | number | boolean>): Promise<any>;
     getDeal(id: string): Promise<any>;
@@ -29,8 +31,10 @@ 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>;
+    private resolveOrgId;
+    private messagesRequest;
+    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

@@ -4,10 +4,15 @@
 export class MirloClient {
     baseUrl;
     apiKey;
+    orgId = null;
     constructor(apiKey, baseUrl = 'https://api.mirlo.com/v1') {
         this.apiKey = apiKey;
         this.baseUrl = baseUrl;
     }
+    getMessagesBaseUrl() {
+        // Messages API is v2, not v1
+        return this.baseUrl.replace('/v1', '/v2/messages');
+    }
     async request(method, path, body) {
         const url = `${this.baseUrl}${path}`;
         const res = await fetch(url, {
@@ -105,18 +110,66 @@ 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 at /v2/messages/organizations/{orgId}/...
+    async resolveOrgId() {
+        if (this.orgId)
+            return this.orgId;
+        try {
+            const res = await this.listAccounts({ limit: '1' });
+            if (res?.data?.[0]?.organization_id) {
+                this.orgId = res.data[0].organization_id;
+                return this.orgId;
+            }
+        }
+        catch { }
+        try {
+            const res = await this.listContacts({ limit: '1' });
+            if (res?.data?.[0]?.organization_id) {
+                this.orgId = res.data[0].organization_id;
+                return this.orgId;
+            }
+        }
+        catch { }
+        throw new Error('Could not resolve organization_id. Make sure your API key has CRM data.');
     }
-    async sendTemplate(to, templateId, params) {
-        return this.request('POST', '/messages/templates', { to, template_id: templateId, params });
+    async messagesRequest(method, path, body) {
+        const orgId = await this.resolveOrgId();
+        const msgBase = this.getMessagesBaseUrl();
+        const url = `${msgBase}/organizations/${orgId}${path}`;
+        const res = await fetch(url, {
+            method,
+            headers: { 'X-API-Key': this.apiKey, 'Content-Type': 'application/json' },
+            ...(body ? { body: JSON.stringify(body) } : {}),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`Mirlo Messages API ${method} ${path} → ${res.status}: ${text.slice(0, 200)}`);
+        }
+        return res.json();
+    }
+    async sendMessage(organizationAddress, contactAddress, text, service = 'whatsapp') {
+        return this.messagesRequest('POST', '/messages', {
+            organization_address: organizationAddress,
+            service,
+            contact_address: contactAddress,
+            direction: 'outgoing',
+            content: { kind: 'text', text },
+        });
+    }
+    async sendTemplate(organizationAddress, to, metaTemplateId, components) {
+        return this.messagesRequest('POST', '/messages/send-template', {
+            organization_address: organizationAddress,
+            to,
+            meta_template_id: metaTemplateId,
+            components,
+        });
     }
     async listConversations(filters) {
         const params = filters ? '?' + new URLSearchParams(filters).toString() : '';
-        return this.request('GET', `/conversations${params}`);
+        return this.messagesRequest('GET', `/conversations${params}`);
     }
     async listMessages(conversationId, limit = 20) {
-        return this.request('GET', `/conversations/${conversationId}/messages?limit=${limit}`);
+        return this.messagesRequest('GET', `/conversations/${conversationId}/messages?limit=${limit}`);
     }
     // ── Voice ──
     async listCalls(filters) {

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.4",
   "description": "Mirlo MCP Server — CRM, Messaging & Voice tools for Claude, GPT, and other LLMs",
   "type": "module",
   "main": "dist/index.js",

package/src/client.ts

@@ -5,12 +5,18 @@
 export class MirloClient {
   private readonly baseUrl: string;
   private readonly apiKey: string;
+  private orgId: string | null = null;
 
   constructor(apiKey: string, baseUrl = 'https://api.mirlo.com/v1') {
     this.apiKey = apiKey;
     this.baseUrl = baseUrl;
   }
 
+  private getMessagesBaseUrl(): string {
+    // Messages API is v2, not v1
+    return this.baseUrl.replace('/v1', '/v2/messages');
+  }
+
   private async request<T>(method: string, path: string, body?: unknown): Promise<T> {
     const url = `${this.baseUrl}${path}`;
     const res = await fetch(url, {
@@ -140,22 +146,69 @@ export class MirloClient {
   }
 
   // ── Messaging ──
+  // Messages API is v2 at /v2/messages/organizations/{orgId}/...
+
+  private async resolveOrgId(): Promise<string> {
+    if (this.orgId) return this.orgId;
+    try {
+      const res = await this.listAccounts({ limit: '1' });
+      if (res?.data?.[0]?.organization_id) {
+        this.orgId = res.data[0].organization_id;
+        return this.orgId!;
+      }
+    } catch {}
+    try {
+      const res = await this.listContacts({ limit: '1' });
+      if (res?.data?.[0]?.organization_id) {
+        this.orgId = res.data[0].organization_id;
+        return this.orgId!;
+      }
+    } catch {}
+    throw new Error('Could not resolve organization_id. Make sure your API key has CRM data.');
+  }
+
+  private async messagesRequest<T>(method: string, path: string, body?: unknown): Promise<T> {
+    const orgId = await this.resolveOrgId();
+    const msgBase = this.getMessagesBaseUrl();
+    const url = `${msgBase}/organizations/${orgId}${path}`;
+    const res = await fetch(url, {
+      method,
+      headers: { 'X-API-Key': this.apiKey, 'Content-Type': 'application/json' },
+      ...(body ? { body: JSON.stringify(body) } : {}),
+    });
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`Mirlo Messages API ${method} ${path} → ${res.status}: ${text.slice(0, 200)}`);
+    }
+    return res.json() as T;
+  }
 
-  async sendMessage(to: string, body: string, channel = 'whatsapp') {
-    return this.request<any>('POST', '/messages', { to, body, channel });
+  async sendMessage(organizationAddress: string, contactAddress: string, text: string, service = 'whatsapp') {
+    return this.messagesRequest<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.messagesRequest<any>('POST', '/messages/send-template', {
+      organization_address: organizationAddress,
+      to,
+      meta_template_id: metaTemplateId,
+      components,
+    });
   }
 
   async listConversations(filters?: Record<string, string>) {
     const params = filters ? '?' + new URLSearchParams(filters).toString() : '';
-    return this.request<any>('GET', `/conversations${params}`);
+    return this.messagesRequest<any>('GET', `/conversations${params}`);
   }
 
   async listMessages(conversationId: string, limit = 20) {
-    return this.request<any>('GET', `/conversations/${conversationId}/messages?limit=${limit}`);
+    return this.messagesRequest<any>('GET', `/conversations/${conversationId}/messages?limit=${limit}`);
   }
 
   // ── Voice ──

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 = {