
WSAPI MCP Server
WSAPI MCP Server
·
A Model Context Protocol (MCP) server for WSAPI - the WhatsApp API Gateway. Enables LLMs to send messages, manage contacts and groups, handle communities and newsletters, post status updates, and more through WhatsApp.
For comprehensive documentation, see the WSAPI MCP Server guide.
Note: This project is not affiliated with, associated with, or endorsed by WhatsApp or Meta.
Add to your Claude Desktop configuration:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"wsapi": {
"command": "npx",
"args": ["@wsapichat/mcp-server"],
"env": {
"WSAPI_API_KEY": "your_api_key_here",
"WSAPI_INSTANCE_ID": "your_instance_id_here",
"WSAPI_ENABLED_CATEGORIES": "messaging,contacts"
}
}
}
}claude mcp add wsapi -- npx @wsapichat/mcp-server \
--env WSAPI_API_KEY=your_api_key_here \
--env WSAPI_INSTANCE_ID=your_instance_id_here \
--env WSAPI_ENABLED_CATEGORIES=messaging,contactsThe server exposes 80+ tools across 12 categories. To reduce context window usage, you can filter which tools are loaded using environment variables.
Load only messaging and contact tools:
WSAPI_ENABLED_CATEGORIES=messaging,contactsAvailable categories: messaging, contacts, groups, chats, session, users, communities, newsletters, status, calls, media
Load only specific tools:
WSAPI_ENABLED_TOOLS=whatsapp_send_text,whatsapp_send_image,whatsapp_get_contactsUse categories as a base set and add individual tools from other categories:
WSAPI_ENABLED_CATEGORIES=messaging
WSAPI_ENABLED_TOOLS=whatsapp_get_contacts,whatsapp_get_chatsIf neither variable is set, all tools are loaded.
| Variable | Required | Default | Description |
|---|---|---|---|
WSAPI_API_KEY | Yes | - | Your WSAPI API key |
WSAPI_INSTANCE_ID | Yes | - | Your WSAPI instance ID |
WSAPI_BASE_URL | No | https://wsapi.chat | WSAPI base URL |
WSAPI_ENABLED_CATEGORIES | No | (all) | Comma-separated tool categories to load |
WSAPI_ENABLED_TOOLS | No | (all) | Comma-separated tool names to load |
LOG_LEVEL | No | info | Logging level (error, warn, info, debug) |
git clone https://github.com/wsapi-chat/wsapi-mcp
cd wsapi-mcp
npm install
cp .env.example .env # Edit with your credentials
npm run build
npm startMIT - see LICENSE for details.
The source covers 101 WhatsApp operations; Cloud Account/subscription and OSS admin APIs are outside this integration's scope. Changes in this working tree have not been published. See CHANGELOG.md.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add wsapi -- npx @wsapichat/mcp-server{
"mcpServers": {
"wsapi": {
"env": {
"WSAPI_API_KEY": "",
"WSAPI_INSTANCE_ID": "",
"WSAPI_ENABLED_CATEGORIES": ""
},
"args": [
"@wsapichat/mcp-server"
],
"command": "npx"
}
}
}code --add-mcp '{"name":"wsapi","env":{"WSAPI_API_KEY":"","WSAPI_INSTANCE_ID":"","WSAPI_ENABLED_CATEGORIES":""},"args":["@wsapichat/mcp-server"],"command":"npx"}'[mcp_servers.wsapi]
command = "npx"
args = ["@wsapichat/mcp-server"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/wsapi-mcp to learn what the "Wsapi Mcp" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add wsapi -- npx @wsapichat/mcp-serverThis server runs locally, so we can't read its tool list over the web yet.
We could not run this server: its npm package has not answered in our offline sandbox, which usually means it needs an API key or other configuration to start. The four checks that need a live server are left out, and the grade tops out at B until we can read its tools.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/wsapi-mcp)Nothing comparable is listed yet.
v3.1.0Release notesv3.0.0Release notesv2.0.0Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "wsapi-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.