DOCUMENTATION

Meta Business MCP

WhatsApp Compliance Intelligence Platform for AI Agents. 24 MCP tools. Sub-2ms decisions. Zero violations.

Get running in 60 seconds — No Meta API keys required for local dev.

git clone https://github.com/metabusiness-mcp/meta-business-mcp.git
cd meta-business-mcp
docker compose up -d --build

What It Does

CapabilityDescription
Compliance GateEvaluates every message against Meta’s care window rules, opt-out lists, and frequency caps
Policy EnforcementCustom business policies (time boundaries, segment exclusions, VIP overrides)
Async DeliveryNATS JetStream queue with automatic retries and exponential backoff
Rate LimitingPer-customer token-bucket via Redis Lua scripts
Error IntelligenceEvery Meta API error decoded with context, cause, and recovery path
Campaign ManagementSchedule, pause, cancel with audience segmentation
Template LifecycleCreate, sync, validate via Meta API
MCP Server24 structured tools over stdio

Explore the Docs

Quick Start →
Get running in 60 seconds with Docker Compose.
🏗️
Architecture →
System design, DB schema, queue topology.
📡
API Reference →
All 24 MCP tools with request/response examples.
⚙️
Configuration →
Environment variables and config.yaml reference.
🧑‍💻
Developer Guide →
Extend policies, add tools, contribute.
🚀
Deployment →
Docker Compose, production setup, Railway.
📋
Limitations →
Known limits and what’s coming next.

Tech Stack

LayerTechnology
LanguageGo 1.21+
DatabasePostgreSQL 16
CacheRedis 7
QueueNATS JetStream
ProtocolMCP (Model Context Protocol)
LicenseApache 2.0