Whapi MCP

What is Whapi MCP? Whapi MCP is a Model Context Protocol (MCP) server for Whapi Cloud (a WhatsApp API provider). It extends WhatsApp capabilities (messaging, groups, channels, stories) by exposing Whapi OpenAPI operations as tools for MCP-capable clients and AI agents.

How to use Whapi MCP?

• Requirements: Node.js 18+.
• Quick start: run with NPX: npx -y whapi-mcp@latest
• Or set your Whapi API token and run: (PowerShell) $env:API_TOKEN=“YOUR_TOKEN”; npx -y whapi-mcp@latest
• Configure MCP clients by adding a server entry (example shown for Cursor and Claude Desktop) that runs npx -y whapi-mcp@latest and passes API_TOKEN in env.
• Use exposed tools (generated from Whapi OpenAPI) to call WhatsApp operations (example tool: sendMessageText with arguments {“to":"...@s.whatsapp.net”,“body”:“Hello”}).
• Optional: install the WHAPI Agent Skill to teach agents chat ID formats, MCP setup, webhook configuration, message types and safe broadcast patterns: npx skills add Whapi-Cloud/whapi-agent-skills

Key features

• MCP server exposing Whapi OpenAPI as callable tools for agents and apps
• Support for messaging, groups, channels and stories via Whapi.Cloud API
• Easy NPX-based launch and environment-token authentication
• Prebuilt integration/snippets for MCP clients (Cursor, Claude Desktop)
• Optional agent skill to reduce common configuration mistakes
• MIT license

Use cases

1. Automating WhatsApp messaging workflows (notifications, support responses, reminders)
2. Enabling AI agents to send and manage WhatsApp messages and broadcasts safely
3. Integrating WhatsApp groups, channels and stories into agent-driven applications
4. Rapid prototyping of WhatsApp integrations using NPX and MCP clients

FAQ

• Q: What do I need to run it? A: Node.js 18+ and a Whapi.Cloud API token (set API_TOKEN env or provide via MCP client config).
• Q: How do agents call WhatsApp actions? A: The server exposes tools generated from Whapi OpenAPI (e.g., sendMessageText). Agents call those tool names with the required arguments.
• Q: Is there built-in guidance for agent usage? A: Yes — install the WHAPI Agent Skill (npx skills add Whapi-Cloud/whapi-agent-skills) to get structured guidance on IDs, webhooks, message types and safe broadcast patterns.
• Q: Is the project open source / free? A: The repo is MIT licensed; usage may require a Whapi.Cloud account and API token per Whapi.Cloud terms.
• Q: Which MCP clients are supported out of the box? A: Examples and configs are provided for Cursor and Claude Desktop; other MCP clients can be configured similarly by invoking npx with the proper env.