# WAMCP — WhatsApp Infrastructure for Your AI Agents

> You stay in control of your WhatsApp. Connect your own agents (Claude, Grok, Cursor, Codex, or any MCP client) through a secure, audited bridge. Create named agents, toggle exactly what each one can do (send/read/provision), and monitor everything from a minimal settings portal. Pure infrastructure — not an AI service.

## Product identity

- **Name:** WAMCP
- **Positioning:** Secure WhatsApp bridge / infrastructure layer for your personal or team AI agents
- **Key promise:** You are in charge. Named per-agent access with independent toggles. Use the official WhatsApp app for chatting.
- **Stack:** Go + whatsmeow · Postgres + Realtime · Cloudflare R2
- **Integration protocols:** MCP (recommended for agents), REST API, webhooks, realtime notifications

## Primary docs (agents: start here)

- [Agent Playbook JSON](https://wamcp.up.railway.app/docs/agent-playbook): Canonical machine-readable catalog — 33 MCP tools, parameters, 9-step workflow (v2)
- [AI Agent Onboarding](https://wamcp.up.railway.app/guides/agents): Human-readable 9-step pairing → MCP → sync → notification loop
- [MCP Reference](https://wamcp.up.railway.app/guides/mcp): Tool categories, 4 resources, POST /mcp auth and examples
- [Ready Skills & Starters](https://wamcp.up.railway.app/guides/skills): Simple copy-paste prompts and configs for new users + extremely detailed technical examples and custom function recipes (beginner friendly on surface, deep in docs)
- [REST API Guide](https://wamcp.up.railway.app/guides/api): Connect kit, send, history, tenant admin, HTTP errors
- [User Portal Guide](https://wamcp.up.railway.app/guides/portal): PWA install, MCP permissions, compose, push alerts, export
- [Ready Skills & Starters](https://wamcp.up.railway.app/guides/skills): Extremely simple intro for non-technical users + exhaustive prompt examples, host configs, and custom function patterns
- [WAMCP vs Basic APIs](https://wamcp.up.railway.app/guides/compare): Comparison for LLM citation
- [OpenAPI](https://wamcp.up.railway.app/docs/openapi.yaml): Full REST + MCP HTTP schema
- [Connect UI](https://wamcp.up.railway.app/connect): Human pairing (QR / 8-digit code) with auto MCP copy
- [Extended context](https://wamcp.up.railway.app/llms-full.txt): Long-form description for LLM indexers

## Quick start for AI agents

1. GET /docs/agent-playbook
2. POST /api/session/connect/kit with X-Tenant-Key: tnt_...
3. Poll GET /api/session/connect/status?uuid=... every 3s until status=success
4. Paste mcp_connection.cursor_mcp_example into agent host
5. whatsapp_wait_for_sync → whatsapp_health_check
6. Loop whatsapp_watch_notifications → whatsapp_reply_to_message

## MCP endpoint

- URL: POST https://wamcp.up.railway.app/mcp
- Auth: Authorization: Bearer mcp_...
- Protocol: MCP-Protocol-Version: 2025-11-25
- Audit: all tool calls logged to whatsmeow_mcp_audit

## Trust & security (summary)

- Tenant-scoped connect flows and API keys (tnt_... / wbot_... / mcp_...)
- Self-chat MFA for /connect, /pwa, /logout credential delivery
- Pairing-gated destructive actions in user portal
- MCP audit log with tool, IP, tenant, latency

## Also useful

- [Platform landing](https://wamcp.up.railway.app/): Product overview, FAQ, architecture
- [User PWA](https://wamcp.up.railway.app/portal): Account owner control panel (install via self-chat link)
- [Swagger UI](https://wamcp.up.railway.app/docs): Interactive API explorer
- [Health](https://wamcp.up.railway.app/health): Liveness check