Embed in your bot

Already running a Zaileys client? Expose it to AI agents in one line. It reuses your live session — no separate authentication, no second QR.

import { Client } from 'zaileys'
import { serveMcp } from 'zaileys-mcp'
 
const client = new Client()
await serveMcp(client) // AI agents can now drive this WhatsApp over stdio

serveMcp returns a handle:

const { server, close } = await serveMcp(client, { readOnly: true })
// …later
await close()

Options

serveMcp(client, options) takes every configuration option plus an optional transport:

await serveMcp(client, {
  tools: 'progressive',              // strategy (default)
  readOnly: false,
  allowlist: ['6281111111111'],
  name: 'my-whatsapp',
})

Custom transport (HTTP / SSE)

serveMcp defaults to stdio. For an HTTP or SSE transport, build the server with createMcpServer and connect your own:

import { createMcpServer } from 'zaileys-mcp'
import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js'
 
const server = createMcpServer(client, { readOnly: true })
const transport = new StreamableHTTPServerTransport({ /* … */ })
await server.connect(transport)

Why embed instead of standalone?

• One session — your bot and the AI tools share the same WhatsApp connection; no double-login, no session conflicts.
• Live state — the agent reads the same message store your bot writes to, so get_messages sees everything your bot has seen.
• Coexist — your event handlers (client.on('message', …)) keep running while agents drive the account through MCP.

API