AM

ararahq/mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

3 stars 0 forks 质量 78 趋势 18MIT

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.
在 GitHub 查看完整 README

安装

npx -y @ararahq/mcp --stdio
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "ararahq": { "command": "npx", "args": ["-y", "@ararahq/mcp", "--stdio"] } } }