# Submail MCP for AI Agents AI Agent Connect

> Submail / 赛邮云 is a multi-channel communication platform that lets your AI agent handle SMS, email, and voice notifications in one place. It connects directly to your messaging infrastructure so you can send transactional alerts, verify users with voice codes, and monitor your credit balances without leaving your AI interface.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_EpMEZ6BRzhmG8EQi1n9acOv3GUMZFHIoPfzvXJ1m/ai-agent-connect
- **Tags:** sms-gateway, email-marketing, voice-notifications, transactional-messaging, multi-channel-comms, api-orchestration

## Description

Submail / 赛邮云 lets your AI agent handle the heavy lifting of multi-channel communication. Instead of jumping between different dashboards to send a bulk SMS, trigger a voice notification, or check your remaining credits, you can just tell your agent what to do in plain English. It connects your AI client directly to the Submail platform, making it easy to manage transactional messages, HTML emails, and automated verification flows from a single interface. This is a huge win for teams who need to keep users informed without the friction of manual data entry. You can quickly query your mail or voice balances to ensure your services stay up and running, or fire off project-based templates with custom variables for dynamic messaging. By adding this to the Vinkius catalog, you're giving your agent the ability to act as a real-time communication coordinator. It handles the technical handshake so you can focus on the actual work of managing your users and operations. Whether you're sending out a large batch of notifications or just need to verify a single new user, your agent handles the API calls and status checks. This means you can move faster and avoid the headache of manual coordination.

## Tools

### get_mail_balance
Check your current email credit balance. This helps you stay on top of your costs and avoid service interruptions.

### get_sms_balance
See how many SMS credits you have left. Use this to monitor your spending and ensure your messaging stays active.

### get_voice_balance
Find out your remaining voice credits. This is useful for making sure your voice notifications don't get cut off.

### send_mail
Send an HTML email directly through your AI client. It handles the delivery of your message to the recipient's inbox.

### send_sms
Send a standard SMS message to a phone number. This is perfect for quick, plain-text alerts or notifications.

### send_template_sms
Send a project-based template SMS using custom variables. This allows for dynamic content like names or order numbers.

### send_voice
Dispatch a voice notification to a user. Use this to deliver spoken messages directly to a phone.

### send_voice_verify
Send a voice verification code for security. This is a great way to authenticate users through a phone call.

## Prompt Examples

**Prompt:** 
```
How many SMS credits do I have left?
```

**Response:** 
```
I've checked your account balances. Here is your current status:

| Channel | Remaining Credits |
| :--- | :--- |
| **SMS** | 4,250 |
| **Mail** | 12,800 |
| **Voice** | 850 |

Would you like me to send a notification to your team if any of these fall below 100?
```

**Prompt:** 
```
Send a voice verification code to 13800138000.
```

**Response:** 
```
I've initiated the voice verification call to `13800138000`. 

*   **Status:** Call Initiated
*   **Action:** Reading code to user

I'll monitor the delivery for you. Should I let you know once it's confirmed?
```

**Prompt:** 
```
Send an email to test@example.com saying 'Hello' with the name 'Alex'.
```

**Response:** 
```
I've sent that email to `test@example.com`. 

**Message Content:** 
"Hello Alex, thank you for reaching out!"

Your email was sent successfully via the Submail gateway.
```

## Capabilities

### Send SMS messages
Dispatch plain text alerts or notifications to phone numbers.

### Send HTML emails
Deliver formatted emails with custom content to your mailing list.

### Trigger voice notifications
Convert your messages into spoken voice alerts for your users.

### Send voice verification codes
Automate security checks by calling users with a spoken code.

### Check mail credit balances
Verify your remaining email credits to prevent service gaps.

### Check SMS credit balances
Monitor your SMS spending in real time to manage your budget.

### Check voice credit balances
See how many voice notifications you have left before recharging.

### Send project-based template SMS
Use pre-defined message structures with dynamic variables for consistency.

## Use Cases

### OTP Verification
A user signs up and the agent uses send_voice_verify to give them a code. This automates the security step without manual intervention.

### Low Balance Alert
An engineer asks the agent to check credits using get_voice_balance and gets a status. This helps prevent service outages during peak times.

### Marketing Blast
A manager asks the agent to send a newsletter using send_mail. The agent handles the HTML formatting and distribution.

### Transactional SMS
A customer buys a product and the agent triggers a confirmation via send_sms. This provides an instant confirmation to the buyer.

## Benefits

- Send SMS messages without leaving your workspace by using send_sms. This lets you respond to customers or send alerts instantly while staying inside your AI chat.
- Automate bulk emails with custom variables using send_mail. You can send personalized messages to hundreds of people at once without manually editing every single one.
- Verify users instantly with voice codes via send_voice_verify. This removes the need for manual verification steps and keeps your user onboarding fast and secure.
- Monitor your spending and avoid service interruptions with get_sms_balance. You can keep a close eye on your remaining credits to make sure your communications never stop.
- Use pre-defined project templates for consistent messaging with send_template_sms. This ensures your brand voice stays the same across every single automated message you send.
- Get real-time status updates on your voice notifications using send_voice. You can confirm that your users actually received their spoken alerts without checking logs.

## How It Works

The bottom line is you get a unified way to manage multi-channel messaging through your AI agent.

1. Subscribe to the Submail MCP in the Vinkius marketplace.
2. Enter your Submail AppID and AppKey from your account settings.
3. Ask your AI client to send a message or check your balance.

## Frequently Asked Questions

**What is Submail MCP for AI Agents?**
It's a connector that lets your AI agent send SMS, emails, and voice calls directly. It handles all the communication logic so you can manage your messaging through a simple chat interface.

**Can I use Submail MCP to send bulk marketing emails?**
Yes, you can use it to send HTML emails. It handles the delivery of your messages, making it easy to manage large-scale communications through your AI client.

**How do I check my communication credits with Submail MCP?**
You can simply ask your AI agent to check your balance. It will query the platform and tell you exactly how many SMS, Mail, and Voice credits you have left.

**Does Submail MCP support voice verification codes?**
Yes, it can trigger voice verification codes. This allows your agent to handle security checks by calling a user and reading a code to them automatically.

**Is Submail MCP good for China-based messaging?**
Yes, it is a premier cloud communication platform in China. It is specifically designed to handle multi-channel messaging in that region reliably.

**How do I set up Submail MCP in my AI client?**
Once you subscribe in the Vinkius marketplace, you just need to provide your AppID and AppKey. After that, you can start managing your messages through Claude, Cursor, or any other compatible client.

**How do I find my Submail AppID and AppKey?**
Log in to the [Submail Management Console](https://www.mysubmail.com/), navigate to the relevant project type (SMS, Mail, or Voice) and look for the 'AppID' and 'AppKey' in the project settings or credentials section.

**Does this server handle MD5 signatures?**
Yes! The server automatically calculates the required MD5 signature for every request using your provided AppKey, ensuring secure authorized communication with Submail APIs.

**Can I send template-based SMS?**
Yes! Use the `send_template_sms` tool. You will need the Project ID of your template and a JSON string containing the variables defined in that template.