# CM.com MCP MCP

> CM.com provides a unified messaging platform for conversational commerce. Connect your AI agent to send messages across WhatsApp, SMS, RCS, and voice channels from one place. It handles everything from bulk marketing campaigns and rich media broadcasts to secure OTP verification and email delivery.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** sms-notifications, omnichannel-messaging, whatsapp-business, otp-verification, conversational-commerce, voice-api

## Description

Your agent needs to talk to customers everywhere—WhatsApp, SMS, email, or even via an automated call. This MCP lets you connect your entire communications stack into a single workflow. You can manage outreach across multiple channels using natural conversation prompts instead of writing complex integration code. Need to verify a user's identity? Send and check OTP codes directly. Running these tools is safe because credentials pass through Vinkius’ zero-trust proxy, meaning your keys are only used in transit—they never sit on disk. This gives you the reliability needed for real customer interactions.

The platform handles everything from simple one-off texts to complex flows like sending rich media messages or running automated calls for notifications. Whether you're an operations team needing transactional alerts or a marketing group running bulk campaigns, this MCP makes it happen through your AI client.

## Tools

### get_balance
Checks your CM account's current credit balance, letting you know how many messages you can still send.

### list_numbers
Retrieves a list of all active virtual phone numbers associated with the account.

### send_bulk_sms
Sends the same SMS message to multiple recipients at once, perfect for quick group announcements.

### send_email
Delivers fully formatted HTML emails through the platform's dedicated email infrastructure.

### send_otp_sms
Sends a one-time passkey to a user via SMS, used specifically for account security checks.

### send_rich_message
Formats and sends advanced messages across platforms like WhatsApp or Viber that include media and structured text.

### send_sms
Sends a basic, standard SMS message to any single phone number.

### send_voice_message
Initiates an automated outbound voice call for general notifications or status updates.

### send_voice_otp
Sends a one-time passkey via an automated voice recording, useful when SMS isn't available.

### send_whatsapp
Sends structured WhatsApp template messages that require prior approval from Meta.

### verify_otp
Checks a submitted code against the system to confirm if it is a valid and approved one-time passkey.

## Prompt Examples

**Prompt:** 
```
Send an SMS to +31612345678 saying 'Your order has been shipped' from our company number.
```

**Response:** 
```
SMS sent successfully! From: 'MyCompany', To: +31612345678, Body: 'Your order has been shipped'. Message ID: msg_84201. Status: delivered. Credits used: 1. Current balance: 4,231 credits remaining. Would you like to send the same message to other recipients?
```

**Prompt:** 
```
Send OTP verification to +1555987654 and then verify the code 482910.
```

**Response:** 
```
Step 1: OTP sent via SMS to +1555987654. Verification ID: ver_29401. The recipient should receive a 6-digit code within 10 seconds. Step 2: Verifying code 482910... ✅ Code verified successfully! Verification status: 'approved'. The OTP flow is complete — the user is now authenticated. Would you like to send a confirmation SMS?
```

**Prompt:** 
```
Send a WhatsApp template message about appointment confirmation to +44789012345.
```

**Response:** 
```
WhatsApp template message sent! From: +31201234567, To: +44789012345. Template: 'appointment_confirmation' (namespace: 'my_business_ns'). Status: accepted by WhatsApp Business API. The recipient will see the formatted message in their WhatsApp chat. Note: template messages require prior approval from Meta. Would you like to also send an SMS fallback?
```

## Capabilities

### Check Account Status
You can check the remaining credit balance and list all available virtual phone numbers for use.

### Send Single Messages
Send standard SMS texts, rich media messages (like those used in WhatsApp), or detailed HTML emails to specific recipients.

### Handle Bulk Messaging
Dispatch large volumes of identical or customized SMS texts simultaneously through a single request.

### Manage Voice Comms
Initiate automated voice calls for notifications, or send pre-recorded audio messages to users.

