{"_id":"@kahflane/whatsapp-mcp","_rev":"6-7e706161c6fefbad8fe5f8874a3f711f","name":"@kahflane/whatsapp-mcp","dist-tags":{"latest":"0.2.3"},"versions":{"0.1.0":{"name":"@kahflane/whatsapp-mcp","version":"0.1.0","keywords":["whatsapp","mcp","mcp-server","model-context-protocol","baileys","ai-agents","claude","claude-code","codex","cursor","opencode","bun"],"author":{"name":"kahflane"},"license":"MIT","_id":"@kahflane/whatsapp-mcp@0.1.0","maintainers":[{"name":"kahflane","email":"julfikaronthego@gmail.com"}],"homepage":"https://github.com/kahflane/whatsapp-mcp#readme","bugs":{"url":"https://github.com/kahflane/whatsapp-mcp/issues"},"bin":{"whatsapp-mcp":"src/index.ts"},"dist":{"shasum":"7fa76fe591388ff5c8eb5290a0c7c46759ae07d5","tarball":"https://registry.npmjs.org/@kahflane/whatsapp-mcp/-/whatsapp-mcp-0.1.0.tgz","fileCount":46,"integrity":"sha512-31ZgiroK4OUfHosjZMFn+zw7gXH+xCvc3sk76hnXolJ6QR+S27azZiu5ylje2Vr8jShJucOfOrGqF9xoDCHCRQ==","signatures":[{"sig":"MEYCIQC1lx+d4RW1aztweRx0fJ+/mLlgVqCFtk/uDyPB1NHcdwIhAOzCaCiKhoUDf2mfhm2VAUlTKtlgVy/i3JkmilOI/6v9","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":198317},"type":"module","module":"src/index.ts","engines":{"bun":">=1.1.0"},"gitHead":"00558bc1f25f4a9722ec899e9efb8a37751d1d8a","scripts":{"dev":"bun --watch src/index.ts","start":"bun run src/index.ts","typecheck":"tsc --noEmit"},"_npmUser":{"name":"kahflane","email":"julfikaronthego@gmail.com"},"repository":{"url":"git+https://github.com/kahflane/whatsapp-mcp.git","type":"git"},"_npmVersion":"10.9.0","description":"WhatsApp MCP server built on the innovatorssoft Baileys fork + the Anthropic Model Context Protocol SDK. Runs on Bun.","directories":{},"_nodeVersion":"22.12.0","dependencies":{"zod":"^3.23.8","pino":"^9.5.0","qrcode":"^1.5.4","@innovatorssoft/baileys":"^7.4.3","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","typescript":"^5.6.0","@types/qrcode":"^1.5.5"},"_npmOperationalInternal":{"tmp":"tmp/whatsapp-mcp_0.1.0_1780198973449_0.5951066739709492","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@kahflane/whatsapp-mcp","version":"0.2.0","keywords":["whatsapp","mcp","mcp-server","model-context-protocol","baileys","ai-agents","claude","claude-code","codex","cursor","opencode","bun","node","npx"],"author":{"name":"kahflane"},"license":"MIT","_id":"@kahflane/whatsapp-mcp@0.2.0","maintainers":[{"name":"kahflane","email":"julfikaronthego@gmail.com"}],"homepage":"https://github.com/kahflane/whatsapp-mcp#readme","bugs":{"url":"https://github.com/kahflane/whatsapp-mcp/issues"},"bin":{"whatsapp-mcp":"dist/index.js"},"dist":{"shasum":"51cff934c94ff4e9f5390beeca37ed6d7a5d535a","tarball":"https://registry.npmjs.org/@kahflane/whatsapp-mcp/-/whatsapp-mcp-0.2.0.tgz","fileCount":6,"integrity":"sha512-fL7CbihItAhewczGME84uGAKC6OFAtnO5O5ggURylhrFd4jWw3sMzJAlLK5r7GIYMuLk4wAXd8C4XX2hTvhtKw==","signatures":[{"sig":"MEYCIQCvUNw8YR18qRTIIfgHIXkIe53aABNZVfkG6ty3rzv1nQIhALKrx7dCVF7szeEZcx4oQCu9fnXO8AgI27d/kB9x8uFH","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":154885},"main":"dist/index.js","type":"module","module":"dist/index.js","engines":{"bun":">=1.1.0","node":">=18"},"gitHead":"4905d70e3000b3de8f7d988708ce360bca68bc1d","scripts":{"dev":"bun --watch src/index.ts","build":"tsup","start":"bun run src/index.ts","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"kahflane","email":"julfikaronthego@gmail.com"},"repository":{"url":"git+https://github.com/kahflane/whatsapp-mcp.git","type":"git"},"_npmVersion":"10.9.0","description":"WhatsApp MCP server built on the innovatorssoft Baileys fork + the Anthropic Model Context Protocol SDK. Runs on Node or Bun.","directories":{},"_nodeVersion":"22.12.0","dependencies":{"zod":"^3.23.8","pino":"^9.5.0","qrcode":"^1.5.4","better-sqlite3":"^12.10.0","@innovatorssoft/baileys":"^7.4.3","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","@types/bun":"latest","typescript":"^5.6.0","@types/qrcode":"^1.5.5","@types/better-sqlite3":"^7.6.13"},"_npmOperationalInternal":{"tmp":"tmp/whatsapp-mcp_0.2.0_1780204980299_0.027531943111344992","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@kahflane/whatsapp-mcp","version":"0.2.1","keywords":["whatsapp","mcp","mcp-server","model-context-protocol","baileys","ai-agents","claude","claude-code","codex","cursor","opencode","bun","node","npx"],"author":{"name":"kahflane"},"license":"MIT","_id":"@kahflane/whatsapp-mcp@0.2.1","maintainers":[{"name":"kahflane","email":"julfikaronthego@gmail.com"}],"homepage":"https://github.com/kahflane/whatsapp-mcp#readme","bugs":{"url":"https://github.com/kahflane/whatsapp-mcp/issues"},"bin":{"whatsapp-mcp":"dist/index.js"},"dist":{"shasum":"16c8379608c77e41107bf34a9a241905d1843aeb","tarball":"https://registry.npmjs.org/@kahflane/whatsapp-mcp/-/whatsapp-mcp-0.2.1.tgz","fileCount":6,"integrity":"sha512-XyMRB+SQw678nzqbeKtvkiJ89NQA6iMQetQG1deHiiubwOTFUO+lSMHH64RX2R1yX1ICkP3A/5JpqLT9kOTtHQ==","signatures":[{"sig":"MEQCIGbJ2igkL+Uk+kjzNceFiIDyQ8h9xXgy6pO+WsCp6sOCAiBBEExgdTTsjnQiWQDgSyTJ3RA1hvjGC2BmOcpjynXXtQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":155426},"main":"dist/index.js","type":"module","module":"dist/index.js","engines":{"bun":">=1.1.0","node":">=18"},"gitHead":"2e308791d341d1589ffa8ffae3f42a58cf4a520d","scripts":{"dev":"bun --watch src/index.ts","build":"tsup","start":"bun run src/index.ts","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"kahflane","email":"julfikaronthego@gmail.com"},"repository":{"url":"git+https://github.com/kahflane/whatsapp-mcp.git","type":"git"},"_npmVersion":"10.9.0","description":"WhatsApp MCP server built on the innovatorssoft Baileys fork + the Anthropic Model Context Protocol SDK. Runs on Node or Bun.","directories":{},"_nodeVersion":"22.12.0","dependencies":{"zod":"^3.23.8","pino":"^9.5.0","qrcode":"^1.5.4","better-sqlite3":"^12.10.0","@innovatorssoft/baileys":"^7.4.3","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","@types/bun":"latest","typescript":"^5.6.0","@types/qrcode":"^1.5.5","@types/better-sqlite3":"^7.6.13"},"_npmOperationalInternal":{"tmp":"tmp/whatsapp-mcp_0.2.1_1780206045014_0.5204161082627183","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@kahflane/whatsapp-mcp","version":"0.2.2","keywords":["whatsapp","mcp","mcp-server","model-context-protocol","baileys","ai-agents","claude","claude-code","codex","cursor","opencode","bun","node","npx"],"author":{"name":"kahflane"},"license":"MIT","_id":"@kahflane/whatsapp-mcp@0.2.2","maintainers":[{"name":"kahflane","email":"julfikaronthego@gmail.com"}],"homepage":"https://github.com/kahflane/whatsapp-mcp#readme","bugs":{"url":"https://github.com/kahflane/whatsapp-mcp/issues"},"bin":{"whatsapp-mcp":"dist/index.js"},"dist":{"shasum":"d28a63d986b9003588b8f9c1a7419d6b530df896","tarball":"https://registry.npmjs.org/@kahflane/whatsapp-mcp/-/whatsapp-mcp-0.2.2.tgz","fileCount":6,"integrity":"sha512-sK3vK/fuLQcXT6mU6W8wHK0yhXjL7k0J7knXWZyPX9GqiKUl3C7Q0u8JBBnzjPvxcms0ByXjiQKd/RlrXrkpeA==","signatures":[{"sig":"MEYCIQDiDF+T+maRp7xjUiq8Ls8I/IabjOjg44ni3O0sLthGHQIhAMzunrVPghTGQVTUt8r+sSc6vCMrdSlLU1ncMPw3W8aM","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":155395},"main":"dist/index.js","type":"module","module":"dist/index.js","engines":{"bun":">=1.1.0","node":">=18"},"gitHead":"6620afe44616262cf27c1e4068314dbbc5265839","scripts":{"dev":"bun --watch src/index.ts","build":"tsup","start":"bun run src/index.ts","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"kahflane","email":"julfikaronthego@gmail.com"},"repository":{"url":"git+https://github.com/kahflane/whatsapp-mcp.git","type":"git"},"_npmVersion":"10.9.0","description":"WhatsApp MCP server built on the innovatorssoft Baileys fork + the Anthropic Model Context Protocol SDK. Runs on Node or Bun.","directories":{},"_nodeVersion":"22.12.0","dependencies":{"zod":"^3.23.8","pino":"^9.5.0","qrcode":"^1.5.4","node-sqlite3-wasm":"^0.8.57","@innovatorssoft/baileys":"^7.4.3","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","@types/bun":"latest","typescript":"^5.6.0","@types/qrcode":"^1.5.5"},"_npmOperationalInternal":{"tmp":"tmp/whatsapp-mcp_0.2.2_1780207824964_0.8891870842658398","host":"s3://npm-registry-packages-npm-production"}},"0.2.3":{"name":"@kahflane/whatsapp-mcp","version":"0.2.3","keywords":["whatsapp","mcp","mcp-server","model-context-protocol","baileys","ai-agents","claude","claude-code","codex","cursor","opencode","bun","node","npx"],"author":{"name":"kahflane"},"license":"MIT","_id":"@kahflane/whatsapp-mcp@0.2.3","maintainers":[{"name":"kahflane","email":"julfikaronthego@gmail.com"}],"homepage":"https://github.com/kahflane/whatsapp-mcp#readme","bugs":{"url":"https://github.com/kahflane/whatsapp-mcp/issues"},"bin":{"whatsapp-mcp":"dist/index.js"},"dist":{"shasum":"9154e0f54d37b92690e5b43dc2cd8005e83e4e83","tarball":"https://registry.npmjs.org/@kahflane/whatsapp-mcp/-/whatsapp-mcp-0.2.3.tgz","fileCount":6,"integrity":"sha512-mWpq1+zgj3WxGyaYzTHVhj7SmnU3qhdO6IQHyWmBXJvfbGn6/9HYMNaHkMmR+O8dzU2Na4POX5QIIjO0xtp8gQ==","signatures":[{"sig":"MEQCIHA4JlOvXyhvxPg2wV6zqnYhFeq0q2R7nLkPpDR9bYvwAiA7AkAPdEYDDHii1HW8Ek/I2o57wQP8dLzZy7tZ5dS4LA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":157287},"main":"dist/index.js","type":"module","module":"dist/index.js","engines":{"bun":">=1.1.0","node":">=18"},"gitHead":"72e405266d667ced485e7c18d40d301a04dabfc5","scripts":{"dev":"bun --watch src/index.ts","build":"tsup","start":"bun run src/index.ts","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"kahflane","email":"julfikaronthego@gmail.com"},"repository":{"url":"git+https://github.com/kahflane/whatsapp-mcp.git","type":"git"},"_npmVersion":"10.9.0","description":"WhatsApp MCP server built on the innovatorssoft Baileys fork + the Anthropic Model Context Protocol SDK. Runs on Node or Bun.","directories":{},"_nodeVersion":"22.12.0","dependencies":{"zod":"^3.23.8","pino":"^9.5.0","qrcode":"^1.5.4","node-sqlite3-wasm":"^0.8.57","@innovatorssoft/baileys":"^7.4.3","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","@types/bun":"latest","typescript":"^5.6.0","@types/qrcode":"^1.5.5"},"_npmOperationalInternal":{"tmp":"tmp/whatsapp-mcp_0.2.3_1780213615263_0.8647337536870379","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-05-31T03:42:53.306Z","modified":"2026-05-31T07:55:00.395Z","0.1.0":"2026-05-31T03:42:53.570Z","0.2.0":"2026-05-31T05:23:00.457Z","0.2.1":"2026-05-31T05:40:45.168Z","0.2.2":"2026-05-31T06:10:25.104Z","0.2.3":"2026-05-31T07:46:55.412Z"},"bugs":{"url":"https://github.com/kahflane/whatsapp-mcp/issues"},"author":{"name":"kahflane"},"license":"MIT","homepage":"https://github.com/kahflane/whatsapp-mcp#readme","keywords":["whatsapp","mcp","mcp-server","model-context-protocol","baileys","ai-agents","claude","claude-code","codex","cursor","opencode","bun","node","npx"],"repository":{"url":"git+https://github.com/kahflane/whatsapp-mcp.git","type":"git"},"description":"WhatsApp MCP server built on the innovatorssoft Baileys fork + the Anthropic Model Context Protocol SDK. Runs on Node or Bun.","maintainers":[{"email":"julfikaronthego@gmail.com","name":"mjm918"}],"readme":"<div align=\"center\">\n\n# 📱 WhatsApp MCP\n\n**Give your AI agent a WhatsApp account.**\n\nRead, search, send, schedule, and manage WhatsApp — all through the [Model Context Protocol](https://modelcontextprotocol.io). 87 tools, one process (Node or Bun), your messages in local SQLite.\n\nWorks with **any MCP client** — Claude Code, Claude Desktop, Cursor, Windsurf, VS Code (Copilot), OpenAI Codex CLI, OpenCode, Cline, Zed, Goose, and more.\n\n[![Release](https://img.shields.io/github/v/release/kahflane/whatsapp-mcp?style=for-the-badge&logo=github)](https://github.com/kahflane/whatsapp-mcp/releases)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=for-the-badge)](LICENSE)\n[![Node](https://img.shields.io/badge/Node-18+-339933?style=for-the-badge&logo=node.js&logoColor=white)](https://nodejs.org)\n[![Bun](https://img.shields.io/badge/Bun-1.1+-000000?style=for-the-badge&logo=bun&logoColor=white)](https://bun.sh)\n[![MCP](https://img.shields.io/badge/MCP-compatible-6E56CF?style=for-the-badge)](https://modelcontextprotocol.io)\n\n</div>\n\n---\n\n> [!WARNING]\n> **Use a dedicated/burner number.** This is unofficial automation and violates WhatsApp's Terms of Service — your account *can* be banned. Never connect your primary line. New numbers should warm up slowly (~20 messages/day for the first week). You accept this risk.\n\n---\n\n## ✨ What you can do\n\nAsk your assistant things like:\n\n> *“What did the design team say in the group chat today?”*\n> *“Send the invoice template to +60123456789 with order #4471.”*\n> *“Schedule a birthday message to Rimu for 9am tomorrow.”*\n> *“Who voted for option B in yesterday's poll?”*\n> *“Post a status to my close friends with this photo.”*\n\nIt just works — your assistant drives WhatsApp on your behalf.\n\n## 🎯 Features\n\n| | |\n|---|---|\n| 💬 **Messaging** | Text, media, location, contacts, polls, events, reactions, edits, replies, forwards, pins |\n| 🔎 **Read & search** | Full-text search your whole history offline — chats, contacts, unread, media download |\n| 👥 **Groups** | Create, manage members, admin controls, invite links, join requests, metadata |\n| 📣 **Status / Story** | Rich text (backgrounds + fonts), image, video, gif, voice — to contacts **and** groups |\n| 🗂️ **Chat management** | Archive, pin, mute, star, mark read, disappearing messages |\n| 🔐 **Profile & privacy** | Name, about, avatar, block list, privacy settings, presence |\n| ⏰ **Automation** | Scheduled messages, reusable templates, keyword auto-replies |\n| 🧩 **Interactive** | Buttons, lists, and commerce (product/order) messages |\n| 🛡️ **Safety built-in** | Anti-ban send pacing, daily cap, and a one-flip **kill-switch** for all sends |\n\n**[→ See all 87 tools](#-tool-reference)**\n\n## 🚀 Quick start\n\n### 1. Add it to your agent\n\nNo install, no token, no path — `npx` (or `bunx`) fetches and runs it on demand. Pick your client below.\n\n> Requires [Node 18+](https://nodejs.org) (for `npx`) **or** [Bun](https://bun.sh) (for `bunx`). Using Bun instead? Swap `npx -y` for `bunx` in any command below.\n\n<details open>\n<summary><b>Claude Code</b></summary>\n\n```bash\nclaude mcp add whatsapp -- npx -y @kahflane/whatsapp-mcp\n```\n</details>\n\n<details>\n<summary><b>OpenAI Codex CLI</b></summary>\n\nAdd to `~/.codex/config.toml`:\n\n```toml\n[mcp_servers.whatsapp]\ncommand = \"npx\"\nargs = [\"-y\", \"@kahflane/whatsapp-mcp\"]\nenv = { WA_PAIRING_NUMBER = \"\", WA_SYNC_FULL_HISTORY = \"true\", WA_DAILY_CAP = \"100\" }\n```\n</details>\n\n<details>\n<summary><b>OpenCode</b></summary>\n\nAdd to `opencode.json` (or `~/.config/opencode/opencode.json`):\n\n```json\n{\n  \"mcp\": {\n    \"whatsapp\": {\n      \"type\": \"local\",\n      \"command\": [\"npx\", \"-y\", \"@kahflane/whatsapp-mcp\"],\n      \"enabled\": true\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary><b>Cursor / Windsurf / Cline / Zed</b></summary>\n\nThese read a JSON MCP block (Cursor: `~/.cursor/mcp.json`, Windsurf: `~/.codeium/windsurf/mcp_config.json`, Cline: its MCP settings, Zed: `settings.json` under `context_servers`):\n\n```json\n{\n  \"mcpServers\": {\n    \"whatsapp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@kahflane/whatsapp-mcp\"],\n      \"env\": { \"WA_PAIRING_NUMBER\": \"\", \"WA_SYNC_FULL_HISTORY\": \"true\", \"WA_DAILY_CAP\": \"100\" }\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary><b>Claude Desktop / VS Code Copilot / Goose / any other MCP client</b></summary>\n\nAdd the same server block to your client's config (Claude Desktop: `claude_desktop_config.json`, VS Code: `.vscode/mcp.json`, Goose: its extensions config):\n\n```json\n{\n  \"mcpServers\": {\n    \"whatsapp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@kahflane/whatsapp-mcp\"],\n      \"env\": {\n        \"WA_PAIRING_NUMBER\": \"\",\n        \"WA_SYNC_FULL_HISTORY\": \"true\",\n        \"WA_DAILY_CAP\": \"100\"\n      }\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary><b>Prefer to run from source?</b></summary>\n\n```bash\ngit clone https://github.com/kahflane/whatsapp-mcp.git\ncd whatsapp-mcp && bun install\n# then point your client at:  bun run /ABSOLUTE/PATH/TO/whatsapp/src/index.ts\n```\n</details>\n\n### 2. Log in\n\nRestart your MCP client, then just ask your assistant to connect:\n\n1. **“Check WhatsApp status”** → it calls `wa_status`.\n2. **“Show me the login QR”** → it calls `wa_get_login_qr`. Scan it in **WhatsApp ▸ Settings ▸ Linked Devices**.\n   *(Prefer a code? Set `WA_PAIRING_NUMBER` and ask for the pairing code instead.)*\n3. **“Check status again”** → reads `open`. Your history starts syncing into local SQLite.\n\nAuth persists — **you only do this once.** 🎉\n\n## 🧠 How it works\n\nOne process is *both* the MCP server and the WhatsApp client — a single long-lived WebSocket shared by every tool, with everything stored in local SQLite.\n\n```\n  Your AI assistant\n        │  stdio (JSON-RPC)\n        ▼\n┌──────────────────────────────────────────────┐\n│  whatsapp-mcp  (one Node/Bun process)         │\n│                                               │\n│   MCP Server  ◄──►  Baileys WhatsApp socket   │\n│        │                     │                 │\n│        └────────►  SQLite ◄──┘                 │\n│              (contacts · chats · messages)     │\n└──────────────────────────────────────────────┘\n```\n\n- **Local-first** — your full history lives on your machine in SQLite. Reading & search work offline.\n- **Private** — auth credentials and your message database never leave your computer.\n- **Safe by default** — every send is paced with jittered delays + a daily cap, and can be frozen instantly with the kill-switch.\n\n## ⚙️ Configuration\n\nAll optional, set via environment variables (see [`.env.example`](.env.example)):\n\n| Variable | Default | Description |\n|---|---|---|\n| `WA_PAIRING_NUMBER` | *(empty)* | Set a number to log in by code instead of QR |\n| `WA_SYNC_FULL_HISTORY` | `true` | Pull full chat history on first sync |\n| `WA_DAILY_CAP` | `100` | Max sends per day (anti-ban) |\n| `WA_MIN_GAP_MS` / `WA_MAX_GAP_MS` | — | Jittered delay window between sends |\n| `WA_DATA_DIR` | `~/.whatsapp-mcp` | Where auth, database + media live (`WA_AUTH_DIR` / `WA_DB_PATH` / `WA_MEDIA_DIR` default under it) |\n| `WA_LOG_LEVEL` | `warn` | Log verbosity (to stderr) |\n\n## 🧰 Tool reference\n\n<details>\n<summary><b>Connection & login</b></summary>\n\n| Tool | Description |\n|---|---|\n| `wa_status` | Connection, login state, store stats, send counters |\n| `wa_get_login_qr` · `wa_get_pairing_code` | First-time login |\n| `wa_logout` | Log out and wipe local auth |\n| `wa_restrict_sending` | 🛑 Kill-switch — block/allow all outbound sends |\n</details>\n\n<details>\n<summary><b>Reading & search</b> (works offline)</summary>\n\n| Tool | Description |\n|---|---|\n| `wa_list_chats` | List chats, newest first |\n| `wa_list_contacts` · `wa_resolve_name` | Contacts + name resolution |\n| `wa_get_messages` | Read a chat's full messages |\n| `wa_search_messages` | Full-text search your history |\n| `wa_get_unread` · `wa_mark_read` | Unread tracking + read receipts |\n| `wa_fetch_history` | Pull older history (50/call) |\n| `wa_history_status` | Sync progress |\n| `wa_download_media` | Download + decrypt media to a file |\n</details>\n\n<details>\n<summary><b>Sending</b></summary>\n\n| Tool | Description |\n|---|---|\n| `wa_check_number` | Verify numbers are on WhatsApp (anti-ban precheck) |\n| `wa_send_text` | Text with mentions / reply / typing |\n| `wa_send_media` | Image, video, audio, document, sticker |\n| `wa_send_location` · `wa_send_contact` | Location pin · contact card(s) |\n| `wa_send_poll` · `wa_get_poll_votes` | Send a poll · read decrypted vote tallies |\n| `wa_send_event` | Event card |\n| `wa_send_buttons` · `wa_send_list` | Interactive buttons + list messages |\n| `wa_react` · `wa_edit_message` · `wa_delete_message` | Modify messages |\n| `wa_forward_message` · `wa_pin_message` | Forward · pin in chat |\n| `wa_send_broadcast` · `wa_broadcast_info` | Broadcast to a list · query a list |\n| `wa_send_product` · `wa_send_order` | Commerce messages (Business accounts) |\n</details>\n\n<details>\n<summary><b>Status / Story</b></summary>\n\n| Tool | Description |\n|---|---|\n| `wa_post_status` | Post a story mentioning up to 5 contacts |\n| `wa_post_status_to` | Post to a chosen audience (contacts **and** groups) — text with rich backgrounds + fonts, image, video, gif, voice note, audio |\n</details>\n\n<details>\n<summary><b>Chat management</b></summary>\n\n| Tool | Description |\n|---|---|\n| `wa_archive_chat` · `wa_pin_chat` · `wa_mute_chat` | Archive · pin · mute (and undo) |\n| `wa_mark_chat_read` · `wa_star_message` | Mark read/unread · star a message |\n| `wa_delete_chat` · `wa_delete_message_for_me` | Delete chat · clear a message locally |\n| `wa_disappearing_chat` | Per-chat disappearing-message timer |\n</details>\n\n<details>\n<summary><b>Groups</b></summary>\n\n| Tool | Description |\n|---|---|\n| `wa_create_group` · `wa_groups_list` · `wa_group_metadata` | Create · list all · full metadata |\n| `wa_get_group_members` | Participants with names + admin flags |\n| `wa_group_participants` | Add / remove / promote / demote |\n| `wa_group_update_subject` · `wa_group_update_description` | Rename · set description |\n| `wa_group_setting` · `wa_group_add_mode` · `wa_group_ephemeral` | Announce-lock · who-can-add · disappearing |\n| `wa_group_invite_code` · `wa_group_join` · `wa_group_info_by_code` | Invite links · join · preview by code |\n| `wa_group_join_requests` · `wa_group_join_decision` | List · approve/reject requests |\n| `wa_group_member_label` · `wa_group_leave` | Label a member · leave group |\n</details>\n\n<details>\n<summary><b>Profile, privacy & presence</b></summary>\n\n| Tool | Description |\n|---|---|\n| `wa_set_name` · `wa_set_status` · `wa_set_picture` · `wa_remove_picture` | Manage your own profile |\n| `wa_block` · `wa_blocklist` | Block/unblock · list blocked |\n| `wa_get_privacy` · `wa_set_privacy` · `wa_default_disappearing` | Read/set privacy + default timer |\n| `wa_get_status` · `wa_get_picture_url` · `wa_get_business_profile` | Someone's about · avatar · business profile |\n| `wa_subscribe_presence` · `wa_send_presence` | Subscribe to · broadcast presence |\n</details>\n\n<details>\n<summary><b>Calls · Scheduling · Templates · Auto-reply</b></summary>\n\n| Tool | Description |\n|---|---|\n| `wa_reject_call` | Reject an incoming call |\n| `wa_schedule_message` · `wa_list_scheduled` · `wa_cancel_scheduled` | Schedule sends (persisted, fires exactly once) |\n| `wa_list_templates` · `wa_render_template` · `wa_create_template` · `wa_send_template` | Reusable message templates |\n| `wa_autoreply_set` · `wa_autoreply_add_rule` · `wa_autoreply_list_rules` · `wa_autoreply_remove_rule` | Keyword/pattern auto-replies (off by default) |\n</details>\n\n## 💡 Good to know\n\n- **Only one server may run at a time** — it owns the auth dir + database. After changing config, restart your MCP client to respawn it.\n- **History** arrives in chunks after login; `wa_fetch_history` pages older messages 50 at a time (WhatsApp may not always relay on-demand history to linked devices).\n- **Pacing reduces, not eliminates, ban risk.** Respect the daily cap and warm up new numbers slowly.\n- **Auto-reply is OFF by default.** Enable it explicitly with `wa_autoreply_set`.\n\n## 🛠️ Tech\n\n[Node](https://nodejs.org) · [Bun](https://bun.sh) · [node-sqlite3-wasm](https://github.com/tndrle/node-sqlite3-wasm) · [bun:sqlite](https://bun.sh/docs/api/sqlite) · [@innovatorssoft/baileys](https://github.com/innovatorssoft/Baileys) · [Anthropic MCP SDK](https://github.com/modelcontextprotocol/typescript-sdk) · TypeScript\n\n## 🤝 Contributing\n\nIssues and PRs welcome. Run `bun run typecheck` and `bun run build` before submitting — they're the verification gates.\n\n## 📄 License\n\n[MIT](LICENSE) © KahfLane\n\n<div align=\"center\">\n<sub>Not affiliated with or endorsed by WhatsApp or Meta. Use responsibly and at your own risk.</sub>\n</div>\n","readmeFilename":"README.md"}