Skip to main content
Glama
Titanmind WhatsApp MCP

Titanmind WhatsApp MCP

by TitanmindAGI

Titanmind WhatsApp MCP

A WhatsApp marketing and messaging tool MCP (Model Control Protocol) service using Titanmind. Handles free-form messages (24hr window) and template workflows automatically

Related MCP server: Wasapi MCP Server

Overview

This service provides all the WhatsApp marketing and messaging functionalities using Titanmind. Includes features like template creation and registration with all components header, body, CTAs.., template broadcast to phone numbers in bulk. Read and send messages in an active conversation.

This MCP utilizes Titanmind. Titanmind Account is a requirement to use this MCP.

Titanmind enhances WhatsApp communication by providing powerful features such as conversation management, scheduling, agentic conversations, content generation etc.

Features

Conversation Management

Get Recent Conversations

  • Retrieve all conversations with messages sent or received in the last 24 hours

  • Returns conversation data with recent activity

Get Conversation Messages

  • Fetch all messages from a specific conversation

  • Requires: conversation_id (alphanumeric conversation identifier)

Send WhatsApp Message

  • Send a message to an existing WhatsApp conversation

  • Requires: conversation_id and message content

Template Management

Create Message Template

  • Register new WhatsApp message templates for approval

  • Configure template name (single word, underscores allowed only)

  • Set language (default: "en") and category (MARKETING, UTILITY, AUTHENTICATION)

  • Structure message components including:

    • BODY (required): Main text content

    • HEADER (optional): TEXT, VIDEO, IMAGE, or DOCUMENT format

    • FOOTER (optional): Footer text

    • BUTTONS (optional): QUICK_REPLY, URL, or PHONE_NUMBER actions

Get Templates

  • Retrieve all created templates with approval status

  • Optional filtering by template name

Send Bulk Messages

  • Send messages to multiple phone numbers using approved templates

  • Requires: template_id and list of contacts

  • Contact format: country code alpha (e.g., "IN"), country code (e.g., "91"), and phone number

Installation

Prerequisites

  • Python 3.10 or higher

  • API Key and Business Code from Titanmind

Usage with MCP Client

In any MCP Client like Claude or Cursor, Titanmind whatsapp MCP config can be added following ways:

Using Titanmind WhatsApp MCP Python package

1. Install pipx to install the python package globally

# terminal

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

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

# Make sure '/[HOME_DIR_OR_USER_PRFILE]/.local/bin' is on your PATH environment variable. Use pipx ensurepath to set it.
pipx ensurepath 
 

2. Set the MCP Config python package script in the MCP Client's MCP Configs Json file.

{
  "mcpServers": {
    "TitanMindMCP": {
      "command": "/[HOME_DIR_OR_USER_PRFILE]/.local/bin/titan-mind-mcp",
      "args": [
      ],
      "env": {
        "api-key": "XXXXXXXXXXXXXXXXXXXXXXXX",
        "bus-code": "XXXXXX"
      }
    }
  }
}

Use Remote Titanmind MCP server config

1. Make sure npx is installed in the system
2. Then just add the MCP config

{
  "mcpServers": {
    "TitanMindMCP": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.titanmind.so/whatsapp/mcp/",
        "--header",
        "api-key:XXXXXXXXXXXXXXXXXXXXXXX",
        "--header",
        "bus-code:XXXXXX"
      ]
    }
  }
}

Use local python project config

1. First Setup project using instructions mentioned in the Setup Project section.
2. Then add the MCP config

{
  "mcpServers": {
    "TitanMindMCP": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/[PATH_TO_THE_PROJECT]",
        "python",
        "main.py"
      ],
      "env": {
        "api-key": "XXXXXXXXXXXXXXXXXXXX",
        "bus-code": "XXXXXX"
      }
    }
  }
}

Manual Installation for custom purpose or development

Install package from PyPI for package use

pip install titanmind-whatsapp-mcp

Or use uv:

uv pip install titanmind-whatsapp-mcp

Setup Project for development use

1. Clone the repository:

git clone https://github.com/TitanmindAGI/titanmind-whatsapp-mcp
cd titanmind-whatsapp-mcp

2. Install dependencies:

pip install -e .
# Or
uv pip install -e .

3. Set the auth keys

export api-key="your-titanmind-api-key"
export bus-code="your-titanmind-business-code"

How it Works

TitanMind's WhatsApp messaging system operates under two distinct messaging modes based on timing and conversation status:

Free-Form Messaging (24-Hour Window)

  • When Available: Only after a user has sent a message within the last 24 hours

  • Content Freedom: Any content is allowed without pre-approval

  • Use Case: Ongoing conversations and immediate responses

Template Messaging (Outside 24-Hour Window)

  • When Required: For new conversations or when the 24-hour window has expired

  • Content Structure: Pre-approved, structured message templates only

  • Use Case: Initial outreach and re-engagement campaigns

