@deus-ai/whatsapp-mcp 1.0.0

package/README.md

@@ -0,0 +1,52 @@
+# @deus-ai/whatsapp-mcp
+
+Standalone MCP server for WhatsApp messaging. Uses [Baileys](https://github.com/WhiskeySockets/Baileys) for the WhatsApp Web API.
+
+Works with any MCP client — Claude Code, Claude Desktop, or your own application.
+
+## Quick Start
+
+```json
+{
+  "mcpServers": {
+    "whatsapp": {
+      "command": "npx",
+      "args": ["@deus-ai/whatsapp-mcp"],
+      "env": {
+        "WHATSAPP_AUTH_DIR": "/path/to/auth/dir"
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `send_message` | Send a text message to a chat |
+| `send_typing` | Show/hide typing indicator |
+| `get_status` | Connection status and identity info |
+| `list_chats` | List known chats and groups |
+| `sync_groups` | Refresh group metadata from WhatsApp |
+| `get_new_messages` | Poll for incoming messages (cursor-based) |
+| `connect` / `disconnect` | Connection lifecycle |
+| `get_auth_status` | Check if WhatsApp credentials exist |
+| `start_auth` | Begin QR or pairing code authentication |
+
+## Incoming Messages
+
+Messages are pushed in real-time via MCP logging notifications with `logger: "incoming_message"`. For clients that don't support notifications, use the `get_new_messages` polling tool.
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `WHATSAPP_AUTH_DIR` | `./store/auth` | Path to WhatsApp credential storage |
+| `ASSISTANT_NAME` | `Deus` | Name prefix for outgoing messages |
+| `ASSISTANT_HAS_OWN_NUMBER` | `false` | Skip name prefix when bot has its own phone |
+| `LOG_LEVEL` | `info` | Pino log level (debug, info, warn, error) |
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * WhatsApp MCP Server
+ *
+ * Standalone MCP server that provides WhatsApp messaging tools.
+ * Communicates via stdio (JSON-RPC). Can be used by any MCP client.
+ *
+ * Config (env vars):
+ *   WHATSAPP_AUTH_DIR  — path to auth credentials (default: ./store/auth)
+ *   ASSISTANT_NAME     — bot display name (default: Deus)
+ *   ASSISTANT_HAS_OWN_NUMBER — "true" if bot has a dedicated phone number
+ *   LOG_LEVEL          — pino log level (default: info)
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+/**
+ * WhatsApp MCP Server
+ *
+ * Standalone MCP server that provides WhatsApp messaging tools.
+ * Communicates via stdio (JSON-RPC). Can be used by any MCP client.
+ *
+ * Config (env vars):
+ *   WHATSAPP_AUTH_DIR  — path to auth credentials (default: ./store/auth)
+ *   ASSISTANT_NAME     — bot display name (default: Deus)
+ *   ASSISTANT_HAS_OWN_NUMBER — "true" if bot has a dedicated phone number
+ *   LOG_LEVEL          — pino log level (default: info)
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { registerCommonTools } from '@deus-ai/channel-core';
+import { WhatsAppProvider } from './whatsapp.js';
+const server = new McpServer({
+    name: '@deus-ai/whatsapp-mcp',
+    version: '1.0.0',
+});
+const provider = new WhatsAppProvider();
+// Register common tools (send_message, get_status, etc.)
+registerCommonTools(server, provider);
+// ── WhatsApp-specific tools ───────────────────────────────────────────
+server.tool('get_auth_status', 'Check whether WhatsApp credentials exist and the connection is authenticated', {}, async () => {
+    const hasAuth = provider.hasAuth();
+    const connected = provider.isConnected();
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({ has_credentials: hasAuth, connected }),
+            },
+        ],
+    };
+});
+server.tool('start_auth', 'Begin WhatsApp authentication. Returns QR code data or pairing code.', {
+    method: z.enum(['qr', 'pairing-code']).describe('Authentication method'),
+    phone: z
+        .string()
+        .optional()
+        .describe('Phone number (required for pairing-code method, e.g. 14155551234)'),
+}, async (args) => {
+    if (args.method === 'pairing-code' && !args.phone) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: 'Phone number required for pairing-code method',
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Auth is handled by the connect flow — this tool triggers it.
+    // The provider writes QR data to disk; the client reads it.
+    if (!provider.isConnected()) {
+        await provider.connect();
+    }
+    const status = provider.getStatus();
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    status: status.connected ? 'connected' : 'authenticating',
+                    identity: status.identity,
+                }),
+            },
+        ],
+    };
+});
+// ── Auto-connect if credentials exist ─────────────────────────────────
+if (provider.hasAuth()) {
+    provider.connect().catch((err) => {
+        // Log to stderr — don't crash, stay available for auth tools
+        console.error('[@deus-ai/whatsapp-mcp] Auto-connect failed:', err.message);
+    });
+}
+// ── Start MCP transport ───────────────────────────────────────────────
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/whatsapp.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Standalone WhatsApp connection provider.
+ * Extracted from Deus WhatsAppChannel — no Deus-specific dependencies.
+ * All config comes from env vars; all messages are forwarded to onMessage.
+ */
+import type { ChannelProvider, ChannelStatus, ChatInfo, IncomingMessage } from '@deus-ai/channel-core';
+export declare class WhatsAppProvider implements ChannelProvider {
+    readonly name = "whatsapp";
+    private sock;
+    private connected;
+    private connectTime;
+    private lidToPhoneMap;
+    private outgoingQueue;
+    private flushing;
+    private groupSyncTimerStarted;
+    private sentMessageCache;
+    private groupMetadataCache;
+    private botLidUser?;
+    private pendingFirstOpen?;
+    private lastGroupSync;
+    private knownChats;
+    private readyPromise;
+    private readyResolve;
+    onMessage: (msg: IncomingMessage) => void;
+    connect(): Promise<void>;
+    waitForReady(): Promise<void>;
+    private connectInternal;
+    sendMessage(chatId: string, text: string): Promise<void>;
+    isConnected(): boolean;
+    getStatus(): ChannelStatus;
+    disconnect(): Promise<void>;
+    setTyping(chatId: string, isTyping: boolean): Promise<void>;
+    listChats(): Promise<ChatInfo[]>;
+    syncGroups(): Promise<ChatInfo[]>;
+    /** Check if WhatsApp credentials exist on disk. */
+    hasAuth(): boolean;
+    private syncGroupMetadata;
+    private translateJid;
+    private getNormalizedGroupMetadata;
+    private flushOutgoingQueue;
+}

package/dist/whatsapp.js

@@ -0,0 +1,351 @@
+/**
+ * Standalone WhatsApp connection provider.
+ * Extracted from Deus WhatsAppChannel — no Deus-specific dependencies.
+ * All config comes from env vars; all messages are forwarded to onMessage.
+ */
+import fs from 'fs';
+import path from 'path';
+import { makeWASocket, Browsers, DisconnectReason, fetchLatestWaWebVersion, makeCacheableSignalKeyStore, normalizeMessageContent, useMultiFileAuthState, } from '@whiskeysockets/baileys';
+import { createRequire } from 'module';
+const { proto } = createRequire(import.meta.url)('@whiskeysockets/baileys');
+import pino from 'pino';
+// ── Config from env vars ────────────────────────────────────────────────
+const AUTH_DIR = process.env.WHATSAPP_AUTH_DIR || path.resolve(process.cwd(), 'store', 'auth');
+const ASSISTANT_NAME = process.env.ASSISTANT_NAME || 'Deus';
+const ASSISTANT_HAS_OWN_NUMBER = process.env.ASSISTANT_HAS_OWN_NUMBER === 'true';
+// Use stderr for logging (stdout is reserved for MCP JSON-RPC)
+const logger = pino({ level: process.env.LOG_LEVEL || 'info' }, pino.destination(2));
+const baileysLogger = pino({ level: 'silent' });
+const GROUP_SYNC_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24 hours
+export class WhatsAppProvider {
+    name = 'whatsapp';
+    sock;
+    connected = false;
+    connectTime = 0;
+    lidToPhoneMap = {};
+    outgoingQueue = [];
+    flushing = false;
+    groupSyncTimerStarted = false;
+    sentMessageCache = new Map();
+    groupMetadataCache = new Map();
+    botLidUser;
+    pendingFirstOpen;
+    lastGroupSync = null;
+    knownChats = new Map();
+    readyPromise = null;
+    readyResolve = null;
+    // Set by server-base.ts — called for every incoming message
+    onMessage = () => { };
+    async connect() {
+        this.readyPromise = new Promise((resolve) => {
+            this.readyResolve = resolve;
+        });
+        return new Promise((resolve, reject) => {
+            this.pendingFirstOpen = resolve;
+            this.connectInternal().catch(reject);
+        });
+    }
+    async waitForReady() {
+        if (this.connected)
+            return;
+        if (this.readyPromise)
+            await this.readyPromise;
+    }
+    async connectInternal() {
+        fs.mkdirSync(AUTH_DIR, { recursive: true });
+        const { state, saveCreds } = await useMultiFileAuthState(AUTH_DIR);
+        const { version } = await fetchLatestWaWebVersion({}).catch((err) => {
+            logger.warn({ err }, 'Failed to fetch latest WA Web version, using default');
+            return { version: undefined };
+        });
+        this.sock = makeWASocket({
+            version,
+            auth: {
+                creds: state.creds,
+                keys: makeCacheableSignalKeyStore(state.keys, baileysLogger),
+            },
+            printQRInTerminal: false,
+            logger: baileysLogger,
+            browser: Browsers.macOS('Chrome'),
+            cachedGroupMetadata: async (jid) => this.getNormalizedGroupMetadata(jid),
+            getMessage: async (key) => {
+                const cached = this.sentMessageCache.get(key.id || '');
+                if (cached)
+                    return cached;
+                return proto.Message.fromObject({});
+            },
+        });
+        this.sock.ev.on('connection.update', (update) => {
+            const { connection, lastDisconnect, qr } = update;
+            if (qr) {
+                // Write QR data to a file for auth tools to pick up
+                const qrPath = path.join(path.dirname(AUTH_DIR), 'qr-data.txt');
+                fs.writeFileSync(qrPath, qr);
+                logger.warn('WhatsApp authentication required — use start_auth tool');
+            }
+            if (connection === 'close') {
+                this.connected = false;
+                const reason = lastDisconnect?.error?.output?.statusCode;
+                const shouldReconnect = reason !== DisconnectReason.loggedOut;
+                logger.info({ reason, shouldReconnect }, 'Connection closed');
+                if (shouldReconnect) {
+                    logger.info('Reconnecting...');
+                    this.connectInternal().catch((err) => {
+                        logger.error({ err }, 'Failed to reconnect, retrying in 5s');
+                        setTimeout(() => {
+                            this.connectInternal().catch((err2) => {
+                                logger.error({ err: err2 }, 'Reconnection retry failed');
+                            });
+                        }, 5000);
+                    });
+                }
+                else {
+                    logger.info('Logged out. Re-authenticate to continue.');
+                }
+            }
+            else if (connection === 'open') {
+                this.connected = true;
+                this.connectTime = Date.now();
+                logger.info('Connected to WhatsApp');
+                this.sock.sendPresenceUpdate('available').catch(() => { });
+                // Build LID to phone mapping
+                if (this.sock.user) {
+                    const phoneUser = this.sock.user.id.split(':')[0];
+                    const lidUser = this.sock.user.lid?.split(':')[0];
+                    if (lidUser && phoneUser) {
+                        this.lidToPhoneMap[lidUser] = `${phoneUser}@s.whatsapp.net`;
+                        this.botLidUser = lidUser;
+                    }
+                }
+                this.flushOutgoingQueue().catch(() => { });
+                this.syncGroupMetadata().catch(() => { });
+                if (!this.groupSyncTimerStarted) {
+                    this.groupSyncTimerStarted = true;
+                    setInterval(() => {
+                        this.syncGroupMetadata().catch(() => { });
+                    }, GROUP_SYNC_INTERVAL_MS);
+                }
+                if (this.pendingFirstOpen) {
+                    this.pendingFirstOpen();
+                    this.pendingFirstOpen = undefined;
+                }
+                if (this.readyResolve) {
+                    this.readyResolve();
+                    this.readyResolve = null;
+                }
+            }
+        });
+        this.sock.ev.on('creds.update', saveCreds);
+        // Phone number share event — not typed in all baileys versions
+        this.sock.ev.on('chats.phoneNumberShare', (data) => {
+            const lidUser = data.lid?.split('@')[0].split(':')[0];
+            if (lidUser && data.jid) {
+                this.lidToPhoneMap[lidUser] = data.jid;
+                this.groupMetadataCache.clear();
+            }
+        });
+        this.sock.ev.on('messages.upsert', async ({ messages }) => {
+            for (const msg of messages) {
+                try {
+                    if (!msg.message)
+                        continue;
+                    const normalized = normalizeMessageContent(msg.message);
+                    if (!normalized)
+                        continue;
+                    const rawJid = msg.key.remoteJid;
+                    if (!rawJid || rawJid === 'status@broadcast')
+                        continue;
+                    let chatJid = await this.translateJid(rawJid);
+                    if (chatJid.endsWith('@lid') && msg.key.senderPn) {
+                        const pn = msg.key.senderPn;
+                        const phoneJid = pn.includes('@') ? pn : `${pn}@s.whatsapp.net`;
+                        this.lidToPhoneMap[rawJid.split('@')[0].split(':')[0]] = phoneJid;
+                        chatJid = phoneJid;
+                    }
+                    const timestamp = new Date(Number(msg.messageTimestamp) * 1000).toISOString();
+                    const isGroup = chatJid.endsWith('@g.us');
+                    // Track chat metadata
+                    this.knownChats.set(chatJid, {
+                        name: msg.pushName || chatJid.split('@')[0],
+                        isGroup,
+                    });
+                    let content = normalized.conversation ||
+                        normalized.extendedTextMessage?.text ||
+                        normalized.imageMessage?.caption ||
+                        normalized.videoMessage?.caption ||
+                        '';
+                    // Normalize bot LID mentions to assistant name
+                    if (this.botLidUser && content.includes(`@${this.botLidUser}`)) {
+                        content = content.replace(`@${this.botLidUser}`, `@${ASSISTANT_NAME}`);
+                    }
+                    if (!content)
+                        continue;
+                    const sender = msg.key.participant || msg.key.remoteJid || '';
+                    const senderName = msg.pushName || sender.split('@')[0];
+                    const fromMe = msg.key.fromMe || false;
+                    const isBotMessage = ASSISTANT_HAS_OWN_NUMBER
+                        ? fromMe
+                        : content.startsWith(`${ASSISTANT_NAME}:`);
+                    // Forward ALL messages — the host decides which to act on
+                    this.onMessage({
+                        id: msg.key.id || '',
+                        chat_id: chatJid,
+                        sender,
+                        sender_name: senderName,
+                        content,
+                        timestamp,
+                        is_from_me: fromMe,
+                        is_group: isGroup,
+                        metadata: { is_bot_message: isBotMessage },
+                    });
+                }
+                catch (err) {
+                    logger.error({ err, remoteJid: msg.key?.remoteJid }, 'Error processing message');
+                }
+            }
+        });
+    }
+    async sendMessage(chatId, text) {
+        const prefixed = ASSISTANT_HAS_OWN_NUMBER
+            ? text
+            : `${ASSISTANT_NAME}: ${text}`;
+        if (!this.connected) {
+            this.outgoingQueue.push({ jid: chatId, text: prefixed });
+            return;
+        }
+        try {
+            const sent = await this.sock.sendMessage(chatId, { text: prefixed });
+            if (sent?.key?.id && sent.message) {
+                this.sentMessageCache.set(sent.key.id, sent.message);
+                if (this.sentMessageCache.size > 256) {
+                    const oldest = this.sentMessageCache.keys().next().value;
+                    this.sentMessageCache.delete(oldest);
+                }
+            }
+        }
+        catch (err) {
+            this.outgoingQueue.push({ jid: chatId, text: prefixed });
+            logger.warn({ chatId, err }, 'Failed to send, message queued');
+        }
+    }
+    isConnected() {
+        return this.connected;
+    }
+    getStatus() {
+        return {
+            connected: this.connected,
+            channel: 'whatsapp',
+            identity: this.sock?.user?.id?.split(':')[0],
+            uptime_seconds: this.connected
+                ? Math.floor((Date.now() - this.connectTime) / 1000)
+                : 0,
+        };
+    }
+    async disconnect() {
+        this.connected = false;
+        this.sock?.end(undefined);
+    }
+    async setTyping(chatId, isTyping) {
+        try {
+            await this.sock.sendPresenceUpdate(isTyping ? 'composing' : 'paused', chatId);
+        }
+        catch {
+            // Best effort
+        }
+    }
+    async listChats() {
+        return Array.from(this.knownChats.entries()).map(([id, info]) => ({
+            id,
+            name: info.name,
+            is_group: info.isGroup,
+        }));
+    }
+    async syncGroups() {
+        return this.syncGroupMetadata(true);
+    }
+    /** Check if WhatsApp credentials exist on disk. */
+    hasAuth() {
+        return fs.existsSync(path.join(AUTH_DIR, 'creds.json'));
+    }
+    // ── Internal helpers ──────────────────────────────────────────────────
+    async syncGroupMetadata(force = false) {
+        if (!force && this.lastGroupSync) {
+            const elapsed = Date.now() - new Date(this.lastGroupSync).getTime();
+            if (elapsed < GROUP_SYNC_INTERVAL_MS)
+                return [];
+        }
+        try {
+            const groups = await this.sock.groupFetchAllParticipating();
+            const result = [];
+            for (const [jid, metadata] of Object.entries(groups)) {
+                if (metadata.subject) {
+                    this.knownChats.set(jid, { name: metadata.subject, isGroup: true });
+                    result.push({ id: jid, name: metadata.subject, is_group: true });
+                }
+            }
+            this.lastGroupSync = new Date().toISOString();
+            logger.info({ count: result.length }, 'Group metadata synced');
+            return result;
+        }
+        catch (err) {
+            logger.error({ err }, 'Failed to sync group metadata');
+            return [];
+        }
+    }
+    async translateJid(jid) {
+        if (!jid.endsWith('@lid'))
+            return jid;
+        const lidUser = jid.split('@')[0].split(':')[0];
+        const cached = this.lidToPhoneMap[lidUser];
+        if (cached)
+            return cached;
+        try {
+            const pn = await this.sock.signalRepository?.lidMapping?.getPNForLID(jid);
+            if (pn) {
+                const phoneJid = `${pn.split('@')[0].split(':')[0]}@s.whatsapp.net`;
+                this.lidToPhoneMap[lidUser] = phoneJid;
+                return phoneJid;
+            }
+        }
+        catch {
+            // Best effort
+        }
+        return jid;
+    }
+    async getNormalizedGroupMetadata(jid) {
+        if (!jid.endsWith('@g.us'))
+            return undefined;
+        const cached = this.groupMetadataCache.get(jid);
+        if (cached && cached.expiresAt > Date.now())
+            return cached.metadata;
+        const metadata = await this.sock.groupMetadata(jid);
+        const participants = await Promise.all(metadata.participants.map(async (p) => ({
+            ...p,
+            id: await this.translateJid(p.id),
+        })));
+        const normalized = { ...metadata, participants };
+        this.groupMetadataCache.set(jid, {
+            metadata: normalized,
+            expiresAt: Date.now() + 60_000,
+        });
+        return normalized;
+    }
+    async flushOutgoingQueue() {
+        if (this.flushing || this.outgoingQueue.length === 0)
+            return;
+        this.flushing = true;
+        try {
+            while (this.outgoingQueue.length > 0) {
+                const item = this.outgoingQueue.shift();
+                const sent = await this.sock.sendMessage(item.jid, { text: item.text });
+                if (sent?.key?.id && sent.message) {
+                    this.sentMessageCache.set(sent.key.id, sent.message);
+                }
+            }
+        }
+        finally {
+            this.flushing = false;
+        }
+    }
+}
+//# sourceMappingURL=whatsapp.js.map

package/dist/whatsapp.js.map

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

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@deus-ai/whatsapp-mcp",
+  "version": "1.0.0",
+  "description": "WhatsApp MCP server — standalone WhatsApp Web integration for any MCP client",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "deus-ai-whatsapp-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@deus-ai/channel-core": "^1.0.0",
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@whiskeysockets/baileys": "^7.0.0-rc.9",
+    "pino": "^10.3.1",
+    "qrcode-terminal": "^0.12.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.7",
+    "@types/qrcode-terminal": "^0.12.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT"
+}

package/src/index.ts

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+
+/**
+ * WhatsApp MCP Server
+ *
+ * Standalone MCP server that provides WhatsApp messaging tools.
+ * Communicates via stdio (JSON-RPC). Can be used by any MCP client.
+ *
+ * Config (env vars):
+ *   WHATSAPP_AUTH_DIR  — path to auth credentials (default: ./store/auth)
+ *   ASSISTANT_NAME     — bot display name (default: Deus)
+ *   ASSISTANT_HAS_OWN_NUMBER — "true" if bot has a dedicated phone number
+ *   LOG_LEVEL          — pino log level (default: info)
+ */
+
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { registerCommonTools } from '@deus-ai/channel-core';
+
+import { WhatsAppProvider } from './whatsapp.js';
+
+const server = new McpServer({
+  name: '@deus-ai/whatsapp-mcp',
+  version: '1.0.0',
+});
+
+const provider = new WhatsAppProvider();
+
+// Register common tools (send_message, get_status, etc.)
+registerCommonTools(server, provider);
+
+// ── WhatsApp-specific tools ───────────────────────────────────────────
+
+server.tool(
+  'get_auth_status',
+  'Check whether WhatsApp credentials exist and the connection is authenticated',
+  {},
+  async () => {
+    const hasAuth = provider.hasAuth();
+    const connected = provider.isConnected();
+    return {
+      content: [
+        {
+          type: 'text' as const,
+          text: JSON.stringify({ has_credentials: hasAuth, connected }),
+        },
+      ],
+    };
+  },
+);
+
+server.tool(
+  'start_auth',
+  'Begin WhatsApp authentication. Returns QR code data or pairing code.',
+  {
+    method: z.enum(['qr', 'pairing-code']).describe('Authentication method'),
+    phone: z
+      .string()
+      .optional()
+      .describe(
+        'Phone number (required for pairing-code method, e.g. 14155551234)',
+      ),
+  },
+  async (args) => {
+    if (args.method === 'pairing-code' && !args.phone) {
+      return {
+        content: [
+          {
+            type: 'text' as const,
+            text: JSON.stringify({
+              error: 'Phone number required for pairing-code method',
+            }),
+          },
+        ],
+        isError: true,
+      };
+    }
+    // Auth is handled by the connect flow — this tool triggers it.
+    // The provider writes QR data to disk; the client reads it.
+    if (!provider.isConnected()) {
+      await provider.connect();
+    }
+    const status = provider.getStatus();
+    return {
+      content: [
+        {
+          type: 'text' as const,
+          text: JSON.stringify({
+            status: status.connected ? 'connected' : 'authenticating',
+            identity: status.identity,
+          }),
+        },
+      ],
+    };
+  },
+);
+
+// ── Auto-connect if credentials exist ─────────────────────────────────
+
+if (provider.hasAuth()) {
+  provider.connect().catch((err) => {
+    // Log to stderr — don't crash, stay available for auth tools
+    console.error('[@deus-ai/whatsapp-mcp] Auto-connect failed:', err.message);
+  });
+}
+
+// ── Start MCP transport ───────────────────────────────────────────────
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/src/whatsapp.ts

@@ -0,0 +1,439 @@
+/**
+ * Standalone WhatsApp connection provider.
+ * Extracted from Deus WhatsAppChannel — no Deus-specific dependencies.
+ * All config comes from env vars; all messages are forwarded to onMessage.
+ */
+
+import fs from 'fs';
+import path from 'path';
+
+import {
+  makeWASocket,
+  Browsers,
+  DisconnectReason,
+  fetchLatestWaWebVersion,
+  makeCacheableSignalKeyStore,
+  normalizeMessageContent,
+  useMultiFileAuthState,
+} from '@whiskeysockets/baileys';
+import type {
+  GroupMetadata,
+  WAMessageKey,
+  WASocket,
+  proto as ProtoTypes,
+} from '@whiskeysockets/baileys';
+import { createRequire } from 'module';
+const { proto } = createRequire(import.meta.url)('@whiskeysockets/baileys') as {
+  proto: typeof ProtoTypes;
+};
+import pino from 'pino';
+
+import type {
+  ChannelProvider,
+  ChannelStatus,
+  ChatInfo,
+  IncomingMessage,
+} from '@deus-ai/channel-core';
+
+// ── Config from env vars ────────────────────────────────────────────────
+
+const AUTH_DIR =
+  process.env.WHATSAPP_AUTH_DIR || path.resolve(process.cwd(), 'store', 'auth');
+const ASSISTANT_NAME = process.env.ASSISTANT_NAME || 'Deus';
+const ASSISTANT_HAS_OWN_NUMBER =
+  process.env.ASSISTANT_HAS_OWN_NUMBER === 'true';
+
+// Use stderr for logging (stdout is reserved for MCP JSON-RPC)
+const logger = pino(
+  { level: process.env.LOG_LEVEL || 'info' },
+  pino.destination(2),
+);
+const baileysLogger = pino({ level: 'silent' });
+
+const GROUP_SYNC_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24 hours
+
+export class WhatsAppProvider implements ChannelProvider {
+  readonly name = 'whatsapp';
+
+  private sock!: WASocket;
+  private connected = false;
+  private connectTime = 0;
+  private lidToPhoneMap: Record<string, string> = {};
+  private outgoingQueue: Array<{ jid: string; text: string }> = [];
+  private flushing = false;
+  private groupSyncTimerStarted = false;
+  private sentMessageCache = new Map<string, ProtoTypes.IMessage>();
+  private groupMetadataCache = new Map<
+    string,
+    { metadata: GroupMetadata; expiresAt: number }
+  >();
+  private botLidUser?: string;
+  private pendingFirstOpen?: () => void;
+  private lastGroupSync: string | null = null;
+  private knownChats = new Map<string, { name: string; isGroup: boolean }>();
+  private readyPromise: Promise<void> | null = null;
+  private readyResolve: (() => void) | null = null;
+
+  // Set by server-base.ts — called for every incoming message
+  onMessage: (msg: IncomingMessage) => void = () => {};
+
+  async connect(): Promise<void> {
+    this.readyPromise = new Promise<void>((resolve) => {
+      this.readyResolve = resolve;
+    });
+    return new Promise<void>((resolve, reject) => {
+      this.pendingFirstOpen = resolve;
+      this.connectInternal().catch(reject);
+    });
+  }
+
+  async waitForReady(): Promise<void> {
+    if (this.connected) return;
+    if (this.readyPromise) await this.readyPromise;
+  }
+
+  private async connectInternal(): Promise<void> {
+    fs.mkdirSync(AUTH_DIR, { recursive: true });
+
+    const { state, saveCreds } = await useMultiFileAuthState(AUTH_DIR);
+
+    const { version } = await fetchLatestWaWebVersion({}).catch((err) => {
+      logger.warn(
+        { err },
+        'Failed to fetch latest WA Web version, using default',
+      );
+      return { version: undefined };
+    });
+
+    this.sock = makeWASocket({
+      version,
+      auth: {
+        creds: state.creds,
+        keys: makeCacheableSignalKeyStore(state.keys, baileysLogger),
+      },
+      printQRInTerminal: false,
+      logger: baileysLogger,
+      browser: Browsers.macOS('Chrome'),
+      cachedGroupMetadata: async (jid: string) =>
+        this.getNormalizedGroupMetadata(jid),
+      getMessage: async (key: WAMessageKey) => {
+        const cached = this.sentMessageCache.get(key.id || '');
+        if (cached) return cached;
+        return proto.Message.fromObject({});
+      },
+    });
+
+    this.sock.ev.on('connection.update', (update) => {
+      const { connection, lastDisconnect, qr } = update;
+
+      if (qr) {
+        // Write QR data to a file for auth tools to pick up
+        const qrPath = path.join(path.dirname(AUTH_DIR), 'qr-data.txt');
+        fs.writeFileSync(qrPath, qr);
+        logger.warn('WhatsApp authentication required — use start_auth tool');
+      }
+
+      if (connection === 'close') {
+        this.connected = false;
+        const reason = (
+          lastDisconnect?.error as { output?: { statusCode?: number } }
+        )?.output?.statusCode;
+        const shouldReconnect = reason !== DisconnectReason.loggedOut;
+        logger.info({ reason, shouldReconnect }, 'Connection closed');
+
+        if (shouldReconnect) {
+          logger.info('Reconnecting...');
+          this.connectInternal().catch((err) => {
+            logger.error({ err }, 'Failed to reconnect, retrying in 5s');
+            setTimeout(() => {
+              this.connectInternal().catch((err2) => {
+                logger.error({ err: err2 }, 'Reconnection retry failed');
+              });
+            }, 5000);
+          });
+        } else {
+          logger.info('Logged out. Re-authenticate to continue.');
+        }
+      } else if (connection === 'open') {
+        this.connected = true;
+        this.connectTime = Date.now();
+        logger.info('Connected to WhatsApp');
+
+        this.sock.sendPresenceUpdate('available').catch(() => {});
+
+        // Build LID to phone mapping
+        if (this.sock.user) {
+          const phoneUser = this.sock.user.id.split(':')[0];
+          const lidUser = this.sock.user.lid?.split(':')[0];
+          if (lidUser && phoneUser) {
+            this.lidToPhoneMap[lidUser] = `${phoneUser}@s.whatsapp.net`;
+            this.botLidUser = lidUser;
+          }
+        }
+
+        this.flushOutgoingQueue().catch(() => {});
+        this.syncGroupMetadata().catch(() => {});
+
+        if (!this.groupSyncTimerStarted) {
+          this.groupSyncTimerStarted = true;
+          setInterval(() => {
+            this.syncGroupMetadata().catch(() => {});
+          }, GROUP_SYNC_INTERVAL_MS);
+        }
+
+        if (this.pendingFirstOpen) {
+          this.pendingFirstOpen();
+          this.pendingFirstOpen = undefined;
+        }
+        if (this.readyResolve) {
+          this.readyResolve();
+          this.readyResolve = null;
+        }
+      }
+    });
+
+    this.sock.ev.on('creds.update', saveCreds);
+
+    // Phone number share event — not typed in all baileys versions
+    (this.sock.ev as any).on(
+      'chats.phoneNumberShare',
+      (data: { lid?: string; jid?: string }) => {
+        const lidUser = data.lid?.split('@')[0].split(':')[0];
+        if (lidUser && data.jid) {
+          this.lidToPhoneMap[lidUser] = data.jid;
+          this.groupMetadataCache.clear();
+        }
+      },
+    );
+
+    this.sock.ev.on('messages.upsert', async ({ messages }) => {
+      for (const msg of messages) {
+        try {
+          if (!msg.message) continue;
+          const normalized = normalizeMessageContent(msg.message);
+          if (!normalized) continue;
+          const rawJid = msg.key.remoteJid;
+          if (!rawJid || rawJid === 'status@broadcast') continue;
+
+          let chatJid = await this.translateJid(rawJid);
+          if (chatJid.endsWith('@lid') && (msg.key as any).senderPn) {
+            const pn = (msg.key as any).senderPn as string;
+            const phoneJid = pn.includes('@') ? pn : `${pn}@s.whatsapp.net`;
+            this.lidToPhoneMap[rawJid.split('@')[0].split(':')[0]] = phoneJid;
+            chatJid = phoneJid;
+          }
+
+          const timestamp = new Date(
+            Number(msg.messageTimestamp) * 1000,
+          ).toISOString();
+          const isGroup = chatJid.endsWith('@g.us');
+
+          // Track chat metadata
+          this.knownChats.set(chatJid, {
+            name: msg.pushName || chatJid.split('@')[0],
+            isGroup,
+          });
+
+          let content =
+            normalized.conversation ||
+            normalized.extendedTextMessage?.text ||
+            normalized.imageMessage?.caption ||
+            normalized.videoMessage?.caption ||
+            '';
+
+          // Normalize bot LID mentions to assistant name
+          if (this.botLidUser && content.includes(`@${this.botLidUser}`)) {
+            content = content.replace(
+              `@${this.botLidUser}`,
+              `@${ASSISTANT_NAME}`,
+            );
+          }
+
+          if (!content) continue;
+
+          const sender = msg.key.participant || msg.key.remoteJid || '';
+          const senderName = msg.pushName || sender.split('@')[0];
+          const fromMe = msg.key.fromMe || false;
+          const isBotMessage = ASSISTANT_HAS_OWN_NUMBER
+            ? fromMe
+            : content.startsWith(`${ASSISTANT_NAME}:`);
+
+          // Forward ALL messages — the host decides which to act on
+          this.onMessage({
+            id: msg.key.id || '',
+            chat_id: chatJid,
+            sender,
+            sender_name: senderName,
+            content,
+            timestamp,
+            is_from_me: fromMe,
+            is_group: isGroup,
+            metadata: { is_bot_message: isBotMessage },
+          });
+        } catch (err) {
+          logger.error(
+            { err, remoteJid: msg.key?.remoteJid },
+            'Error processing message',
+          );
+        }
+      }
+    });
+  }
+
+  async sendMessage(chatId: string, text: string): Promise<void> {
+    const prefixed = ASSISTANT_HAS_OWN_NUMBER
+      ? text
+      : `${ASSISTANT_NAME}: ${text}`;
+
+    if (!this.connected) {
+      this.outgoingQueue.push({ jid: chatId, text: prefixed });
+      return;
+    }
+    try {
+      const sent = await this.sock.sendMessage(chatId, { text: prefixed });
+      if (sent?.key?.id && sent.message) {
+        this.sentMessageCache.set(sent.key.id, sent.message);
+        if (this.sentMessageCache.size > 256) {
+          const oldest = this.sentMessageCache.keys().next().value!;
+          this.sentMessageCache.delete(oldest);
+        }
+      }
+    } catch (err) {
+      this.outgoingQueue.push({ jid: chatId, text: prefixed });
+      logger.warn({ chatId, err }, 'Failed to send, message queued');
+    }
+  }
+
+  isConnected(): boolean {
+    return this.connected;
+  }
+
+  getStatus(): ChannelStatus {
+    return {
+      connected: this.connected,
+      channel: 'whatsapp',
+      identity: this.sock?.user?.id?.split(':')[0],
+      uptime_seconds: this.connected
+        ? Math.floor((Date.now() - this.connectTime) / 1000)
+        : 0,
+    };
+  }
+
+  async disconnect(): Promise<void> {
+    this.connected = false;
+    this.sock?.end(undefined);
+  }
+
+  async setTyping(chatId: string, isTyping: boolean): Promise<void> {
+    try {
+      await this.sock.sendPresenceUpdate(
+        isTyping ? 'composing' : 'paused',
+        chatId,
+      );
+    } catch {
+      // Best effort
+    }
+  }
+
+  async listChats(): Promise<ChatInfo[]> {
+    return Array.from(this.knownChats.entries()).map(([id, info]) => ({
+      id,
+      name: info.name,
+      is_group: info.isGroup,
+    }));
+  }
+
+  async syncGroups(): Promise<ChatInfo[]> {
+    return this.syncGroupMetadata(true);
+  }
+
+  /** Check if WhatsApp credentials exist on disk. */
+  hasAuth(): boolean {
+    return fs.existsSync(path.join(AUTH_DIR, 'creds.json'));
+  }
+
+  // ── Internal helpers ──────────────────────────────────────────────────
+
+  private async syncGroupMetadata(force = false): Promise<ChatInfo[]> {
+    if (!force && this.lastGroupSync) {
+      const elapsed = Date.now() - new Date(this.lastGroupSync).getTime();
+      if (elapsed < GROUP_SYNC_INTERVAL_MS) return [];
+    }
+
+    try {
+      const groups = await this.sock.groupFetchAllParticipating();
+      const result: ChatInfo[] = [];
+      for (const [jid, metadata] of Object.entries(groups)) {
+        if (metadata.subject) {
+          this.knownChats.set(jid, { name: metadata.subject, isGroup: true });
+          result.push({ id: jid, name: metadata.subject, is_group: true });
+        }
+      }
+      this.lastGroupSync = new Date().toISOString();
+      logger.info({ count: result.length }, 'Group metadata synced');
+      return result;
+    } catch (err) {
+      logger.error({ err }, 'Failed to sync group metadata');
+      return [];
+    }
+  }
+
+  private async translateJid(jid: string): Promise<string> {
+    if (!jid.endsWith('@lid')) return jid;
+    const lidUser = jid.split('@')[0].split(':')[0];
+    const cached = this.lidToPhoneMap[lidUser];
+    if (cached) return cached;
+
+    try {
+      const pn = await (
+        this.sock.signalRepository as any
+      )?.lidMapping?.getPNForLID(jid);
+      if (pn) {
+        const phoneJid = `${pn.split('@')[0].split(':')[0]}@s.whatsapp.net`;
+        this.lidToPhoneMap[lidUser] = phoneJid;
+        return phoneJid;
+      }
+    } catch {
+      // Best effort
+    }
+    return jid;
+  }
+
+  private async getNormalizedGroupMetadata(
+    jid: string,
+  ): Promise<GroupMetadata | undefined> {
+    if (!jid.endsWith('@g.us')) return undefined;
+    const cached = this.groupMetadataCache.get(jid);
+    if (cached && cached.expiresAt > Date.now()) return cached.metadata;
+
+    const metadata = await this.sock.groupMetadata(jid);
+    const participants = await Promise.all(
+      metadata.participants.map(async (p) => ({
+        ...p,
+        id: await this.translateJid(p.id),
+      })),
+    );
+    const normalized = { ...metadata, participants };
+    this.groupMetadataCache.set(jid, {
+      metadata: normalized,
+      expiresAt: Date.now() + 60_000,
+    });
+    return normalized;
+  }
+
+  private async flushOutgoingQueue(): Promise<void> {
+    if (this.flushing || this.outgoingQueue.length === 0) return;
+    this.flushing = true;
+    try {
+      while (this.outgoingQueue.length > 0) {
+        const item = this.outgoingQueue.shift()!;
+        const sent = await this.sock.sendMessage(item.jid, { text: item.text });
+        if (sent?.key?.id && sent.message) {
+          this.sentMessageCache.set(sent.key.id, sent.message);
+        }
+      }
+    } finally {
+      this.flushing = false;
+    }
+  }
+}

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}