WAzion MCP Server

![npm version](https://www.npmjs.com/package/@wazion/mcp-server) ![License: MIT](LICENSE) ![Node.js](https://nodejs.org)

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: ``bash claude mcp add --transport http wazion https://www.wazion.com/api/mcp/ \ --header "Authorization: Bearer YOUR_API_KEY" ``

Claude Desktop (claude_desktop_config.json): ``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

Sign up at wazion.com
Connect your WhatsApp number by scanning the QR code
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:

The first call returns a warning describing what will happen
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

---

License

MIT - see LICENSE for details.

mcp-server