# WhatsApp Business MCP

> WhatsApp Business MCP gives your AI agent full control over your enterprise messaging strategy. Manage templates, audit business profiles, and send direct messages instantly without logging into a complex dashboard. It turns structured communication flows into natural conversations for customer support and global notifications.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** business-messaging, template-messaging, customer-engagement, automated-notifications, profile-management, api-integration

## Description

This MCP lets your AI client handle the entire flow of customer communication through WhatsApp Business Platform. Instead of dealing with complicated Meta dashboards or manual template submissions, your agent acts as a real-time communication manager. You can use it to send highly structured, pre-approved templates using dynamic variables, making sure every notification hits the mark. Need to check if your business profile details are up to date? Your agent retrieves that info instantly. It also lets you audit all existing message types and even delete old templates when they’re no longer needed. If you're running a global support system or managing customer outreach, Vinkius makes connecting this powerful tool simple, letting your agent handle the messaging orchestration right from your workflow.

## Tools

### delete_message_template
Removes an existing WhatsApp message template from your account.

### send_text_message
Sends a direct, non-templated text message when the customer is actively in service hours.

### get_business_profile
Retrieves the current public profile details for your WhatsApp business account.

### get_media
Gets metadata information about images or documents shared via WhatsApp.

### get_waba_details
Retrieves detailed information about your WhatsApp Business Account.

### list_message_templates
Lists all message templates currently registered in your account for review.

### list_phone_numbers
Retrieves a list of all active phone numbers associated with the WhatsApp business profile.

### send_template_message
Sends a message using a pre-approved template to a specific recipient's number.

## Prompt Examples

**Prompt:** 
```
List all my WhatsApp phone numbers.
```

**Response:** 
```
I've retrieved your phone numbers. You have 2 active numbers: '+1 234 567 890' (Main Business) and '+1 987 654 321' (Support). Which one would you like to use?
```

**Prompt:** 
```
Send the 'welcome_offer' template to +5511999999999.
```

**Response:** 
```
Template message sent! I've successfully delivered the 'welcome_offer' to +5511999999999. The message ID is wamid.HBgLNTU...
```

**Prompt:** 
```
Show me my current WhatsApp message templates.
```

**Response:** 
```
I've found 4 templates in your account: 'order_update', 'shipping_notice', 'welcome_offer', and 'feedback_request'. All are currently approved and ready for use.
```

## Capabilities

### Send structured message templates
Your agent sends pre-approved messages to customers using specific formats and variables.

### Send direct text communications
Your agent delivers plain text messages when a customer is actively in a service window with your business.

### Retrieve business account details
The MCP fetches your public profile, phone number info, and overall account metadata.

### Manage message templates
You can list all existing message types in your account or delete ones that are expired.

### Get media information
Your agent retrieves metadata for any images or documents shared through the WhatsApp Business Account.

## Use Cases

### Onboarding a new client
A sales lead asks their agent to send the 'welcome_offer' template to a newly signed customer. The agent uses `send_template_message` immediately, ensuring brand consistency and automating the first touchpoint.

### Auditing account readiness
An IT support team member needs to check if a phone number is active or if profile details changed. They use `get_business_profile` and `list_phone_numbers` via their agent, getting the data instantly for an internal report.

### Cleaning up outdated messaging
The marketing team retires a specific promotion message type. Instead of manually navigating dashboards, they use `list_message_templates` to verify its existence and then trigger `delete_message_template` safely through their agent.

### Handling customer inquiries
A support agent receives a complex query. They ask the MCP to retrieve all available templates, seeing options like 'order_update' or 'shipping_notice', and then send the most appropriate one using `send_template_message`.

## Benefits

- Your agent sends structured updates. Instead of writing a custom message every time, you simply invoke the `send_template_message` tool to deliver approved content with dynamic variables.
- Account health checks are fast. Use `get_waba_details` or `get_business_profile` to pull critical metadata and phone number information without logging into complex Meta dashboards.
- Template management is simple. You can run `list_message_templates` to see everything available, and use `delete_message_template` if a message type is retired.
- Handling real-time support: When appropriate, the agent sends direct text messages using `send_text_message`, keeping conversations natural during active customer service windows.
- Media context is preserved. The MCP allows you to run `get_media` to retrieve metadata for images or documents shared, which is key for logging and auditing purposes.

## How It Works

The bottom line is that your AI client handles all the complex API calls, letting you focus only on the outcome: communicating with customers.

1. First, subscribe to this MCP and provide your Meta Access Token, WABA ID, and Phone Number ID.
2. Next, direct your AI client to use the available tools within Vinkius—for example, asking it to 'List all my WhatsApp phone numbers.'
3. Finally, your agent executes the action, giving you immediate access to your account data or confirming the message send status.

## Frequently Asked Questions

**Can WhatsApp Business MCP send any kind of message?**
No, it primarily sends two types: pre-approved templates via `send_template_message`, or direct text messages using `send_text_message` only during active customer service windows.

**How do I check my company's public profile details with WhatsApp Business MCP?**
You use the `get_business_profile` tool. This allows your agent to retrieve the current, verified metadata for your business account instantly for review.

**Does this MCP help manage my message templates?**
Yes. You can list all existing types using `list_message_templates`, and you can also remove unused ones with `delete_message_template`.

**Is the messaging through WhatsApp Business MCP limited to specific clients?**
No, because this is an MCP on Vinkius Marketplace, your agent connects from any compatible client. You can use it whether you're in Cursor, Claude, or another AI environment.

**Can I get information about media shared via WhatsApp Business MCP?**
Yes. The `get_media` tool retrieves metadata for both images and documents that have been shared through your account, helping with auditing purposes.

**How do I find my Phone Number ID and WABA ID?**
Log in to your [**Meta App Dashboard**](https://developers.facebook.com/apps/), select your app, and navigate to **WhatsApp** > **Getting Started**. You will find both IDs and your Access Token there.

**Can I send messages to any WhatsApp user?**
You can send pre-approved templates at any time. However, to send free-text messages, the user must have interacted with your business in the last 24 hours.

**What happens if a message template is not approved?**
Unapproved templates cannot be sent via the API. You can check the status of your templates using the `list_message_templates` tool to verify their readiness.