Wazionapps MCP

WAzion MCP Server

Connect your AI assistant to WAzion — the WhatsApp Business platform with AI copilot, automated workflows, mass marketing, CRM, and more. This MCP server exposes 240+ tools that let any MCP-compatible client manage your WhatsApp Business operations through natural language.

---

Quick Start

Method 1: Direct HTTP (recommended — no install needed)

WAzion's MCP endpoint supports Streamable HTTP transport, so most clients can connect directly without installing anything.

Claude Code:

claude mcp add --transport http wazion https://www.wazion.com/api/mcp/ \

--header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop (claude_desktop_config.json):

{

"mcpServers": { "wazion": { "type": "url", "url": "https://www.wazion.com/api/mcp/", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }

Method 2: npm package (for stdio-only clients)

If your client only supports stdio transport, use the npm package as a bridge:

npx -y @wazion/mcp-server

Requires the WAZION_API_KEY environment variable to be set.

---

Setup by Client

Claude Code

claude mcp add --transport http wazion https://www.wazion.com/api/mcp/ \

--header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop

Add to your claude_desktop_config.json:

{

"mcpServers": { "wazion": { "type": "url", "url": "https://www.wazion.com/api/mcp/", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }

ChatGPT

In ChatGPT settings, go to Connectors and add a new Streamable HTTP connection:

• URL: https://www.wazion.com/api/mcp/
• Authentication: Bearer token with your API key

Cursor

Create or edit .cursor/mcp.json in your project root:

{

"mcpServers": { "wazion": { "type": "url", "url": "https://www.wazion.com/api/mcp/", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }

Windsurf / VS Code

Add to your settings.json:

{

"mcp.servers": { "wazion": { "type": "url", "url": "https://www.wazion.com/api/mcp/", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }

Any stdio-only Client

For clients that only support stdio transport (no HTTP), use the npm package:

WAZION_API_KEY=your_key npx -y @wazion/mcp-server

Or in your client's configuration:

{

"mcpServers": { "wazion": { "command": "npx", "args": ["-y", "@wazion/mcp-server"], "env": { "WAZION_API_KEY": "YOUR_API_KEY" } } } }

---

Available Tools

WAzion exposes 244 tools across 24 categories. Here are the main ones:

---

Getting Your API Key

1. Sign up at wazion.com
2. Connect your WhatsApp number by scanning the QR code
3. Go to Settings > Developer and copy your API key

Your API key is the same token used for the dashboard. It uniquely identifies your shop and its configuration.

---

Environment Variables

---

Examples

Once connected, you can ask your AI assistant things like:

Send a message:

"Send a WhatsApp message to +34612345678 saying: Your order has been shipped!"

Check conversations:

"Show me my most recent conversations from today"

Create an automation:

"Create a workflow that auto-replies with AI when a customer sends a message outside business hours"

Run a campaign:

"Start a mass marketing campaign to my VIP list with the message: Exclusive 20% discount this weekend!"

Analyze performance:

"Give me a summary of this week's activity — messages, response times, and sentiment"

---

Confirmations

Actions that modify data (deleting workflows, removing agents, clearing lists, etc.) use a two-step confirmation flow:

1. The first call returns a warning describing what will happen
2. A second call with confirm: true executes the action

This prevents accidental destructive operations. Your AI client handles this automatically.

---

Self-Hosted

WAzion can be self-hosted on your own infrastructure. If you're running a self-hosted instance, set the WAZION_API_URL environment variable to point to your server:

WAZION_API_URL=https://your-instance.example.com/api/mcp/

All tools work identically with self-hosted installations.

---

Troubleshooting

"Unauthorized" or 401 errors

• Verify your API key is correct (Settings > Developer in the dashboard)
• Make sure the Authorization: Bearer header is properly formatted
• Check that your account is active

Connection timeout

• Ensure https://www.wazion.com is accessible from your network
• If behind a proxy, configure your HTTP client accordingly
• For stdio transport, check that Node.js >= 18 is installed

Tools not showing up

• Confirm the MCP server is connected (check your client's MCP status)
• Restart your AI client after adding the configuration
• Verify the API key has not been rotated

WhatsApp messages not sending

• Check that your WhatsApp session is connected (scan QR if needed)
• Verify you have sufficient credits in your account
• Ensure the phone number includes the country code (e.g., +34612345678)

---

Links

• WAzion Website
• API Documentation
• Developer Integration Guide
• GitHub Issues

---

License

MIT - see LICENSE for details.