WALoops MCP Server
# WALoops MCP Server — WhatsApp OTP & WhatsApp Business automation for AI assistants
WALoops is a **remote, hosted MCP server** that gives your AI coding assistant WhatsApp tools: send and verify OTPs, manage conversations, build automation drafts, send approved templates, and more.
**Nothing to install.** The server runs at `https://app.waloops.com/api/mcp.php` and speaks the [MCP Streamable HTTP](https://modelcontextprotocol.io) protocol. Point your client at that URL, add your API key as a header, and start building.
---
## Features
- Send and verify WhatsApp (or SMS) OTPs from the WALoops number -- no Meta account needed for the free tier
- Read dashboard stats, conversations, and campaign data
- List, create, and submit WhatsApp templates for Meta approval
- Build automation drafts (trigger + action + conditions + delays) that are always saved switched OFF for your review
- Install proven ready-made automation recipes as safe drafts
- Pause live automations
- All store tokens and secrets stay server-side and are never returned to the AI
---
## Quick start
**Get a free key** at [app.waloops.com/register](https://app.waloops.com/#/register?plan=wp-otp-free&src=github) -- 100 WhatsApp OTPs/month, no credit card required.
The server can initialize, list tools, and run `get_started` with no key at all. A key is only needed for tools that send or read account data.
---
## Install configs
### Claude Code
```bash
claude mcp add --transport http waloops https://app.waloops.com/api/mcp.php --header 'X-API-Key: YOUR_KEY'
```
### Claude Desktop
Add to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"waloops": {
"command": "npx",
"args": [
"mcp-remote",
"https://app.waloops.com/api/mcp.php",
"--header",
"X-API-Key: YOUR_KEY"
]
}
}
}
```
### Cursor
Add to `.cursor/mcp.json`:
```json
{
"mcpServers": {
"waloops": {
"url": "https://app.waloops.com/api/mcp.php",
"headers": {
"X-API-Key": "YOUR_KEY"
}
}
}
}
```
### VS Code
Add to `.vscode/mcp.json`:
```json
{
"servers": {
"waloops": {
"type": "http",
"url": "https://app.waloops.com/api/mcp.php",
"headers": {
"X-API-Key": "YOUR_KEY"
}
}
}
}
```
### Windsurf
Add to your Windsurf MCP config:
```json
{
"mcpServers": {
"waloops": {
"serverUrl": "https://app.waloops.com/api/mcp.php",
"headers": {
"X-API-Key": "YOUR_KEY"
}
}
}
}
```
---
## Tools
| Tool | Key required | Description |
|------|-------------|-------------|
| `get_started` | None | Explains WALoops setup, key types, available tool groups, API docs, and example OTP requests |
| `send_otp` | Free OTP key | Sends a one-time code to a phone number via WhatsApp or SMS from the WALoops number |
| `verify_otp` | Free OTP key | Verifies a previously sent OTP using the recipient's phone number and code |
| `get_otp_usage` | Free OTP key | Reads OTP usage and limits for the API key |
| `list_templates` | Advance plan | Lists your approved WhatsApp templates and their variables |
| `send_template` | Advance plan | Sends an approved WhatsApp template message to a phone number |
| `get_dashboard_stats` | Advance plan | Returns messages, conversations, automations, and plan usage overview |
| `list_conversations` | Advance plan | Lists and searches inbox conversations |
| `get_conversation_messages` | Advance plan | Lists messages in a conversation |
| `list_automations` | Advance plan | Lists automations, or fetches one automation with its run stats |
| `list_connected_apps` | Advance plan | Lists connected apps (Shopify, WooCommerce, etc.) with available event triggers |
| `list_actions` | Advance plan | Lists every action an automation can run: WhatsApp, Shopify, WooCommerce, webhooks, bot flows, tags |
| `list_recipes` | Advance plan | Lists proven ready-made automations that can be installed as safe drafts |
| `list_bot_flows` | Advance plan | Lists bot flows available as automation actions |
| `list_tags` | Advance plan | Lists tags available as automation actions |
| `list_campaigns` | Advance plan | Lists campaigns, or fetches one campaign by id |
| `create_template` | Advance plan | Creates a WhatsApp template and submits it to Meta for approval |
| `pause_automation` | Advance plan | Switches an automation off |
| `create_automation_draft` | Advance plan | Creates an automation as a draft, saved switched off, named "[AI draft] ..." |
| `install_recipe_draft` | Advance plan | Installs a recipe as a switched-off draft for the owner to review |
---
## Example prompts
1. "Send a login OTP to +91 98765 43210 for my app at https://myapp.com and verify the code 482910."
2. "Show me my WhatsApp OTP usage this month."
3. "List my approved WhatsApp templates and send the order_confirmation one to +44 7700 900000."
4. "Create an automation draft that sends a WhatsApp message when a new Shopify order is placed -- use a 10-minute delay."
5. "Show me the last 20 conversations in my inbox and summarise any unread ones."
---
## Security
- Your API key is passed per request as the `X-API-Key` header and is never stored or logged by the MCP layer.
- Automation drafts are always saved switched off and named "[AI draft] ..." -- nothing runs until you review and enable it inside the WALoops app.
- The AI can only pause automations, not delete them.
- Connected app tokens and secrets stay server-side and are never returned to the AI.
---
## Pricing
Free OTP keys include 100 WhatsApp OTPs/month with no credit card. Advance plan keys unlock the full Business automation toolset.
See all plans at [waloops.com/pricing](https://waloops.com/pricing).
---
## Links
- MCP server page: [waloops.com/mcp](https://waloops.com/mcp)
- Support: support@waloops.com
TDQS
Scored across 20 tools
Most tools target clearly distinct resources and actions, and descriptions distinguish e.g. custom automation drafts from recipe drafts. There is some overlap among the automation-building reference tools, especially list_actions versus list_bot_flows/list_tags, but not enough to cause serious misselection.
Tool names consistently use snake_case with a predictable verb_noun or verb_noun_detail structure. Deviations like get_started are minor and do not break the overall pattern.
Twenty tools is somewhat heavy, but the server spans several distinct areas: OTP, templates, campaigns, conversations, dashboard, and automations. Each tool has a plausible role, though the automation reference tools could likely be consolidated.
Core OTP and safe automation-draft workflows are well covered, but there are notable gaps: campaigns are list-only, templates lack update/delete, and conversations lack a reply/send-message operation. These gaps may force the agent to fall back to the WALoops app for common lifecycle actions.