Back to Docs
MCP Server
Connect AI agents directly to WhatsApp
Pro & Business30+ toolsJSON-RPC 2.0
Prerequisites
- 1.A Wazen account on the Pro or Business plan
- 2.An API key from your Dashboard → Developers page
- 3.At least one connected WhatsApp session
Setup Guide
Open Claude Desktop → Settings → Developer → Edit Config. Add the following to your claude_desktop_config.json:
{
"mcpServers": {
"wazen": {
"type": "http",
"url": "https://wazen.dev/mcp",
"headers": {
"Authorization": "Bearer wz_your_api_key_here"
}
}
}
}Replace wz_your_api_key_here with your actual API key. Restart Claude Desktop after saving. The type: "http" tells Claude Desktop to connect directly via HTTP — no additional packages needed.
Example Usage
Once connected, you can ask your AI agent things like:
“Send a WhatsApp message to +1234567890 saying 'Hello from AI'”
“List all my WhatsApp sessions and their status”
“Check if +1234567890 is on WhatsApp”
“Create a webhook for message.received events”
“Start warming my new WhatsApp session”
Available Tools (52)
Sessions
7- create_session
- list_sessions
- get_session
- delete_session
- restart_session
- get_qr_code
- factory_reset_session
Messages
3- send_message
- get_messages
- get_message
Groups
14- list_groups
- create_group
- get_group
- update_group
- leave_group
- manage_participants
- send_group_message
- get_group_invite
- revoke_group_invite
- join_group
- get_group_invite_info
- update_group_settings
- list_group_requests
- handle_group_requests
Channels
10- create_channel
- get_channel
- update_channel
- delete_channel
- send_to_channel
- fetch_channel_messages
- follow_channel
- unfollow_channel
- mute_channel
- unmute_channel
Contacts
2- check_contact
- bulk_check_contacts
Warming
5- start_warming
- get_warming_status
- pause_warming
- resume_warming
- cancel_warming
Webhooks
5- list_webhooks
- create_webhook
- update_webhook
- delete_webhook
- test_webhook
Account
3- get_account
- get_usage
- cancel_subscription
API Keys
3- create_api_key
- list_api_keys
- revoke_api_key