Repository navigation
Releases
Releases · FelixIsaac/whatsapp-mcp-extended
v0.4.0
Highlights
- Decrypt incoming poll votes, preserve each voter's current selection, and expose poll results through the authenticated bridge API (#84).
- Return structured message context and contact data from MCP tools, with corrected Python types (#81).
- Resolve downloaded media paths against the bridge's store location (#86).
- Update AnyIO, PyJWT, urllib3, brace-expansion, Next.js, and Gradio dependencies (#82, #87, #88, #89, #90, #91). The Gradio client pin is updated to the version required by Gradio 6.16.0.
- Patch additional high-severity web dependency alerts and update the Go security workflow's toolchain.
The Python MCP server version is now 0.4.0.
v0.3.0 — Session Reliability & Security Hardening
What's New
Session Reliability
- LoggedOut/StreamReplaced watchdog — bridge now calls
MarkDisconnected()on logout events so the watchdog goroutine detects the broken state and Dockerrestart: unless-stoppedbrings it back automatically - QR/connect timeout watchdog — both the 3-minute QR scan timeout and 30-second reconnect timeout now call
MarkDisconnected(), eliminating hung containers that required manual restarts - Event-driven connect — replaced
time.Sleep(2s)with a properevents.Connectedchannel wait (30s timeout) on existing-session startup - SQLite WAL mode —
whatsapp.dbandmessages.dbnow use_journal_mode=WAL&_busy_timeout=5000for safe concurrent reads during bridge writes UseRetryMessageStore = true— retry receipts persist across restarts, preventing message dedup failures after crashesSetForceActiveDeliveryReceipts(true)— delivery receipts sent even when not explicitly marked online- whatsmeow bumped to
v0.0.0-20260602— fixes 405 Client Outdated errors reported by community
Security
API_BIND_HOSTdefaults to127.0.0.1— bridge REST API no longer binds to all interfaces by default (closes #215)- CORS hardened —
127.0.0.1variants added alongsidelocalhostso browser IP-based requests work without wildcards - Docker: external port already bound to
127.0.0.1:8180;API_BIND_HOST=0.0.0.0set only inside the internal Docker network
Connection Webhooks
- New
connection_eventwebhook payload fires onconnected,disconnected,logged_out,pair_success,pair_error needs_pairingfield added to/api/healthand/api/statusresponses- Circuit breaker callback fires before AutoReconnect gives up (30 consecutive failures)
- Presence ping interval configurable via
PRESENCE_PING_INTERVALenv var (default20m, was hardcoded3m)
MCP Server
- DB path resolution centralized in
lib/utils.py— single source of truth formessages.dbandwhatsapp.dbpaths - Fail-loudly on missing
messages.dbat import time (setWA_SKIP_DB_CHECK=1to bypass in tests)
Docker / Setup
- Fixed bootstrapping deadlock:
web-uinow usesdepends_on: service_startedinstead ofservice_healthy— UI starts immediately so you can scan QR when bridge needs pairing - New
setup.ps1— Windows one-shot setup (Docker Desktop, Task Scheduler jobs, uv sync, .env bootstrap) - New
Makefile—make pair PHONE=+60...,make status,make reconnect,make logs
Upgrade Notes
- If upgrading from v0.2.x: rebuild images (
docker compose build && docker compose up -d) - New env vars (all optional):
API_BIND_HOST,PRESENCE_PING_ENABLED,PRESENCE_PING_INTERVAL,WA_STORE_PATH,WA_SKIP_DB_CHECK - Docker Compose:
API_BIND_HOST=0.0.0.0is set automatically indocker-compose.yamlfor inter-container access