wazionapps/mcp-server

npm version License: MIT Node.js

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:

Category	Tools	Description
Mass Marketing	39	WhatsApp bulk campaigns, contact lists, send configuration, unsubscribe management, and campaign statistics
WhatsApp Operations	27	Session status, message logs, send messages, workflow execution, and connection management
Plugins	18	Product Q&A, web chat, document Q&A — install, configure, and monitor plugins
Automation	16	WhatsApp Auto workflows — create triggers, conditions, AI replies, and scheduled messages
Statistics	15	Conversation metrics, response times, agent performance, and usage analytics
General Settings	13	Language, timezone, date format, Shopify integration, and business preferences
Customers	13	Customer info, notes, tags, search, alerts, and conversation history
AI Prompt	12	System prompt, custom instructions, AI model settings, and response behavior
Storage	12	Upload, list, delete, and manage files in cloud storage
Agents	11	Create, edit, and manage support agents with roles and permissions
Conversations	9	Search, view, and analyze customer conversations
Activity	8	Daily and weekly summaries, trends, and operational metrics
AI Analysis	7	Sentiment analysis, conversation summaries, and AI-powered insights
Advanced	6	Webhooks, custom functions (function calling), and CRM endpoints
Smart Follow-up	6	AI-driven purchase intent detection and automated follow-up messages
Tasks	6	Customer tasks and reminders with assignments and due dates
Integrations	5	Shopify connection, external services, and third-party platforms
Notifications	5	System notifications management and preferences
Calendar	4	Events and scheduled appointments linked to customers
Knowledge Base	3	Upload and manage documents for AI-powered answers
Account	3	Account details, billing, and subscription information
Referrals	3	Referral program — generate links and track commissions
Products	2	Product search and query statistics
Support	1	Contact WAzion support

---

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

Variable	Required	Description
WAZION_API_KEY	Yes	Your WAzion API key (from Settings > Developer)
WAZION_API_URL	No	Custom endpoint URL (default: https://www.wazion.com/api/mcp/). Use this for self-hosted instances.

---

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.