Ararahq MCP
MCP Server β plug AraraHQ into Claude, Cursor, and AI agents (19 tools)
Ask AI about Ararahq MCP
Powered by Claude Β· Grounded in docs
I know everything about Ararahq MCP. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Arara MCP Server
This MCP server transforms any AI (Claude, Cursor, etc.) into a Revenue Operating System powered by AraraHQ and AbacatePay. Send WhatsApp messages, recover failed payments, run campaigns, and manage your entire communication stack β all through natural language.
The 5 Pillars
- Autonomous Revenue Recovery β Scan for failed payments and recover revenue automatically
- Atomic Negotiation β Create payment links and send them via WhatsApp in a single call
- Guardian Mode β Brand safety firewall that blocks sensitive content in all outbound messages
- Business Memory Layer β Customer intelligence with sentiment analysis and LTV estimation
- Mass Orchestration β Campaign dispatch with response triage and auto-handling
Tools (19 total)
Guardian Mode (Pillar 3)
| Tool | Description |
|---|---|
configure_guardian_policy | Set custom brand safety rules for the session. Built-in rules (CPF, CVV, passwords, API keys) are always active |
Messaging
| Tool | Description |
|---|---|
send_smart_message | Send a WhatsApp message to a single recipient. Guardian mode screens content before dispatch |
send_batch_messages | Send up to 1,000 WhatsApp messages in a single call with Guardian mode screening |
upload_media | Upload media (image, PDF, video) to Arara storage from a public URL. Returns short URL for use in messages |
Revenue Recovery (Pillar 1)
| Tool | Description |
|---|---|
autonomous_recovery | Scan AbacatePay for revenue leaks (pending/expired/cancelled checkouts), enrich with WhatsApp history, and return action briefing with total R$ at risk |
check_revenue_leaks | Quick scan for AbacatePay revenue leaks. For full briefing with customer context, use autonomous_recovery instead |
Negotiation & Payments (Pillar 2)
| Tool | Description |
|---|---|
atomic_negotiation_cycle | Full negotiation in one call: creates product on AbacatePay, generates checkout, sends payment link via WhatsApp, returns all tracking IDs |
negotiate_payment | Create a product and checkout link on AbacatePay. For full atomic cycle that also sends via WhatsApp, use atomic_negotiation_cycle |
confirm_payment_handshake | Verify real-time payment status of an AbacatePay checkout |
Business Memory (Pillar 4)
| Tool | Description |
|---|---|
build_business_memory | Deep customer intelligence: analyzes conversation history for sentiment, estimates LTV from payment history, builds structured profile, and optionally persists to knowledge base |
manage_knowledge_base | Read and write the AI brain knowledge base. Used by build_business_memory to persist customer profiles |
Campaigns (Pillar 5)
| Tool | Description |
|---|---|
create_campaign | Dispatch a template campaign to a segmented list with individual variables per recipient |
monitor_campaign_responses | Fetch and triage inbound responses. Classifies as URGENT / COMPLAINT / QUESTION / POSITIVE / ROUTINE. Auto-handles routine, escalates critical |
Platform Management
| Tool | Description |
|---|---|
get_account_overview | Full account snapshot: wallet balance, delivery metrics, total spend, delivery rate |
manage_templates | Full template lifecycle: list, create, check approval status, view analytics, delete |
manage_messages | List messages from the dashboard or get status of a specific message by ID |
manage_conversations | List active conversations, get full message history, or reply in an open session window |
manage_organization | Manage organization settings: phone numbers, webhook config, AI brain, team members |
manage_api_keys | List, create, or revoke Arara API keys |
Authentication & Security
Two hosting models:
- Private Hosting β Set
ARARA_API_KEYandABACATE_API_KEYin your environment. The server uses these for all requests. - Public Hosting (mcp.ararahq.com) β Users provide their own
apiKeyto each tool call.
All tools accept an optional apiKey parameter which overrides environment variables.
Installation
Hosted (Recommended)
No local install needed. Connect directly to our hosted instance.
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"ararahq": {
"url": "https://mcp.ararahq.com/sse",
"headers": {
"X-Arara-Key": "YOUR_ARARA_API_KEY"
}
}
}
}
Cursor
Go to Settings > Models > MCP Servers and add a new SSE server:
- Name: AraraHQ
- URL:
https://mcp.ararahq.com/sse
Local (Private)
Run locally using npx:
{
"mcpServers": {
"ararahq": {
"command": "npx",
"args": ["-y", "ararahq-mcp"],
"env": {
"ARARA_API_KEY": "YOUR_KEY_HERE",
"ABACATE_API_KEY": "YOUR_KEY_HERE"
}
}
}
}
Docker
docker build -t ararahq-mcp .
docker run -p 3333:3333 -e PORT=3333 ararahq-mcp
Local Development
npm run build
node build/index.js --transport sse
Server runs on http://localhost:3333 by default.
Usage Examples
- "Check who didn't pay their Pix yesterday on AbacatePay and send a reminder via WhatsApp."
- "Generate a payment link for R$50 for customer X with a 10% discount and send it."
- "Run a campaign with the welcome template to all contacts imported today."
- "Show me my account overview β wallet balance and delivery rate."
- "What is the sentiment history of customer Y before I respond?"
Contributing
See CONTRIBUTING.md for guidelines.
License
MIT - AraraHQ
