# Wbiztool MCP MCP

> Wbiztool MCP gives your AI agent full control over WhatsApp Business marketing. Use this connector to manage contacts, run bulk campaigns, and get deep analytics on message delivery status. It lets you automate everything from listing groups to tracking read receipts—all through natural conversation.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** whatsapp-marketing, bulk-messaging, campaign-analytics, contact-management, cloud-orchestration, api-integration

## Description

Stop managing customer messages manually in a web dashboard. This MCP connects your AI agent directly into your WhatsApp Business account, giving you full orchestration control over messaging and campaigns. You can programmatically build out contact lists, send targeted bulk broadcasts, or retrieve detailed message histories to understand exactly what happened with every outgoing communication.

It's built for scale. Whether you need to check if a single client read the last message or run an operational monitoring report on 10,000 signals, your agent handles it. Because this MCP is managed by Vinkius, you can trust that all messaging data passes through a zero-trust proxy; your API keys never sit on a disk. This means you get enterprise-grade security while automating complex workflows across multiple platforms, letting your AI act as a dedicated communications architect.

## Tools

### check_wbiztool_status
Verifies the API connection status to ensure messaging services are online and ready for use.

### create_contact
Adds a new individual contact profile into your Wbiztool system using provided details.

### get_contact
Retrieves the full set of information for one specific WhatsApp contact by their identifier.

### get_message_history
Fetches a detailed log of past messages exchanged with a specific person or group.

### list_contacts
Provides a comprehensive list of all contacts associated with your Wbiztool account.

### list_groups
Retrieves the names and member lists for all WhatsApp groups you manage.

### list_messages
Lists message records within a defined time frame or scope.

### list_templates
Gets a list of pre-approved message templates available for use in campaigns.

### search_contacts
Searches your full contact directory to find specific individuals by name or partial details.

### send_bulk_message
Sends a single message simultaneously to multiple contacts, making it ideal for campaigns.

### send_message
Transmits an immediate, ad-hoc text message to one or more specific recipients.

### send_template
Sends a pre-written, approved message template with custom variable data to users.

## Prompt Examples

**Prompt:** 
```
List all WhatsApp messages sent today in my Wbiztool account.
```

**Response:** 
```
I've retrieved your messages. You currently have 50 high-fidelity transmissions today, including 'Order Confirmation' to +15550123. Would you like the detailed delivery status for any of them?
```

**Prompt:** 
```
Check if 'John Client' (+15550456) has read my last message.
```

**Response:** 
```
Messaging intelligence orchestrated! For +15550456, I've verified that the high-fidelity status is 'READ'. The message was opened at 2:00 PM today. I've retrieved the technical receipt metadata for your records. Need help drafting a follow-up?
```

**Prompt:** 
```
Show my Wbiztool orchestration metrics for this month.
```

**Response:** 
```
Operational monitoring orchestrated! This month, your account has processed 10,000 high-fidelity WhatsApp signals, with a 95% delivery rate and 60% read rate. Your API connection is healthy. Shall I retrieve the detailed engagement breakdown by group?
```

## Capabilities

### Check Account Status
Verify that the Wbiztool API connection is active and working correctly.

### Manage Contacts
Create new contacts or retrieve detailed information about existing ones, including searching by name or number.

### List Groups and Members
Retrieve directories of WhatsApp groups to coordinate outreach across defined communities.

### Send Bulk Campaigns
Trigger message broadcasts simultaneously to large lists of contacts or groups.

### Track Message Status
Get detailed reports on messages, including delivery status (Sent, Delivered, Read) and timestamps.

## Use Cases

### Need to segment clients for a promotion.
A marketing manager needs to send a Black Friday deal only to users who belong to the 'VIP' group. The agent first runs `list_groups` to find the ID, then uses `get_contact` and `search_contacts` to pull all members, finally using `send_template` for targeted deployment.

### A client needs support on a past issue.
The support lead opens an agent chat and asks the agent about John Doe's last interaction. The agent runs `get_message_history`, immediately providing the full transcript, allowing the agent to write a precise response without digging through logs.

### Sending a mass onboarding message.
A developer needs to send welcome messages to 50 new sign-ups. The agent first uses `list_contacts` to confirm all users are in the system, then executes `send_bulk_message` using a standardized template.

### Checking if a key group is active.
A team leader wants to know which groups were last updated. They run `list_groups`, and the agent provides the list, confirming that the main 'Partners' group still exists and has members.

## Benefits

- Campaign visibility is instant. Instead of guessing, you can run the `send_bulk_message` tool and immediately monitor real-time updates for delivery status (Sent, Delivered, Read) right through your agent's conversation flow.
- Stop wasting time building contact lists manually. You can use `list_contacts` or `search_contacts` to pull entire directories of users into your workflow instantly, making segmentation a simple query.
- Never lose context again. By using `get_message_history`, you give your agent access to the full conversation log for any client, letting it draft highly informed follow-up responses based on past interactions.
- Efficiency means speed. If you need to send an official announcement, you don't write the text; you use `send_template` and let the AI handle filling in variables like names or order IDs automatically.
- Operational health is guaranteed. Use `check_wbiztool_status` anytime to verify API connectivity, ensuring your messaging workflow never grinds to a halt because of an expired key or outage.

## How It Works

The bottom line is that once connected, your AI agent executes these complex messaging tasks using simple natural language prompts.

1. Subscribe to this MCP using your Wbiztool API Key.
2. Connect the key from a single client (like Cursor or Claude).
3. Ask your AI agent to perform an action, such as listing all contacts or sending a bulk message.

## Frequently Asked Questions

**How do I send mass messages using Wbiztool MCP?**
You use the `send_bulk_message` tool. This sends one message to many contacts at once, which is perfect for broad announcements or campaigns.

**Can I find a specific contact in my list using search_contacts?**
Yes, you use the `search_contacts` tool. It lets you query your entire directory to pinpoint an individual without having to browse through every single entry.

**What is the difference between send_message and send_template?**
Use `send_message` for quick, unplanned chat replies. Use `send_template` when you need a standardized message that requires custom variables (like an order ID) to maintain professional consistency.

**Does get_message_history include read receipts?**
Yes, the tool provides full metadata including delivery and read statuses. You can ask your agent for a detailed report on when a message was opened.

**If I run `check_wbiztool_status`, what does it tell me about my Wbiztool API credentials?**
It confirms your current connectivity status. If the tool reports an error, it means your API key needs attention or billing details require updating. This helps you quickly troubleshoot before running any messaging commands.

**When I use `list_groups`, what kind of data can my agent retrieve about group membership?**
It retrieves the directory of existing WhatsApp groups and their associated metadata. You'll get details necessary for scoping your outreach, allowing you to coordinate campaigns across defined organizational channels.

**If I execute `send_bulk_message` and hit a rate limit, how does the system handle the failure?**
The MCP is designed to return structured error codes when limits are reached. Your agent will report this status immediately, letting you know which specific batch failed and why without losing your entire workflow context.

**Using `list_templates` helps me manage message structure, but how do I verify template compliance?**
It gives you high-fidelity access to all available templates and their identifiers. You can cross-reference this data against WhatsApp's latest guidelines to ensure your automated campaigns remain compliant.