A MCP server that provides an API to interact with WhatsApp
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"iflow-mcp-whatsapp-mcp-server","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# WhatsApp MCP Server A server that provides a Model Context Protocol (MCP) interface to interact with WhatsApp Business API using FastMCP. ## Introduction WhatsApp MCP Server is a Python implementation that enables language models like Claude to interact with WhatsApp functionality through [GreenAPI](https://green-api.com/). It leverages FastMCP for improved performance, better developer experience, and a cleaner implementation. ## Features - **Messaging**: Send text messages to WhatsApp contacts - **Group Management**: Create groups, list members, add/remove participants - **Session Handling**: Manage WhatsApp API sessions - **Chat History**: Retrieve chat lists and message history ## WhatsApp API Client This project uses the `whatsapp-api-client-python` library to interact with WhatsApp. The client provides access to the WhatsApp Cloud API, which requires a [GreenAPI](https://green-api.com/) account to use. ### Environment Variables This project uses environment variables for configuration: - `GREENAPI_ID_INSTANCE`: Your GreenAPI ID instance - `GREENAPI_API_TOKEN`: Your GreenAPI API token You can either set these in your environment or use the provided `.env` file (see Installation instructions). ## Installation ```bash # Clone the repository git clone https://github.com/yourusername/whatsapp-mcp-server.git cd whatsapp-mcp-server # Install dependencies pip install -e . # Set up environment variables cp .env-template .env # Edit the .env file with your GreenAPI credentials ``` ## Usage Run the MCP server: ```bash # Run the MCP server on default host (127.0.0.1) and port (8000) whatsapp-mcp # Specify host and port whatsapp-mcp --host 0.0.0.0 --port 9000 ``` For debugging: ```bash whatsapp-mcp --debug ``` The server communicates using the Model Context Protocol (MCP) and can be accessed via HTTP or WebSockets when running with FastMCP. ### Available Tools - `open_session`: Open a new WhatsApp session - `send_message`: Send a message to a cha…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.