Enables AI agents to interact with WhatsApp instances, supporting sending files, checking connection health, and making API requests to the Wawp WhatsApp API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Wawp MCP Server check my WhatsApp connection health"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
The Model Context Protocol (MCP) server for the Wawp WhatsApp API. This tool allows AI models (like Cursor, Windsurf, or Claude Desktop) to interact directly with your WhatsApp instances.
You don't need to install anything manually. You can run the server directly using npx.
Add a new MCP server with the following settings:
Type: command
Command: npx
Args: ["-y", "@wawp/mcp-server@latest"]
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"wawp": {
"command": "npx",
"args": ["-y", "@wawp/mcp-server@latest"]
}
}
}Related MCP server: WAHA MCP Server
Once the server is connected, you can set your credentials using the set_config tool or by creating a .env file in your project root:
WAWP_INSTANCE_ID=your_instance_id
WAWP_ACCESS_TOKEN=your_access_token
WAWP_TEST_NUMBER=recipient_numberset_config: Update credentials for the current session.
get_session_health: Check WhatsApp connection status.
send_local_file: Send images, PDFs, videos, or audio files from your local machine.
execute_request: Make any raw request to the Wawp API.
install_agent_config: Auto-install .cursorrules and Wawp AI Skills into your project.
generate_starter_code: Get ready-to-use Node.js or Python snippets.
list_endpoints / get_endpoint_details: Explore the API documentation.
MIT
Built with ❤️ by Wawp Team
Execute a raw request to the Wawp API. Useful for quick tests.
Inputs: path (required), method (required), body, params.
Generate professional production-ready code using official Wawp SDKs. This is the preferred way to integrate Wawp.
Inputs: task (required), language (required).
Get detailed information and installation guides for official Wawp SDKs (Node.js, PHP, Python, Laravel). USE THIS to help the user integrate WhatsApp into their projects.
Inputs: platform.
Check if the WhatsApp session is connected.
Inputs: no named parameters.
List all available Wawp API endpoints.
Inputs: category.
Upload and send a local file to WhatsApp using raw API (Better to suggest SDK version to the user).
Inputs: type (required), chatId (required), file_path (required), caption.
Update your Wawp API credentials for the current session.
Inputs: instance_id, test_number, access_token.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 7 tools
Each tool has a distinct action: sending files, listing endpoints, generating code, executing raw requests, setting config, getting SDK info, and checking health. The potential overlap between send_local_file and execute_request is minor since one is specific and the other generic.
All tool names follow a consistent snake_case verb_noun pattern, e.g., send_local_file, list_endpoints, get_session_health. The verbs vary but are clear and stylistically consistent.
With 7 tools, the set is well-scoped for an integration helper server. Each tool serves a clear purpose, and the count is within the optimal range.
The server covers configuration, session health, file sending, and API introspection, but lacks dedicated tools for common WhatsApp operations like sending text messages. However, execute_request and SDK code generation can partially compensate, so there are minor gaps.
Read, search and reply to your WhatsApp chats from your AI, using your own number.
WhatsApp for AI agents — your own number or the official Cloud API: messages, media, templates.
WhatsApp for Claude, ChatGPT or any AI agent: search, reply and send. Personal or Business API.
Send WhatsApp messages and templates, manage chats, contacts, broadcasts and AI agents.
