Wazionapps

io.github.wazionappsPublished by GitHub account wazionappsv1.0.1Updated Oct 24, 2026

244 WhatsApp Business AI tools for messaging, automation, marketing, CRM and Shopify

Overview

AI-generated overview

Connects an AI assistant to WAzion, a WhatsApp Business platform, exposing 240+ tools for messaging, campaigns, automation, CRM and Shopify.

What you can do
  • Send WhatsApp messages, run workflows and manage session and connection status
  • Create and run bulk marketing campaigns, contact lists and unsubscribe handling
  • Build automation triggers, AI replies and scheduled messages; tune AI prompts and models
  • Search customers, conversations, tasks, calendar events and activity summaries
  • Manage agents, plugins, knowledge base documents, cloud storage files and webhooks
  • Read statistics, AI sentiment analysis, account, billing and referral data
When to use it
Use it when you run a WhatsApp Business operation on WAzion and want an assistant to send messages, launch campaigns, build automations or pull conversation and performance data in natural language.
Requirements
A WAzion account with a connected WhatsApp number and an API key from Settings > Developer, supplied as WAZION_API_KEY or as a Bearer token header. The npm package needs Node.js 18 or newer; network access to the WAzion endpoint is required. An optional WAZION_API_URL points at a self-hosted instance.
Before you install
The API key is the same token used for the dashboard and identifies your shop, so treat it as a sensitive credential. Many tools send messages, launch campaigns, delete workflows or agents, and clear lists; destructive actions use a two-step confirm flow. Sending messages consumes account credits, and customer conversation data is processed by the WAzion service.

Installation

In SourceWeft

  1. Open Wazionapps in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

WAzion 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:

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:

bash
npx -y @wazion/mcp-server

Requires the WAZION_API_KEY environment variable to be set.


Setup by Client

Claude Code

bash
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:

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:

json
{  "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:

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:

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

Or in your client's configuration:

json
{  "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:

CategoryToolsDescription
Mass Marketing39WhatsApp bulk campaigns, contact lists, send configuration, unsubscribe management, and campaign statistics
WhatsApp Operations27Session status, message logs, send messages, workflow execution, and connection management
Plugins18Product Q&A, web chat, document Q&A — install, configure, and monitor plugins
Automation16WhatsApp Auto workflows — create triggers, conditions, AI replies, and scheduled messages
Statistics15Conversation metrics, response times, agent performance, and usage analytics
General Settings13Language, timezone, date format, Shopify integration, and business preferences
Customers13Customer info, notes, tags, search, alerts, and conversation history
AI Prompt12System prompt, custom instructions, AI model settings, and response behavior
Storage12Upload, list, delete, and manage files in cloud storage
Agents11Create, edit, and manage support agents with roles and permissions
Conversations9Search, view, and analyze customer conversations
Activity8Daily and weekly summaries, trends, and operational metrics
AI Analysis7Sentiment analysis, conversation summaries, and AI-powered insights
Advanced6Webhooks, custom functions (function calling), and CRM endpoints
Smart Follow-up6AI-driven purchase intent detection and automated follow-up messages
Tasks6Customer tasks and reminders with assignments and due dates
Integrations5Shopify connection, external services, and third-party platforms
Notifications5System notifications management and preferences
Calendar4Events and scheduled appointments linked to customers
Knowledge Base3Upload and manage documents for AI-powered answers
Account3Account details, billing, and subscription information
Referrals3Referral program — generate links and track commissions
Products2Product search and query statistics
Support1Contact 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

VariableRequiredDescription
WAZION_API_KEYYesYour WAzion API key (from Settings > Developer)
WAZION_API_URLNoCustom 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:

bash
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.

Source: README.md at commit ad5f897

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts