HTTPv1.0.0Credential RequiredJan 22, 2026

Documentation

Guide

CL-WhatsApp

Stateless MCP Server for WhatsApp integrations.

This project exposes WhatsApp tools that can be used by an AI agent, automation workflow, or client application using the Model Context Protocol (MCP).

Features

send_whatsapp_message
send_whatsapp_template
Fully stateless architecture
Mock mode enabled (no WhatsApp API key required)
Easy to switch to real WhatsApp Cloud API later

Prerequisites

Make sure the following are installed:

Python 3.10+
pip (comes with Python)

Check Python version:

python --version
 
Project Structure
pgsql
Copy code
CL-WhatsApp/
├── server.py
├── auth.py
├── requirements.txt
├── test.py
├── .env
└── tools/
    ├── schemas.py
    ├── handlers.py
    └── tool_registry.py
How to Run (Client Instructions)
Step 1️⃣ Navigate to Project Directory
bash
Copy code
cd CL-WhatsApp
Step 2️⃣ Install Dependencies
bash
Copy code
pip install -r requirements.txt
Step 3️⃣ Start the MCP Server
bash
Copy code
python server.py
Expected output:
 
text
Copy code
CL-WhatsApp MCP Server Ready
Step 4️⃣ Test the Tools (Mock Mode)
bash
Copy code
python test.py

Connect

Get connection URL

https://gateway.mewcp.com/whatsapp/mcp

Request Builder

import asyncio
from fastmcp import Client

# Real MewCP gateway URL for this server
GATEWAY_URL = "https://gateway.mewcp.com/whatsapp/mcp"
API_KEY = "YOUR_API_KEY"

headers={
    "Authorization": f"Bearer {API_KEY}"
}

async def main():
    
    client = Client(GATEWAY_URL, headers=headers)
    
    async with client:
        # Test the connection by pinging the server
        await client.ping()
        
        # List available operations
        tools = await client.list_tools()
        resources = await client.list_resources()
        prompts = await client.list_prompts()

        # Execute operations
        result = await client.call_tool("example_tool", {"param": "value"})
        print(result)

asyncio.run(main())