# Chuanglan 253 MCP for AI Agents AI Agent Connect

> Chuanglan 253 MCP lets you send high-volume SMS, verification codes, and voice calls through your AI agent. It handles global delivery, 1-click login flows, and real-time balance tracking for your messaging campaigns. Use it to manage pre-approved templates and monitor bulk message status without leaving your AI chat interface.

## Overview
- **Category:** talk-to-me
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_A8LXcTtN7OPNZmCl3chvWjKGwueVIZ6uegR1yEW3/ai-agent-connect
- **Tags:** cpaas, sms-api, verification-codes, bulk-sms, voice-api, global-messaging

## Description

Imagine you're running a massive marketing campaign or a high-traffic app launch. Usually, you'd be jumping between different dashboards to check if your SMS messages actually landed or if your credit balance is holding up. With this Connector, you just tell your AI agent what needs to happen. You can ask it to send out a batch of verification codes or check the status of a specific message ID while you focus on the bigger picture. It handles the heavy lifting of interacting with one of China's biggest CPaaS providers so you don't have to deal with the technical overhead of API calls or manual template creation. It's part of the Vinkius catalog, which makes it easy to plug into your existing setup. Whether you're setting up a new two-factor authentication flow or just need to see if your latest notification went through, your AI becomes the command center for your entire messaging operation. You get real-time updates on delivery and account health through a simple conversation, making it way easier to manage global communications at scale. This means you can pivot from monitoring a failed campaign to creating a new verified template in seconds, all without ever opening a separate browser tab.

## Tools

### get_sms_balance
Use get_sms_balance to check your available SMS credits and messaging capacity. Use this to make sure you have enough funds before starting a big campaign.

### query_batch_sms_status
Use query_batch_sms_status to check the delivery status of multiple messages using a tracking ID. This is perfect for seeing how a bulk campaign is performing in real-time.

### query_template_list
Use query_template_list to list all your pre-approved SMS templates and their current status. Use this to audit your active message formats quickly.

### send_international_sms
Use send_international_sms to send a text message to a phone number outside of China. This uses the international gateway for global reach.

### send_sms
Use send_sms to send a domestic or international SMS with a required brand signature. It returns the submission status and a unique message ID.

### send_verification_sms
Use send_verification_sms to send a one-time password for 1-click login or 2FA. This follows your pre-approved templates for consistent delivery.

### send_voice_verification
Use send_voice_verification to trigger a voice call to speak a verification code to the user. This works as a fallback when SMS delivery is unreliable.

### create_template
Use create_template to create a new SMS template for pre-approval in your account. It lets you manage approved message formats for compliance.

### get_account_info
Use get_account_info to view your current account settings and permissions. It helps you keep track of your enabled features and access levels.

### query_sms_status
Use query_sms_status to see if a specific message was delivered, failed, or is still pending. It provides the exact timestamp for each status change.

## 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:**
- **Status:** Active
- **Features:** Domestic SMS, International SMS, Voice Verification enabled
```

**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
- **Recipient:** Reached successfully
```

## Capabilities

### Send global SMS
Deliver text messages to any phone number worldwide with country code support.

### Issue verification codes
Send one-time passwords for 1-click login and two-factor authentication.

### Trigger voice calls
Fallback to automated voice calls when SMS delivery is unreliable.

### Monitor account balance
Check your SMS credit balance and quota in real-time before starting campaigns.

### Track message delivery
Query the status of individual messages or entire batches with message IDs.

### Manage SMS templates
List, create, and manage pre-approved SMS templates for compliance.

### View account settings
Check your account settings, permissions, and enabled features.

## Use Cases

### MFA Deployment
A security lead asks the agent to send a voice code because the user's SMS didn't arrive, using send_voice_verification.

### Campaign Monitoring
An ops person asks for a delivery report on a batch of 5,000 marketing texts using query_batch_sms_status.

### Login Flow
A dev tells the agent to send a 6-digit code to a new user's phone for a 1-click login using send_verification_sms.

### Template Audit
A product manager asks the agent to list all approved templates to check for brand consistency using query_template_list.

## Benefits

- Stop jumping between tabs because you can check get_sms_balance and get_account_info directly in your chat.
- Deploy 1-click login flows faster by using send_verification_sms to trigger codes instantly.
- Improve user experience by using send_voice_verification as a fallback when SMS delivery fails.
- Stay compliant with easier management of message formats using create_template and query_template_list.
- Get real-time visibility into your marketing reach by using query_batch_sms_status to track bulk delivery.
- Reach customers in any country with ease by using send_international_sms for global connectivity.

## How It Works

The bottom line is you get a conversational interface for a high-volume SMS gateway.

1. Subscribe to this Connector and enter your Chuanglan 253 API credentials.
2. Connect the Connector to your AI client like Claude, Cursor, or Windsurf.
3. Start asking your agent to send codes, check balances, or manage templates.

## Frequently Asked Questions

**Can I use Chuanglan 253 to send international texts?**
Yes, you can send messages to phone numbers worldwide. The Connector handles the international gateway for you, making it easy to reach customers in different countries.

**How do I check if my SMS campaign actually reached people?**
You can ask your agent to check the delivery status of a batch of messages. It will pull the real-time status for your campaign so you know exactly what landed.

**Can this handle 2FA codes?**
Yes, it is designed for 1-click login flows and two-factor authentication. Your agent can send one-time passwords to users as needed.

**What if the SMS doesn't deliver?**
The Connector can trigger a voice call as a fallback. If a user doesn't receive a text, your agent can automatically call them to speak the verification code.

**How do I manage my SMS templates?**
You can ask your agent to list all your approved templates or create a new one. This keeps your messaging compliant and organized without manual data entry.

**Can I see my remaining credit?**
Yes, you can ask your agent to check your balance at any time. It will pull your current SMS credit and quota info from your account instantly.

**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.