{ "markdown": "# WAzion MCP Server\n\n\n\n\n[![npm version](https://img.shields.io/npm/v/@wazion/mcp-server.svg)](https://www.npmjs.com/package/@wazion/mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org)\n\nConnect your AI assistant to [WAzion](https://www.wazion.com) — 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.\n\n---\n\n## Quick Start\n\n### Method 1: Direct HTTP (recommended — no install needed)\n\nWAzion's MCP endpoint supports [Streamable HTTP transport](https://modelcontextprotocol.io/docs/concepts/transports#streamable-http), so most clients can connect directly without installing anything.\n\n**Claude Code:**\n```bash\nclaude mcp add --transport http wazion https://www.wazion.com/api/mcp/ \\\n --header \"Authorization: Bearer YOUR_API_KEY\"\n```\n\n**Claude Desktop** (`claude_desktop_config.json`):\n```json\n{\n \"mcpServers\": {\n \"wazion\": {\n \"type\": \"url\",\n \"url\": \"https://www.wazion.com/api/mcp/\",\n \"headers\": {\n \"Authorization\": \"Bearer YOUR_API_KEY\"\n }\n }\n }\n}\n```\n\n### Method 2: npm package (for stdio-only clients)\n\nIf your client only supports stdio transport, use the npm package as a bridge:\n\n```bash\nnpx -y @wazion/mcp-server\n```\n\nRequires the `WAZION_API_KEY` environment variable to be set.\n\n---\n\n## Setup by Client\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http wazion https://www.wazion.com/api/mcp/ \\\n --header \"Authorization: Bearer YOUR_API_KEY\"\n```\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"wazion\": {\n \"type\": \"url\",\n \"url\": \"https://www.wazion.com/api/mcp/\",\n \"headers\": {\n \"Authorization\": \"Bearer YOUR_API_KEY\"\n }\n }\n }\n}\n```\n\n### ChatGPT\n\nIn ChatGPT settings, go to **Connectors** and add a new Streamable HTTP connection:\n\n- **URL:** `https://www.wazion.com/api/mcp/`\n- **Authentication:** Bearer token with your API key\n\n### Cursor\n\nCreate or edit `.cursor/mcp.json` in your project root:\n\n```json\n{\n \"mcpServers\": {\n \"wazion\": {\n \"type\": \"url\",\n \"url\": \"https://www.wazion.com/api/mcp/\",\n \"headers\": {\n \"Authorization\": \"Bearer YOUR_API_KEY\"\n }\n }\n }\n}\n```\n\n### Windsurf / VS Code\n\nAdd to your `settings.json`:\n\n```json\n{\n \"mcp.servers\": {\n \"wazion\": {\n \"type\": \"url\",\n \"url\": \"https://www.wazion.com/api/mcp/\",\n \"headers\": {\n \"Authorization\": \"Bearer YOUR_API_KEY\"\n }\n }\n }\n}\n```\n\n### Any stdio-only Client\n\nFor clients that only support stdio transport (no HTTP), use the npm package:\n\n```bash\nWAZION_API_KEY=your_key npx -y @wazion/mcp-server\n```\n\nOr in your client's configuration:\n\n```json\n{\n \"mcpServers\": {\n \"wazion\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@wazion/mcp-server\"],\n \"env\": {\n \"WAZION_API_KEY\": \"YOUR_API_KEY\"\n }\n }\n }\n}\n```\n\n---\n\n## Available Tools\n\nWAzion exposes **244 tools** across 24 categories. Here are the main ones:\n\n| Category | Tools | Description |\n|----------|------:|-------------|\n| **Mass Marketing** | 39 | WhatsApp bulk campaigns, contact lists, send configuration, unsubscribe management, and campaign statistics |\n| **WhatsApp Operations** | 27 | Session status, message logs, send messages, workflow execution, and connection management |\n| **Plugins** | 18 | Product Q&A, web chat, document Q&A — install, configure, and monitor plugins |\n| **Automation** | 16 | WhatsApp Auto workflows — create triggers, conditions, AI replies, and scheduled messages |\n| **Statistics** | 15 | Conversation metrics, response times, agent performance, and usage analytics |\n| **General Settings** | 13 | Language, timezone, date format, Shopify integration, and business preferences |\n| **Customers** | 13 | Customer info, notes, tags, search, alerts, and conversation history |\n| **AI Prompt** | 12 | System prompt, custom instructions, AI model settings, and response behavior |\n| **Storage** | 12 | Upload, list, delete, and manage files in cloud storage |\n| **Agents** | 11 | Create, edit, and manage support agents with roles and permissions |\n| **Conversations** | 9 | Search, view, and analyze customer conversations |\n| **Activity** | 8 | Daily and weekly summaries, trends, and operational metrics |\n| **AI Analysis** | 7 | Sentiment analysis, conversation summaries, and AI-powered insights |\n| **Advanced** | 6 | Webhooks, custom functions (function calling), and CRM endpoints |\n| **Smart Follow-up** | 6 | AI-driven purchase intent detection and automated follow-up messages |\n| **Tasks** | 6 | Customer tasks and reminders with assignments and due dates |\n| **Integrations** | 5 | Shopify connection, external services, and third-party platforms |\n| **Notifications** | 5 | System notifications management and preferences |\n| **Calendar** | 4 | Events and scheduled appointments linked to customers |\n| **Knowledge Base** | 3 | Upload and manage documents for AI-powered answers |\n| **Account** | 3 | Account details, billing, and subscription information |\n| **Referrals** | 3 | Referral program — generate links and track commissions |\n| **Products** | 2 | Product search and query statistics |\n| **Support** | 1 | Contact WAzion support |\n\n---\n\n## Getting Your API Key\n\n1. **Sign up** at [wazion.com](https://www.wazion.com)\n2. **Connect** your WhatsApp number by scanning the QR code\n3. Go to **Settings** > **Developer** and copy your API key\n\nYour API key is the same token used for the dashboard. It uniquely identifies your shop and its configuration.\n\n---\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `WAZION_API_KEY` | Yes | Your WAzion API key (from Settings > Developer) |\n| `WAZION_API_URL` | No | Custom endpoint URL (default: `https://www.wazion.com/api/mcp/`). Use this for self-hosted instances. |\n\n---\n\n## Examples\n\nOnce connected, you can ask your AI assistant things like:\n\n**Send a message:**\n> \"Send a WhatsApp message to +34612345678 saying: Your order has been shipped!\"\n\n**Check conversations:**\n> \"Show me my most recent conversations from today\"\n\n**Create an automation:**\n> \"Create a workflow that auto-replies with AI when a customer sends a message outside business hours\"\n\n**Run a campaign:**\n> \"Start a mass marketing campaign to my VIP list with the message: Exclusive 20% discount this weekend!\"\n\n**Analyze performance:**\n> \"Give me a summary of this week's activity — messages, response times, and sentiment\"\n\n---\n\n## Confirmations\n\nActions that modify data (deleting workflows, removing agents, clearing lists, etc.) use a two-step confirmation flow:\n\n1. The first call returns a warning describing what will happen\n2. A second call with `confirm: true` executes the action\n\nThis prevents accidental destructive operations. Your AI client handles this automatically.\n\n---\n\n## Self-Hosted\n\nWAzion 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:\n\n```bash\nWAZION_API_URL=https://your-instance.example.com/api/mcp/\n```\n\nAll tools work identically with self-hosted installations.\n\n---\n\n## Troubleshooting\n\n### \"Unauthorized\" or 401 errors\n- Verify your API key is correct (Settings > Developer in the dashboard)\n- Make sure the `Authorization: Bearer` header is properly formatted\n- Check that your account is active\n\n### Connection timeout\n- Ensure `https://www.wazion.com` is accessible from your network\n- If behind a proxy, configure your HTTP client accordingly\n- For stdio transport, check that Node.js >= 18 is installed\n\n### Tools not showing up\n- Confirm the MCP server is connected (check your client's MCP status)\n- Restart your AI client after adding the configuration\n- Verify the API key has not been rotated\n\n### WhatsApp messages not sending\n- Check that your WhatsApp session is connected (scan QR if needed)\n- Verify you have sufficient credits in your account\n- Ensure the phone number includes the country code (e.g., +34612345678)\n\n---\n\n## Links\n\n- [WAzion Website](https://www.wazion.com)\n- [API Documentation](https://www.wazion.com/en/help/dashboard/advanced/crm-endpoints/)\n- [Developer Integration Guide](https://www.wazion.com/en/help/dashboard/advanced/developer-integration-guide/)\n- [GitHub Issues](https://github.com/wazionapps/mcp-server/issues)\n\n---\n\n## License\n\nMIT - see [LICENSE](LICENSE) for details.\n", "bytes": 8753, "sha": "674fbca632df6c20c0e9961621ccf8bbe34bef8442e8831158bc4e408ef231b9", "repo_slug": "wazionapps/mcp-server", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_wazionapps_mcp_server_cc5acecf/readme" }