Zapr

Zapr Link WhatsApp MCP Client

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "fcavalcantirj-zapr-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "zapr-mcp",
        "zapr-mcp"
      ],
      "env": {
        "ZAPR_API_HOST": "https://api.zapr.link",
        "ZAPR_SESSION_ID": "YOUR_SESSION_ID"
      }
    }
  }
}

Zapr MCP Server lets you send WhatsApp messages through Claude Desktop and other MCP-compatible clients. It exposes a simple, standards-based interface so you can trigger single or bulk messages, validate numbers, and check session status from your MCP workflow.

How to use

Connect your MCP client to the Zapr MCP Server to send WhatsApp messages. You run the server locally (or in your environment) and point your MCP client to it. The server provides a set of tools to send messages, validate numbers, and monitor session status.

Typical usage involves starting the server and then calling its available tools from your MCP client: send a message to one or more recipients, validate a phone number, or check the current session status. The server ensures automatic session authentication and rate limiting as needed to keep your messaging flow reliable.

How to install

pip install zapr-mcp

Or, for a streamlined run with a local runner (recommended):

uv run --with zapr-mcp zapr-mcp

Configuration and security

Configure the MCP client to reference the Zapr WhatsApp MCP Server. The following example shows how to wire the server into your Claude Desktop config, including the required environment variables for authentication and API access.

{
  "mcpServers": {
    "zapr-whatsapp": {
      "command": "uv",
      "args": ["run", "--with", "zapr-mcp", "zapr-mcp"],
      "env": {
        "ZAPR_SESSION_ID": "your-session-id-here",
        "ZAPR_API_HOST": "https://api.zapr.link"
      }
    }
  }
}

Notes and best practices

Use the uv-based command for a fast local setup.
Keep your ZAPR_SESSION_ID secret and rotate it if you suspect exposure.
Ensure you have an active zapr.link session to authenticate and enable API access.
The server provides rate limiting to avoid exceeding messaging quotas.

Available actions and hooks

The server exposes the following MCP tools to perform common WhatsApp-related tasks: send_whatsapp, bulk_send_whatsapp, get_session_status, and validate_number. You can call these actions from your MCP client to perform single or bulk messaging, verify numbers, and monitor session health.

Available tools

send_whatsapp

Send a message to a single WhatsApp number using the MCP interface.

bulk_send_whatsapp

Send messages to multiple WhatsApp numbers in a single call.

get_session_status

Check the current status of the WhatsApp session and connectivity.

validate_number

Validate if a given phone number is registered on WhatsApp.