# 1msg.io MCP for AI Agents MCP

> 1msg.io is your dedicated MCP for official WhatsApp Business API automation. It lets your AI client handle complex customer communications, send rich media and pre-approved templates, and keep a running log of all messages—all while adhering strictly to Meta's guidelines. You stop writing boilerplate code for messaging and start focusing on conversation flow.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** whatsapp-api, business-messaging, customer-engagement, broadcast-messaging, template-management, automation

## Description

This MCP connects your preferred AI client directly to the official WhatsApp Business API through 1msg.io. It turns your agent into a robust communication layer, letting it manage everything from simple text replies to complex, media-rich broadcast campaigns. Think of it as giving your agent direct access to your entire customer conversation history and all approved messaging templates.

Your AI client handles the heavy lifting: responding instantly to support inquiries, sending follow-up guides with PDFs, or initiating conversations using pre-vetted marketing templates. All communication stays within official Meta standards, so you never risk getting flagged for non-compliant bulk messages. Since this MCP is hosted on Vinkius, your agent gets access to 1msg.io's full suite of messaging tools alongside thousands of others in the catalog—all from one connection point. You just tell your agent what needs to be communicated, and it handles the official delivery across WhatsApp.

## Tools

### send_message
Sends a simple text message to a specified WhatsApp number.

### send_file
Transmits media files (like images, PDFs, or videos) to any WhatsApp recipient.

### send_template
Sends a message using one of your pre-approved business templates.

### list_templates
Retrieves a list of all available and approved WhatsApp messaging templates.

### get_status
Checks the live connection status of your 1msg.io WhatsApp channel to ensure it's operational.

### list_messages
Retrieves a log of recent incoming and outgoing messages for context review or auditing.

## Prompt Examples

**Prompt:** 
```
Hey, send a welcome message with our pricing PDF to +15551234567.
```

**Response:** 
```
**WhatsApp Message Sent Successfully**

*   Recipient: +15551234567
*   Type: Media (PDF)
*   Content: Pricing Guide v2.pdf
*   Status: Delivered.

The agent confirmed the connection is live and sent the document using the media tool.
```

**Prompt:** 
```
Check if my WhatsApp line is connected, and then send a status update template to all users.
```

**Response:** 
```
✅ **Connection Status Check:** The 1msg.io channel is currently 'connected' and operational.

🚀 **Template Broadcast Initiated**
A message using the `System_Update` template was successfully queued for broadcast across your list of contacts.
```

**Prompt:** 
```
What were the last five messages sent or received today?
```

**Response:** 
```
Here is a summary of your recent WhatsApp activity:

| Date/Time | Direction | Summary |
| :---: | :---: | :---: |
| Today 10:30 AM | Outgoing | Follow-up guide attached. |
| Today 9:15 AM | Incoming | Inquiry about service hours. |
| Yesterday 4:00 PM | Outgoing | Welcome template sent. |
```

## Capabilities

### Sending standard text messages
Send a simple, direct WhatsApp text message to any number.

### Delivering media files (images/PDFs)
Send rich content like images, PDFs, or videos to a recipient's WhatsApp chat.

### Sending official templates
Initiate conversations by sending pre-approved WhatsApp message templates for business use.

### Listing available templates
Check which marketing or support templates have already been approved by Meta.

### Checking channel connection status
Verify if the WhatsApp communication line is active, connecting, or disconnected.

### Retrieving message history logs
Pull a record of recent incoming and outgoing chat messages for auditing or context building.

## Use Cases

### Handling post-sale support queries
A customer asks about a product manual. Your agent uses `send_file` to instantly send the correct PDF guide, and then records the interaction using `list_messages` for future reference.

### Launching a new marketing campaign
The operations team needs to notify 50 clients about an outage. The agent uses `send_template` after checking connection status with `get_status` to ensure delivery before sending the broadcast.

### Onboarding a new sales lead
The SDR sends initial follow-up materials using `send_file`, and then asks the agent to check the message log via `list_messages` so they can reference specific details in their next chat.

### Maintaining continuous service uptime
A system monitor needs assurance that messaging is possible. The agent checks the connection status with `get_status`, confirms it's 'connected,' and then proceeds to send a test message using `send_message`.

## Benefits

- Instant communication: Use `send_message` to reply immediately to customer inquiries without manual intervention.
- Rich content delivery: Send PDFs or images using the `send_file` tool, making your automated support responses more useful than plain text.
- Compliance focus: The `send_template` function ensures all outbound marketing messages use Meta's official, pre-approved templates.
- Visibility into communications: Run `list_messages` to easily audit past conversations and maintain accurate context for your agent.
- Reliability check: Use `get_status` whenever you need to know if the WhatsApp connection is active before running a campaign.
- Strategic planning: The `list_templates` tool lets your AI client browse available options, making it easier to plan complex broadcast sequences.

## How It Works

The bottom line is that once connected, your agent treats 1msg.io as a native communication channel, allowing it to perform complex messaging tasks without requiring specialized code or API calls from your side.

1. First, subscribe to the 1msg.io MCP on Vinkius.
2. Next, provide your 1msg.io JWT Token credentials to connect the service.
3. Finally, use your AI client (Claude, Cursor, etc.) to prompt the agent with a natural language request, and it executes the WhatsApp action for you.

## Frequently Asked Questions

**How do I automate customer replies on WhatsApp using the 1msg.io MCP?**
Your agent can respond to incoming messages in real time, handling both simple text replies and sending rich files like guides or receipts automatically. This keeps your support flow consistent without you having to manually reply.

**Can I send marketing broadcasts via 1msg.io using my AI client?**
Yes, the MCP manages this through official templates. You can initiate campaigns by listing and sending pre-approved messages, ensuring every broadcast adheres to WhatsApp's strict business rules.

**Is 1msg.io reliable for mission-critical communications?**
Absolutely. Before any action, you can check the live connection status using a dedicated tool. This confirms that your communication line is active and ready to send or receive messages when you need it most.

**What if I need to prove what conversations happened last month?**
You can pull detailed message logs from the system. The agent retrieves a full audit trail of all recent incoming and outgoing chats, giving you documented proof for compliance or review purposes.

**Does 1msg.io support sending images and PDFs?**
Yes, it does. You can send various media types—including PDF invoices, JPG guides, or videos—using a single function call, which is much easier than managing multiple attachments manually.