io.github.wazionapps/mcp-server

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.