### Verify User Identity
Send a one-time passkey via SMS and immediately check if the code provided by the user is valid.

## Use Cases

### Automating Two-Factor Authentication
A user signs up on the website. The agent first calls send_otp_sms to send a code, waits for the input, and then uses verify_otp to confirm their identity automatically, completing the security step without human intervention.

### Running Multi-Channel Marketing Campaigns
A marketing team wants to announce a sale. The agent triggers send_bulk_sms for immediate alerts, then schedules a more detailed message using send_whatsapp templates hours later, ensuring maximum reach across multiple channels.

### Handling Shipping Notifications
An order ships. The agent first sends an HTML email with tracking details via send_email, and then triggers a friendly voice notification using send_voice_message to the customer for immediate confirmation.

### Service Account Management
The support team needs to confirm if they have enough credit before running a large batch of notifications. They first call get_balance and list available numbers using list_numbers, ensuring the operation stays within budget.

## Benefits

- Instead of manually sending texts or emails, your agent can handle complex campaigns using send_bulk_sms for mass outreach and send_whatsapp templates for structured marketing blasts. It keeps everything in one conversation flow.
- When security is critical, you don't need a separate toolchain. You can use send_otp_sms to trigger the code, and then immediately verify_otp within the same workflow to complete user authentication.
- The MCP supports full transactional communication: Send an email for billing details, then follow up with a send_rich_message containing tracking info on WhatsApp. It connects all your touchpoints.
- You don't have to worry about key storage or token management; Vinkius handles credentials through its zero-trust proxy, so your API keys never sit unprotected on a disk.
- Need immediate feedback? You can check the account status using get_balance and list_numbers before starting any campaign, ensuring you won't run into billing issues mid-flow.

## How It Works

The bottom line is: you tell your AI what needs to be sent and who it goes to; this platform handles the routing, formatting, and delivery across all channels.

1. Subscribe to this MCP and provide your CM.com Product Token from your Channels dashboard.
2. Connect the MCP to any compatible client, like Claude or Cursor.
3. Start sending messages using natural language prompts within your agent workflow.

## Frequently Asked Questions

**Can I send messages through WhatsApp, Viber, and other rich channels?**
Yes! The `send_rich_message` action lets you send through WhatsApp, Viber, RCS, or Apple Messages by specifying the channel parameter. For WhatsApp Business specifically, use `send_whatsapp` to send pre-approved template messages with a template ID and namespace.

**Can I implement two-factor authentication with OTP verification?**
Yes. Use `send_otp_sms` to deliver a verification code via SMS — it returns a verification ID. Then call `verify_otp` with that verification ID and the code the user enters. For voice-based OTP delivery, use `send_voice_otp` to read the code to the user via an automated phone call.

**Can I check my CM.com credit balance before sending campaigns?**
Yes. The `get_balance` tool retrieves your current credit balance. Use `list_numbers` to see all virtual phone numbers in your account. Both tools help you plan campaigns before committing to bulk sends via `send_bulk_sms`.

**How do I check which phone numbers are available using the `list_numbers` tool?**
You can list all virtual numbers assigned to your account via `list_numbers`. This helps you select a verified sender ID for campaigns before sending messages.

**Can I use `send_email` if my customer needs an email alert instead of SMS?**
Yes, `send_email` handles HTML emails using CM.com's delivery infrastructure. This lets your agent send rich marketing or transactional content directly to an inbox.

**What is the purpose of the `send_voice_message` tool?**
The `send_voice_message` function allows you to automate voice notifications. Your agent can place calls for system alerts or text-to-speech announcements.

**If I need to message a large group of users, how does the `send_bulk_sms` tool work?**
`send_bulk_sms` sends many SMS messages in a single API call. It's designed for efficiency when running mass notifications or campaigns.

**When using `send_whatsapp`, what do I need to remember about templates?**
The `send_whatsapp` tool requires pre-approved WhatsApp Business templates, including a namespace. This ensures that all messaging adheres to Meta’s policies.