WizMessage MCP Server for AI Agents

WizMessage runs a remote MCP (Model Context Protocol) server, so the AI assistants and agents you already use (Claude, ChatGPT, Cursor, VS Code, n8n and others) can work with your WhatsApp Business inbox in WizMessage. Your agent can read conversations, reply inside WhatsApp's 24-hour customer service window, send your approved message templates, and assign, close or mark conversations as read. WizMessage is built on the official WhatsApp Business Platform (Cloud API).

• Server URL: https://wizmessage.com/mcp (Streamable HTTP transport; MCP protocol versions from 2025-06-18 to 2026-07-28 are supported).
• Sign-in: a WizMessage API key with the Allow AI agents (MCP) permission. Send it in an X-API-Key header, or as Authorization: Bearer followed by the key.
• Who can create keys: only the workspace owner. Each key works with one WhatsApp number.
• Plan: an active Wiz Pro plan, the same plan that includes the WizMessage API.

• In WizMessage, open API Management, choose Connect your software, pick Custom / Other and name the connection. The template and replies steps are optional. Copy the API key when it is shown: it is displayed only once.
• Back in API Management, open the new key with Manage, click Edit, and go to the Overview tab.
• Turn on Allow AI agents (MCP), then only the permissions your agent needs: Read the inbox, Assign and close conversations, View Templates, and the send permissions (Send Text Messages, Send Template Messages, Send Media Messages).
• Turn off Require request signing. AI clients send the key alone and cannot sign requests, so the MCP server refuses keys that require signing.
• Click Save Changes. Keep the key secret: anyone who has it can act on this number within the permissions you chose. Revoke it in API Management if it leaks.

• Claude (claude.ai and Claude Desktop): open Settings, then Customize, Connectors, Add, Add custom connector. Enter the name WizMessage and the URL https://wizmessage.com/mcp, click Continue, choose No sign-in, then under Request headers add x-api-key with your key as the value, and click Add.
• Claude Code: run claude mcp add --transport http wizmessage https://wizmessage.com/mcp --header "X-API-Key: YOUR_KEY"
• Cursor, VS Code, Windsurf and other MCP clients: add a remote (HTTP) server with the URL https://wizmessage.com/mcp and a header named X-API-Key whose value is your key.
• OpenAI Responses API and Agents SDK: add an MCP tool with server_url https://wizmessage.com/mcp and a header Authorization: Bearer YOUR_KEY.
• n8n and other automation tools: use the MCP Client node or tool with HTTP Streamable transport, the same URL, and a header X-API-Key.

• list_whatsapp_numbers: the WhatsApp number this key can use.
• list_conversations: inbox conversations, newest first, filtered by status, unread, assignment or a search term.
• get_conversation: the messages in one conversation, and until when a free-form reply is allowed.
• get_message_status: whether a sent message was delivered, read or failed, with the reason.
• list_team_members: teammates a conversation can be assigned to.
• update_conversation: assign a conversation, open or close it, or mark it as read.
• list_templates and get_template: your approved message templates, their language and the values they need.
• send_text_message: a free-form reply inside the 24-hour customer service window.
• send_media_message: an image, video, document or audio file from a public HTTPS link.
• send_template_message: an approved template, which can start or reopen a conversation.

• An agent can start a conversation only with numbers that have messaged your business before, or with contacts a person on your team added. Unsubscribed and blocked contacts are never messaged.
• Free-form messages are allowed only inside WhatsApp's 24-hour customer service window. After that, only an approved template can be sent.
• Messages containing more than 3 phone numbers or email addresses, or a link shortener, are refused.
• Each key is limited to 120 requests a minute, 300 sent messages a day, and 300 conversation reads an hour.
• Text written by your contacts is returned marked as untrusted content, so your agent can treat it as data rather than as instructions.
• Messages an agent sends appear in your WizMessage inbox and mobile app like any other message, and your outbound webhooks receive them with source "mcp".

When you connect an AI client, the data your agent reads (messages, contact names and phone numbers, templates) is sent to the AI provider you chose and is handled under that provider's terms. WizMessage does not use your WhatsApp data to train AI models and does not sell it. You can cut off an agent at any time by disabling or deleting its key in API Management. The full details are in the WizMessage Privacy Policy: https://wizmessage.com/pages/privacy-policy

• 401 Unauthorized: the key is missing, mistyped, expired or deleted.
• 403 Forbidden: the key does not have the Allow AI agents (MCP) permission or still requires request signing, the Wiz Pro plan has ended, or the WhatsApp number is not active.
• "The 24-hour window is closed": the contact has not written to you in the last 24 hours. Send an approved template instead.
• 429 Too Many Requests: a rate limit was reached. Wait for the time in the Retry-After header.
• Payment error from WhatsApp (131042): Meta reports a problem with the payment method on your WhatsApp Business account. Add or fix it in Meta Business Settings, then clear the send block in WizMessage.

Questions or problems with the MCP server: email [email protected] with the time of the request and the tool name. Never include your API key.