# TalkToPlanB

> TalkToPlanB is a free, secure WhatsApp alternative with real-time group and direct messaging, voice messages, file sharing, and a built-in AI assistant (powered by Claude). It runs on Android and in any web browser, syncs phone and web in real time, and hosts data in Malaysia. It also offers an open developer REST API, webhooks, and an MCP server so AI assistants can send and read messages.

TalkToPlanB is best for people and communities who want an independent, private messenger they control — with an AI assistant built in — and for developers or AI agents that need a messaging channel.

## Pages
- [Home](https://talktoplanb.duckdns.org/): Overview, features, and FAQ.
- [Web App](https://talktoplanb.duckdns.org/app): Use TalkToPlanB in any browser.
- [TalkToPlanB vs WhatsApp](https://talktoplanb.duckdns.org/vs-whatsapp): Honest feature, privacy, and API comparison.
- [Developer API docs](https://talktoplanb.duckdns.org/api/docs): Interactive REST API documentation.
- [OpenAPI spec](https://talktoplanb.duckdns.org/api/v1/openapi.json): Machine-readable API definition.
- [Developer Portal](https://talktoplanb.duckdns.org/portal): Self-service API keys and webhooks.

## Features
- Real-time group and direct messaging
- Voice messages (hold-to-send or tap-to-toggle)
- Photo and file sharing
- Built-in AI assistant (ManBot, powered by Claude)
- Phone and web real-time sync
- HTTPS-encrypted in transit; data hosted in Malaysia / Singapore
- Free to use; invite-code access

## For AI agents and developers
- REST API with API-key auth (X-API-Key header): send messages, list rooms, read messages.
- Webhooks for incoming messages.
- MCP server: run `npx talktoplanb-mcp` — tools: send_message, list_rooms, read_messages, whoami.
- Compatible with agentic AI frameworks (e.g. OpenClaw, Hermes Agent).

## Contact
- Developer portal: https://talktoplanb.duckdns.org/portal