MCP Server — your AI agent operates your WhatsApp: say who and what, Arara does the rest (10 tools)
概览
Official Model Context Protocol server for AraraHQ: talk to your whole WhatsApp base, see what came back, answer who replied. Node.js is the only implementation, OAuth is the authentication boundary, and both the npm scope and public repository are owned by AraraHQ: @ararahq/mcp and ararahq/mcp. Nine everyday tools, on purpose. An agent works better with a few actions that accept what a person knows by heart (a name, a phone in any format) and resolve the rest. Automations (flows that react to a trigger and send on their own) add nine more: Resources (arara://organization, arara://templates/approved, arara://campaigns/recent, arara://channels) give read-only context without a tool call. Prompts plan_broadcast, campaign_review and reply_to_responses package the three everyday flows and always stop for approval before a write. Every tool returns both human-readable content and stable structured content. Write tools carry MCP safety annotations.
README
以下为原文 README 节选,完整内容请查看原文。
AraraHQ MCP
Official Model Context Protocol server for AraraHQ: talk to your whole WhatsApp base, see what came back, answer who replied.
Node.js is the only implementation, OAuth is the authentication boundary, and both the npm scope and public repository are owned by AraraHQ: @ararahq/mcp and ararahq/mcp.
What it exposes
Nine everyday tools, on purpose. An agent works better with a few actions that accept what a person knows by heart (a name, a phone in any format) and resolve the rest.
| Tool | What it does |
|---|---|
whoami |
Who is authenticated, which organization sends, plan and wallet balance. |
send_whatsapp |
One message to one person: free text inside the 24h window, or an approved template with variables any time. |
broadcast |
One approved template to up to 1000 people as a campaign. Dry run by default (preview and cost), A/B and scheduling. |
campaign_report |
Recent campaigns, or the full report of one: sent, delivered, read, clicked, replied, converted, blocked, cost. |
check_status |
Did it arrive? Is the 24h window open? Was the template approved? |
create_template |
Submit a template for Meta approval, with header, footer, samples and up to 2 buttons. |
save_contacts |
Create or update up to 1000 contacts so you can message by name. |
opt_out |
Record that someone asked to stop. Every later send to them is blocked. |
read_conversation |
The raw message timeline with one person, newest first, so you can judge a reply before answering. |
Automations (flows that react to a trigger and send on their own) add nine more:
| Tool | What it does |
|---|---|
list_automations |
Every automation with trigger, steps, active state, cost per run and run stats. Trigger URLs are left out. |
get_automation |
One automation in full, including its trigger URLs, which are secrets for the user’s own system. |
list_automation_templates |
Approved templates a step may use, with unit price and charge button, plus the price of a session message. |
安装
npx -y @ararahq/mcp --stdio配置
{
"mcpServers": {
"ararahq": {
"command": "npx",
"args": ["-y", "@ararahq/mcp", "--stdio"]
}
}
}