# Chuanglan 253 MCP

> Chuanglan 253 connects your AI agent to a high-volume messaging gateway, letting you send millions of SMS messages globally. Use it for one-time passwords (OTP), security verifications, and bulk notifications—all managed through conversation instead of a dashboard.

## Overview
- **Category:** talk-to-me
- **Price:** Free
- **Tags:** cpaas, sms-api, verification-codes, bulk-sms, voice-api, global-messaging

## Description

You can connect Chuanglan 253 directly to your AI agent via Vinkius, handling all communication workflows in plain language. Instead of logging into an external portal just to send out codes or check balances, you simply ask your agent what needs doing. You’ll manage everything from sending bulk messages worldwide to running complex two-factor authentication flows for 1-click logins. Need to monitor delivery status? Just ask. Want to make sure compliance is handled? The system lets you list and create approved templates first. It's about turning those messy, multi-step dashboard tasks—checking quota, drafting a message, sending it out, then checking if it arrived—into one simple conversation with your agent.

## Tools

### create_template
Builds new, approved SMS message formats that must be used for compliant sending.

### get_account_info
Retrieves the overall account settings and details for your Chuanglan 253 connection.

### get_sms_balance
Checks how many SMS credits you have left before launching a campaign.

### query_batch_sms_status
Gathers the delivery status for multiple messages sent together using one tracking ID.

### query_sms_status
Returns the specific delivery status, including timestamps, for a single message ID.

### query_template_list
Lists all existing, pre-approved SMS templates available in your account.

### send_international_sms
Sends a standard text message to any number outside of China using the international gateway.

### send_sms
Sends a standard SMS message, following specific rules for domestic Chinese numbers and signatures.

### send_verification_sms
Sends a one-time password formatted text message used primarily for login authentication or verification.

### send_voice_verification
Initiates an automated voice call to deliver the security code instead of using SMS.

## Prompt Examples

**Prompt:** 
```
Send a verification code 837462 to phone number 8615800000000.
```

**Response:** 
```
✅ Verification code sent successfully! Message ID: 162575412960104448. The code 837462 has been delivered to 8615800000000. You can track delivery status using the message ID if needed.
```

**Prompt:** 
```
Check my SMS balance and account status.
```

**Response:** 
```
📊 Your Chuanglan account is active with a balance of 15,847 SMS credits. You have sufficient quota for bulk campaigns. Account status: Active, all features enabled (domestic SMS, international SMS, voice verification).
```

**Prompt:** 
```
What's the delivery status of message ID 162575412960104448?
```

**Response:** 
```
📬 Message ID 162575412960104448 status: DELIVRD (Delivered successfully). Delivered at 2024-01-15 14:32:07. The verification code reached the recipient's device.
```

## Capabilities

### Send Global SMS Messages
Dispatch standard or international text messages to any phone number worldwide.

### Handle Verification Codes
Generate and deliver one-time passwords (OTPs) for account logins or security checks.

### Manage Messaging Templates
List, create, and manage pre-approved message formats to ensure compliance before sending campaigns.

### Monitor Account Status
Check current SMS credit balances and query the delivery status of specific messages or large batches.

### Use Voice Verification
Send an automated voice call instead of a text message when OTP delivery is unreliable.

## Use Cases

### User signs up for a new account.
The user asks their agent, 'Verify John Doe's phone number.' The agent knows to use `send_verification_sms` with the correct country code and tracks the status using `query_sms_status`. It completes the entire authentication flow without human intervention.

### A marketing team runs a regional campaign.
The lead asks, 'Check our available quota for Brazil.' The agent executes `get_sms_balance` first. If successful, it then triggers multiple sends using `send_international_sms`, providing immediate confirmation.

### A developer needs to test a bulk notification system.
Instead of manually sending 50 messages, the dev asks the agent to 'Send these 50 alert messages.' The agent uses `send_sms` and provides a single ID for tracking all results using `query_batch_sms_status`.

