Home / MCP / Titanmind WhatsApp MCP Server

Titanmind WhatsApp MCP Server

Provides Titanmind-powered WhatsApp messaging with free-form and template workflows for conversations, templates, and bulk messages.

other
Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
    "mcpServers": {
        "titanmind_mcp": {
            "command": "/[HOME_DIR_OR_USER_PRFILE]/.local/bin/titan-mind-mcp",
            "args": [],
            "env": {
                "api-key": "YOUR_TITANMIND_API_KEY",
                "bus-code": "YOUR_BUS_CODE"
            }
        }
    }
}

You can run Titanmind’s WhatsApp MCP server to manage conversations, burst template messaging, and bulk outreach directly through Titanmind. It handles free-form replies within a 24-hour window and uses pre-approved templates for new conversations or when the window has expired, enabling scalable WhatsApp marketing and support workflows.

How to use

In your MCP client, add the Titanmind WhatsApp MCP connection to start sending and receiving messages, managing conversations, and deploying templates. You will be able to fetch recent conversations, read messages in a specific conversation, send new messages, create templates for approval, list templates, and perform bulk messaging using approved templates.

Key capabilities you can leverage after setup: get recent conversations, get messages from a conversation, send messages within an existing thread, create and approve message templates, list all templates with status, and send bulk messages using approved templates.

How to install

Prerequisites: you need Python 3.10 or higher and a Titanmind API key with a business code.

Choose one of the MCP config methods shown below to run the server locally or remotely from your MCP client.

Install the Python package globally with pipx (recommended for clean isolation):

# terminal

# Install pipx first
brew install pipx  # on macOS
# or
sudo apt install pipx  # on Ubuntu/Debian

# Then install Titanmind WhatsApp MCP package
pipx install titanmind-whatsapp-mcp

# Ensure the local bin path is on your PATH
pipx ensurepath

Additional sections

Configuration and runtime options are provided through MCP configs. You can run the MCP server locally via stdio or point to a remote MCP server as needed.

Security notes: keep your Titanmind API key and bus code confidential. Do not commit them into public repositories. Use environment variable tooling or secret management in your deployment environment.

Available tools

Get Recent Conversations

Retrieve all conversations with messages sent or received in the last 24 hours and view recent activity.

Get Conversation Messages

Fetch all messages from a specific conversation by providing the conversation_id.

Send WhatsApp Message

Send a message to an existing WhatsApp conversation using the conversation_id and message content.

Create Message Template

Register new WhatsApp message templates for approval with name, language, category and components BODY, HEADER, FOOTER, BUTTONS.

Get Templates

Retrieve all created templates with approval status and optional filtering by template name.

Send Bulk Messages

Send messages to multiple contacts using an approved template by providing template_id and a list of contacts.