# Cloopen MCP for AI Agents MCP

> Cloopen connects your AI client directly to China's top cloud communication platform, letting you manage SMS campaigns, voice calls, and application settings through natural conversation. Your agent handles everything from sending templated messages and initiating automated call verifications to checking account limits and auditing IVR configurations—all without needing to log into a complex web portal.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** cpaas, voice-verification, sms-campaigns, cloud-communication, api-integration, enterprise-messaging

## Description

Cloopen lets your AI client handle all communications tasks for you. Instead of navigating the complicated Cloopen dashboard, your agent talks to this MCP, and it does the work. You can use natural language commands to send templated SMS messages or initiate automated voice calls for verification codes. Need to check if a message was delivered? Your agent handles that query instantly. It even lets you list approved templates so you know exactly what messaging is allowed across your company. Beyond sending messages, you can ask the MCP to audit your setup, listing all active communication applications and reviewing detailed IVR configurations. This capability means whether you're running a large-scale notification campaign or just verifying a single user account, you control it conversationally. You connect this powerful resource through Vinkius, giving any compatible AI client instant access to China’s premier CPaaS tools.

## Tools

### get_account_info
Retrieves general operational details about your Cloopen account, including balances and status.

### get_app
Fetches detailed setup information for a specific communication application ID.

### get_ivr
Retrieves the current configuration and flow map of an Interactive Voice Response (IVR) system.

### list_apps
Provides a comprehensive list of all active or configured communication applications associated with your account.

### list_callback
Initiates a double-call callback sequence, useful for complex routing tests.

### list_landing_calls
Starts an initial landing call to test or route incoming voice traffic flows.

### list_templates
Retrieves all approved SMS templates used for sending messages across the organization.

### list_voice_codes
Triggers a voice call containing a one-time verification code to a specified number.

### query_sms
Checks the delivery status and history of previously sent SMS messages using a unique message ID.

### send_sms
Sends a new SMS message by selecting an existing, approved template and providing recipient details.

## Prompt Examples

**Prompt:** 
```
We just launched the new feature. Send an SMS notification to all 50 beta testers using template 'NewFeatureAlert' and confirm the message ID.
```

**Response:** 
```
**✅ Status: Sent**

Successfully dispatched the alert via template 'NewFeatureAlert'.

*   **Recipient Count:** 50
*   **Message ID:** `A9B3C4D2E1`
*   **Delivery Prediction:** High (Pending confirmation in 5 minutes)

Please use this Message ID to query the final delivery status later on.
```

**Prompt:** 
```
What's our current account balance and are there any active applications running?
```

**Response:** 
```
**Account Overview**
| Metric | Value |
| :--- | :--- |
| Current Balance | ¥850.00 |
| Status | Active |
*Applications:* 3 listed (Billing, Support IVR, Marketing SMS)

You have sufficient funds for immediate campaigns.
```

**Prompt:** 
```
I need a verification code sent to the user '139XXXXXXXX'. Use voice call method.
```

**Response:** 
```
**📞 Verification Code Initiated**
The system has initiated an automated voice call sequence. The recipient will receive a temporary PIN within the next 60 seconds.

*   **Action:** `list_voice_codes` executed.
*   **Status:** Pending Callback
*   **Note:** Keep this session open to confirm successful delivery.
```

## Capabilities

### Send and track SMS messages
Draft and send template-based SMS messages while also querying the system for real-time delivery status.

### Manage voice verification calls
Initiate automated outbound voice calls to deliver critical notifications or security verification codes.

### Audit account and resource usage
Retrieve high-level account information, check current balances, and monitor overall resource consumption.

### List and configure communication apps
Get a list of all active applications and retrieve detailed setup information for specific communications platforms or IVRs.

## Use Cases

### Onboarding new users
A user needs verification. The agent runs `list_voice_codes` to send the code, waits for confirmation, and then uses that information to update the user record automatically.

### Auditing communication failure
The marketing team suspects a batch of notifications failed. They ask their agent to run `query_sms` using specific message IDs to pinpoint exactly which messages never delivered and why.

### Updating system messaging:
The Product Ops team needs to confirm the current IVR flow before a product launch. The agent runs `get_ivr` and presents the full call path for immediate review against requirements.

## Benefits

- Automate User Verification: Use the `list_voice_codes` tool to automatically trigger a call with a secure, time-sensitive code when needed.
- Full Message Visibility: The `query_sms` tool lets you check delivery status on any message ID, giving immediate confirmation that your campaign ran successfully.
- Centralized Configuration: Listing all apps via `list_apps` and checking details using `get_app` keeps all communication settings visible in one conversational place.
- Consistent Messaging: By listing templates with `list_templates`, you ensure every outbound message adheres to approved corporate language, preventing compliance issues.
- Account Health Check: Use the `get_account_info` tool at any time to verify your remaining balance and overall service status without logging into a dashboard.

## How It Works

The bottom line is you talk to your AI agent, and it uses this MCP to perform complex, multi-step communication actions in the background.

1. Subscribe to this MCP on Vinkius, providing your Cloopen Account Sid, Auth Token, and App Id.
2. Connect your preferred AI client (like Cursor or Claude) through the Vinkius platform.
3. Use natural language prompts with your AI client to execute communication tasks, such as sending an SMS message or listing connected applications.

## Frequently Asked Questions

**How does Cloopen / 容联云 MCP help me manage SMS campaigns?**
It lets you automate entire message sends. Instead of manually creating messages, you ask your agent to use a pre-approved template and send it to dozens or hundreds of people instantly. You also get real-time confirmation on which messages actually delivered.

**Can I check my account limits using the Cloopen / 容联云 MCP?**
Yes, you can run an account audit anytime. The agent will retrieve your current balance and overall resource usage, letting you know if a campaign is at risk of failing due to low funds.

**What if I need automated voice verification codes?**
You can trigger these calls using the MCP. Your AI agent handles the entire process: initiating the call and delivering the secure, time-limited code directly to the user's phone.

**Does this MCP help with setting up new communication apps?**
Yes, you can list all existing applications using `list_apps` and then get detailed information on a specific app or its IVR flow. This helps your team audit the setup before making changes.

**Is this MCP only for China-based numbers?**
This MCP is designed to manage communications specifically through Cloopen, which operates within the Chinese cloud communication ecosystem.