### A security team needs a reliable fallback method.
When the primary SMS channel fails, the team asks, 'Switch to voice verification.' The agent immediately reroutes the request and calls `send_voice_verification`, ensuring the user still gets their necessary code.

## Benefits

- Eliminate dashboard logins. You don't need to navigate complex menus; you just tell your agent, 'Send a code,' and it handles the call to `send_verification_sms`.
- Manage compliance upfront. Use `query_template_list` or `create_template` before running any campaign to ensure all messages are pre-approved.
- Handle global scale without friction. Whether you need to send a simple message via `send_international_sms` or manage account status with `get_account_info`, it’s one conversational prompt away.
- Real-time visibility on delivery. Instead of guessing, the agent can check the precise status of any message using `query_sms_status` or track large sends with `query_batch_sms_status`.
- Flexible security options. If SMS fails, you don't stop; you switch methods by asking the agent to run `send_voice_verification`, keeping your authentication flow running smoothly.

## How It Works

The bottom line is you ask your AI client for what you need—a verification code, a balance check, or a bulk send—and it executes the API call without you ever touching a web dashboard.

1. Subscribe to the Chuanglan 253 MCP and enter your API credentials.
2. Your AI agent connects, giving it access to all messaging tools.
3. You issue a natural language request, telling the agent exactly what messages need sending or what status needs checking.

## Frequently Asked Questions

**How do I check my SMS credit balance using get_sms_balance?**
You ask your agent directly, 'What's our current SMS credit balance?' It executes `get_sms_balance` and returns the real-time quota count without needing you to log in.

**Can I send messages outside of China?**
Yes. You must use the dedicated tool, `send_international_sms`, which is built for global numbers and country codes, ensuring successful delivery everywhere.

**What if SMS fails? Can I use send_voice_verification?**
Absolutely. If text message delivery isn't reliable, you tell your agent to switch methods. It then uses `send_voice_verification` to call the user instead.

**How do I manage approved messaging formats?**
You use `query_template_list` to see what's available, or you ask the agent to create new ones using `create_template` for compliance review.

**How do I check my overall account settings and permissions using get_account_info?**
The `get_account_info` tool gives you a direct view of your Chuanglan 253 account status. You can review all enabled features, current permissions, and general operational settings without having to log into the main dashboard.

**Should I use query_batch_sms_status or query_sms_status when checking delivery?**
Use `query_batch_sms_status` if you sent a group of messages and need one status report for the entire batch. If you only want to check the specific outcome of a single, unique message ID, then use `query_sms_status`.

**What are the requirements when I run create_template?**
Templates require pre-approval before they can be used for sending messages. You must also include variable placeholders like {1} or {2} if you plan to inject dynamic content into the template later.

**Does sending a regular domestic message need special formatting with send_sms?**
Yes, when using `send_sms` for Chinese domestic SMS, the message body must begin with a signature enclosed in brackets, like [YourBrand]. This ensures the message passes compliance checks.

**How do I format phone numbers for sending SMS?**
Phone numbers must include the country code without the 00 prefix. For example: China uses 86 (e.g., 8615800000000), Brazil uses 55 (e.g., 5511999999999), US uses 1 (e.g., 12025551234). The number should be 5-20 digits total. For Chinese domestic SMS, the message must start with a registered signature like [YourBrand].

**What's the difference between send_sms and send_international_sms tools?**
The `send_sms` tool uses the standard SMS gateway (smssh.253.com) optimized for Chinese domestic messages and requires pre-registered templates and signatures. The `send_international_sms` tool uses the international gateway (intapi.253.com) for global delivery outside China, which supports SenderId and doesn't require Chinese-style signatures. International SMS permissions must be separately enabled in your account.

**How does the MD5 signature authentication work?**
The Chuanglan API uses MD5 signature authentication for security. Your password is NEVER sent in the request body. Instead, it's combined with the request parameters and timestamp (nonce), then hashed with MD5 to generate a `sign` header. The server validates this signature to ensure request integrity. The framework handles all signature generation automatically — you only need to provide your account and password.