# 2Chat MCP for AI Agents MCP

> 2Chat connects AI agents directly to WhatsApp's messaging infrastructure. It gives your agent the ability to send messages, manage groups, and verify phone numbers across multiple accounts using a single gateway. This MCP lets you automate complex communication workflows, running campaigns or coordinating internal team alerts entirely through natural language prompts.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** whatsapp-automation, multi-device, group-management, phone-verification, messaging-gateway, customer-service

## Description

Using 2Chat, your AI client gains full control over WhatsApp messaging without needing manual intervention. You can write simple instructions—like 'Send the quarterly report to Project Alpha'—and have your agent handle the entire process: verifying the recipients, creating a new group if needed, and sending multi-media messages instantly. This eliminates logging into separate apps or manually copying numbers dozens of times.

It moves beyond basic messaging. You can build complex operational workflows that monitor incoming chat status, manage participation lists, and even handle communications across multiple linked WhatsApp accounts simultaneously. Because this MCP is hosted on Vinkius, you connect your preferred AI client once to access 2Chat alongside thousands of other tools for specialized tasks. It gives your agent the 'voice' it needs for modern communication, whether you're running large-scale marketing campaigns or just coordinating a quick internal team alert.

## Tools

### list_numbers
Retrieves a list of all WhatsApp phone numbers currently connected and authorized under your 2Chat account.

### send_message
Sends text or media content to specific individuals or designated groups within WhatsApp.

### check_number
Verifies if a given phone number is active and registered on the WhatsApp platform, preventing delivery failures.

### create_group
Creates an entirely new WhatsApp group and allows you to add specified participants at the same time.

### list_groups
Fetches a list of all existing WhatsApp groups that your connected numbers are members of.

## Prompt Examples

**Prompt:** 
```
I need to send the Q3 results PDF announcement to all team leads.
```

**Response:** 
```
✅ Success. The announcement has been sent successfully across 4 groups: 'Leadership Team', 'Finance Leads', and 'Ops Directors'.

**Details:**
*   File attached: Q3_Results.pdf (12MB)
*   Status: Delivered to all 4 groups.
*   Next steps: I've also logged the group UUIDs for easy reference later.
```

**Prompt:** 
```
Check if the main sales numbers are connected and list all groups I belong to.
```

**Response:** 
```
I've checked your connections. You currently have 3 active WhatsApp accounts linked.

**Connected Numbers:**
*   +1 (555) 123-4567 (Primary)
*   +1 (555) 987-6543 (Secondary)

**Groups You Are In:**
*   Project Alpha Core Team
*   Marketing Updates Q4
*   Executive Leadership
```

**Prompt:** 
```
I'm starting a new initiative. Create a group called 'Project Phoenix' and add +1234567890.
```

**Response:** 
```
Group created successfully! 🎉

**New Group Details:**
*   Name: Project Phoenix
*   Members added: 1 (+1234567890)
*   Status: Ready for communication.

You can now send messages to this group using the 'send message' function.
```

## Capabilities

### Send structured messages
The AI can send text, images, PDFs, and voice notes to single numbers or entire groups.

### Manage recipient lists and accounts
You can list all connected WhatsApp phone numbers to determine which account should be used for sending messages.

### Verify number existence
Before sending anything, the agent checks if a given phone number is actually registered on WhatsApp to prevent failed deliveries.

### Group creation and management
The MCP can create new groups with specific participants or list all existing groups linked to your accounts.

### Monitor message status
It provides real-time updates on messages, letting you track if a message was sent, delivered, or read.

## Use Cases

### Rolling out internal policy updates
The Ops Manager needs to notify 15 different department leads. They prompt their agent: 'Send the new security protocol PDF to all relevant groups.' The agent first uses `list_groups` to find the right channels, then sends the secure file via `send_message`, ensuring everyone gets the required update.

### Running a large-scale marketing funnel
A Marketing Specialist wants to hit 50 new leads. They prompt their agent: 'Check these numbers and send a personalized intro message.' The agent uses `check_number` on each lead first, then executes the targeted message via `send_message`, skipping any invalid contacts.

### Onboarding a project team
The Community Manager starts a new initiative. They tell their agent: 'Create a group called Project Phoenix and add these six members.' The agent uses the `create_group` tool, immediately setting up the communication hub for the whole team.

### Consolidating departmental chats
The Development Lead needs to ensure all project stakeholders are in one place. They ask their agent to list groups and then use `create_group` to build a centralized, permanent communication channel for the entire development team.

## Benefits

- Stops failed sends. The `check_number` tool verifies recipients before any message goes out, dramatically improving delivery success rates.
- Manages scale effortlessly. You can use 2Chat to create new groups or list existing ones, allowing your agent to manage communication across dozens of teams.
- Full media support. Sending isn't limited to text. The `send_message` tool handles images and PDFs, making rich content campaigns easier than ever.
- Centralized control. By listing all connected numbers using `list_numbers`, you ensure your agent always sends messages from the correct source account.
- Group coordination simplified. Creating new groups or adding members via these tools means you never have to manually manage participant lists again.

## How It Works

The bottom line is that your AI client can execute sophisticated communication tasks on WhatsApp using simple text commands, without needing a human in the loop for every step.

1. Subscribe to the 2Chat MCP and input your unique API key into your AI client.
2. Your agent uses natural language prompts (e.g., 'Send this announcement to the Dev Team group').
3. The MCP executes the necessary sequence of actions, handles verification, and sends the message via WhatsApp.

## Frequently Asked Questions

**How can I use 2Chat to automate sending WhatsApp announcements?**
You tell your agent the message content and the target group name. The MCP handles everything: it verifies the groups, sends the announcement via `send_message`, and manages the delivery status for you.

**Does 2Chat help me manage multiple WhatsApp accounts?**
Yes, it's built for multi-device support. You connect several numbers, and your agent can use all of them to send messages or run campaigns, preventing reliance on just one account.

**What if I have a list of new contacts? Can 2Chat handle verification?**
Absolutely. Before you send anything, the MCP uses `check_number` to verify every single number in your list. This ensures that failed deliveries due to invalid contacts are eliminated before they happen.

**Can I set up a new team chat group using 2Chat?**
Yes, you can use the `create_group` tool. You tell your agent the desired name and all the participants' numbers, and it builds the group instantly.

**Is 2Chat better than just sending messages manually through WhatsApp?**
It is far more powerful because you don't have to click or copy anything. You write a command in natural language (e.g., 'Send the report'), and your agent executes complex, multi-step actions across groups.

**Does 2Chat support sending different types of media?**
Yes, it handles more than just text. You can send images, PDFs, and voice messages through the system using a single command.