# Wati MCP

> Wati connects your WhatsApp Business API to any AI client, letting you manage high-volume customer conversations directly from chat. Use this MCP to automatically send template messages, retrieve full chat histories for support context, and handle contact updates without logging into the Wati dashboard.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** whatsapp-api, chatbot, customer-engagement, shared-inbox, template-messaging, conversational-marketing

## Description

This connector lets your agent talk directly to your WhatsApp Business account. Forget jumping between tabs or manually entering data—you can manage all customer interactions inside your preferred AI client. Need to update a subscriber's details? Just ask your agent, and it handles the contact management. Want to know why a customer called last week? Your agent pulls the complete message history instantly. You can also send pre-written, approved templates or respond with real-time session messages. When you connect this MCP via Vinkius, your AI client becomes a universal control panel for all your WhatsApp communications, giving your team a clear view of conversations and contacts right where they are working.

## Tools

### add_contact
Adds a new contact record into your system directory.

### check_wati_status
Verifies that the connection to Wati is active and working correctly.

### get_contact
Retrieves specific details for a single known contact number.

### get_template
Fetches the detailed content and parameters of an approved message template.

### list_templates
Retrieves a comprehensive list of all available message templates you can use.

### list_broadcasts
Shows existing broadcast campaigns or lists set up within Wati.

### list_contacts
Generates a list of all current contacts managed by your account.

### list_messages
Fetches and lists recent message activity across the connected account.

### list_tags
Lists all customer tags applied to contacts, helping segment your users.

### send_media_message
Sends a message containing media content like images or documents.

### send_session_message
Sends an immediate, free-form chat message to a customer in real time.

### send_template_message
Triggers a structured communication using a pre-approved template and required variables.

### update_contact
Changes attributes on an existing contact record, such as adding notes or changing status.

## Prompt Examples

**Prompt:** 
```
List all my WhatsApp templates.
```

**Response:** 
```
I've retrieved your message templates. You have 5 approved templates including 'Welcome Message', 'Order Confirmation', and 'Shipping Update'. Which one would you like to use?
```

**Prompt:** 
```
Send the 'order_ready' template to 5511999999999.
```

**Response:** 
```
Template message sent! I've triggered the 'order_ready' template to the recipient 5511999999999. The message ID is WATI_8823.
```

**Prompt:** 
```
Show me the chat history for the number 5511888888888.
```

**Response:** 
```
I've fetched the history. The last 3 messages show the customer asking about pricing, followed by your response and a confirmation of payment. Would you like to see the full transcript?
```

## Capabilities

### Manage Contact Details
Add new subscribers to your directory or pull existing contact details using their numbers.

### Retrieve Conversation Context
Fetch the complete message history for any number, giving full context on past customer interactions.

### Automate Messaging Workflows
Send pre-approved template messages or initiate real-time chats using dynamic parameters.

### Maintain Contact Records
List all current subscribers and update specific contact attributes when information changes.

### Analyze Communication Assets
Review the full catalog of available message templates, tags, and broadcast lists for marketing campaigns.

## Use Cases

### The Support Team Needs Context
A customer calls in frustrated because they were double-billed. Instead of asking them, 'What was the issue?', the agent simply asks their AI client to fetch the chat history for that number. The AI reads the last three messages and immediately knows exactly what the conversation was about.

### The Sales Team Needs to Nurture Leads
A lead attends a webinar, but hasn't responded in 48 hours. The SDR doesn't guess; they ask their agent to send_template_message using the 'webinar follow-up' template, ensuring the message is professional and actionable.

### The Ops Manager Needs to Clean Up Data
A marketing team just ran a campaign. The manager realizes some contacts are missing their company size tag. They use list_contacts and then ask the agent to update_contact for all relevant numbers, keeping the directory accurate.

### The Marketing Team Needs to Launch an Update
A product feature launches, requiring a notification to 50 clients. Instead of manually drafting emails, the marketer uses list_templates to confirm the 'new feature' template is active and then triggers send_template_message for all recipients.

## Benefits

- Instantly get full context. Instead of asking the customer to repeat their issue, ask your agent to retrieve the message history for a number. This saves minutes per call and keeps support running smoothly.
- Automate outreach with confidence. Use the template messaging tools to send structured notifications (like order updates) only after verifying that the templates exist via list_templates, ensuring you never use outdated text.
- Keep your records clean. You can manage contact attributes—for example, using update_contact—to ensure lead status or department details are current without needing a separate CRM login.
- Coordinate complex sending. Need to send an image *and* follow up with text? Use the combination of list_contacts and send_media_message to handle multi-asset communication in one flow.
- Stay compliant and organized. Before running any campaign, review your existing tags using list_tags to make sure you're grouping customers correctly for targeted messaging.

## How It Works

The bottom line is that you tell your AI client what you need—a contact list, a chat summary, or a template send—and it executes the task directly through WhatsApp.

1. Subscribe to this MCP and provide your Wati API Key along with the specific API Endpoint found in your Wati dashboard.
2. Your AI client establishes a connection, verifying access and syncing your available communication assets.
3. You interact naturally: ask your agent to perform an action (like retrieving history or sending a message), and it uses the connected Wati tools.

## Frequently Asked Questions

**How does Wati MCP help with customer support history?**
Your agent uses the list_messages tool to fetch the complete conversation transcript instantly. This means your team has full context on past interactions without having to manually dig through old emails or logs.

**Can I use Wati MCP to send messages outside of chat?**
The primary function is messaging within WhatsApp. However, the MCP allows for structured communication using send_template_message, which handles notifications and updates professionally through approved channels.

**What if I need to update a customer's details? Can Wati MCP do that?**
Yes. You can use the update_contact tool to change attributes on existing contacts. This is useful for marking leads as 'Purchased' or adding internal notes.

**Does Wati MCP support bulk messaging?**
It supports campaigns via list_broadcasts and send_template_message, which are designed to communicate structured messages to multiple contacts simultaneously using approved templates.

**How do I make sure my template is ready before sending it with Wati MCP?**
You can run the list_templates tool first. This gives you a full view of every available message type, confirming which ones are ready to deploy.