Messaging Workflow Process

  1. Check Messaging Window Status

    • Verify if receiver's phone number is within the free-form messaging window

    • A receiver is eligible for free-form messaging if:

      • A conversation with their phone number already exists AND

      • The receiver has sent a message within the last 24 hours

  2. Choose Messaging Method

    • Free-Form: Send directly if within 24-hour window

    • Template: Register and use approved template if outside window

  3. Template Approval Process (if needed)

    • Submit template for WhatsApp approval

    • Wait for approval confirmation

    • Template becomes available for bulk messaging

  4. Send Message

    • Execute message delivery using appropriate method

    • Monitor delivery status

  5. Verify Delivery

    • Check conversation to confirm receiver successfully received the message

    • Track message status and engagement

Usage Notes

  • All tools integrate with Titanmind's WhatsApp channel messaging functionality

  • Templates require approval before they can be used for bulk messaging

  • For more help contact us through https://www.titanmind.so/

License

MIT License - See LICENSE file

Available Tools

6 tools
get_conversations_from_the_last_dayD

Inputs: phone_without_dialer_code.

get_the_messages_of_a_conversation_D

Inputs: conversation_id (required).

get_the_templatesD

Inputs: template_name, page, page_size.

register_msg_template_for_approvalB
creates and registers a new whatsapp message template for approval.
Args:
    template_name (str): name of the whatsapp message template, It only accepts a single word without no special characters except underscores
    language (str): language of the whatsapp message template (default is "en")
    category (str): category of the whatsapp message template (default is "MARKETING"), other possible values are "UTILITY", "AUTHENTICATION"
    message_content_components (dict): the message content that needs to be sent. It needs to be structured like the below example, 
    components are required to have BODY component at least, like this: {"type": "BODY", "text": "lorem body text"}, BODY component is for the simple text.
    All other components are optional. 
    HEADER component can have any of the below format, but only one format at a time can be used.: TEXT(the header component with TEXT needs to be like this
    {
    "type": "HEADER",
    "format": "TEXT",
    "text": "lorem header text"
    }
    ), VIDEO(the header component with VIDEO needs to be like this
    {
     "type":"HEADER",
     "format":"VIDEO",
     "example":{
        "header_handle":[
           "https://sample_video_url.jpg"
        ]
     }
    }
    )
    , IMAGE(the header component with IMAGE needs to be like this 
    {
     "type":"HEADER",
     "format":"IMAGE",
     "example":{
        "header_handle":[
           "https://sample_image_url.jpg"
        ]
     }
    }),
   DOCUMENT (the header component with DOCUMENT needs to be like this 
    {
     "type":"HEADER",
     "format":"DOCUMENT",
     "example":{
        "header_handle":[
           "https://sample_document_url"
        ]
     }
  }),
    message_content_components value with all other type of components is mentioned below.
        [
                {
                    "type": "HEADER",
                    "format": "TEXT",
                    "text": "lorem header text"
                },
                {
                    "type": "BODY",
                    "text": "lorem body text"
                },
                {
                    "type": "FOOTER",
                    "text": "lorem footer text"
                },
                {
                    "type": "BUTTONS",
                    "buttons": [
                        {
                            "type": "QUICK_REPLY",
                            "text": "lorem reply bt"
                        },
                        {
                          "type": "URL",
                          "text": "cta",
                          "url": "https:sample.in"
                        },
                        {
                          "type": "PHONE_NUMBER",
                          "text": "call ",
                          "phone_number": "IN328892398"
                        }
                    ]
                }
            ]
    Buttons need to follow order of first QUICK_REPLY, then URL, and then PHONE_NUMBER.

Inputs: template_name (required), message_content_components (required), language, category.

send_msg_to_multiple_num_using_approved_templateD

Inputs: template_id (required), contacts (required).

send_whatsapp_message_to_a_conversationD

Inputs: conversation_id (required), message (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    D1.7/5.0

    Scored across 6 tools

    Disambiguation3/5

    The tools have distinct purposes (get conversations, get messages, get templates, register template, send template messages, send direct messages), but some ambiguity exists between 'send_msg_to_multiple_num_using_approved_template' and 'send_whatsapp_message_to_a_conversation' since both involve sending messages. The lack of descriptions for most tools exacerbates this overlap.

    Naming Consistency2/5

    Naming is inconsistent with mixed conventions: some use snake_case with underscores (e.g., 'get_conversations_from_the_last_day'), others have trailing underscores (e.g., 'get_the_messages_of_a_conversation_'), and verbs vary (e.g., 'get' vs. 'register'). While all names are descriptive, the lack of a uniform pattern reduces predictability.

    Tool Count4/5

    With 6 tools, the count is reasonable for a WhatsApp-focused server, covering core operations like retrieving conversations/messages/templates, registering templates, and sending messages. It's slightly lean but not overly sparse, allowing for basic functionality without being overwhelming.

    Completeness3/5

    The server covers key WhatsApp operations (read conversations/messages, manage templates, send messages), but there are notable gaps: no tools for updating or deleting templates, managing conversation participants, or handling message statuses. The surface supports basic workflows but lacks full lifecycle management for templates and conversations.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Connects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without the risk of account bans.
      18
      27
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Automate and manage WhatsApp groups, communities, and channels with scheduling, moderation, analytics, and more.
      1
      MIT