# RongCloud MCP > RongCloud MCP connects your AI client directly to China's leading IM and RTC platform. It lets you manage complex communication tasks, like tracking user online status or broadcasting messages across large chatrooms—all through natural conversation. Forget logging into developer consoles; simply ask your agent to block a disruptive user, retrieve connection tokens for a new session, or list blacklisted contacts instantly. ## Overview - **Category:** talk-to-me - **Price:** Free - **Tags:** real-time-communication, instant-messaging, chatrooms, user-management, rtc ## Description Your AI agent handles the heavy lifting of complex communication systems like RongCloud (融云). This MCP lets you manage everything from real-time messaging to group chatroom moderation without ever touching a developer console. Instead of building custom scripts just to check if someone's online or sending a mass broadcast, your agent acts as a dedicated communications assistant. You tell it what needs doing—whether that’s getting an IM token for a new user, checking detailed chatroom information, or updating profile data—and the conversation handles the rest. If you build high-volume social apps or manage enterprise communication, this connection keeps your flow accurate and your user data secure. When you connect this MCP through Vinkius, you gain access to all these controls from a single point: your AI client. You can use it to send private messages to individuals or blast alerts across entire group chats. You'll also manage the community health by listing blocked users or keeping track of who is on the blacklist. ## Tools ### block_user Prevents a specified user from communicating with the system. ### check_online Confirms if a user is currently active and connected to the IM server. ### create_chatroom Sets up a new group chatroom for communication. ### get_token Retrieves the unique connection token required to initialize a user session. ### list_blacklist Fetches the list of users who are globally banned from communicating. ### list_blocked_users Shows which specific users have been blocked by an administrator or user. ### query_chatroom Retrieves all details about a specified chatroom, including members and settings. ### refresh_user Updates the stored profile information for an existing user account. ### send_chatroom_msg Sends a message to every participant within a specific chatroom. ### send_private_msg Delivers a direct, private text message to one user. ## Prompt Examples **Prompt:** ``` Get an IM token for user 'mario-123'. ``` **Response:** ``` I've retrieved the connection token for Mario. You can use this token to initialize the client SDK for this user session. ``` **Prompt:** ``` Check if user 'renato-456' is currently online. ``` **Response:** ``` I've checked the status for Renato. He is currently 'Online' and connected to the IM server. ``` **Prompt:** ``` Send a text message to chatroom 'room-8821' from user 'bot-01'. ``` **Response:** ``` Done! I've sent your message to all participants in chatroom 'room-8821'. The message has been successfully broadcasted. ``` ## Capabilities ### Manage User Online Status Check if a specific user is currently connected to the IM server and online. ### Send Direct or Group Messages Send private messages to one person or send broadcasts across all participants in a chatroom. ### Control User Access Block specific users from sending messages, or manage lists of blacklisted accounts. ### Manage Chatrooms Create new group chatrooms and retrieve detailed information about existing rooms. ### Update User Data Refresh user profiles to ensure your agent is working with the most current connection details. ## Use Cases ### Onboarding a new app feature The product manager wants to notify 50 key users about the beta launch. Instead of writing a script and iterating through IDs, they ask their agent to first `query_chatroom` for the main group, then use `send_chatroom_msg` to broadcast the announcement to everyone. ### Handling spam or toxic behavior A moderator notices a user is repeatedly sending abusive messages. They prompt their agent to check the status using `check_online`, confirm the issue, and then use `block_user` instantly to prevent further damage. ### Debugging connection issues A dev team member needs to verify if a user's profile details are up to date. They ask their agent to run `refresh_user`, ensuring the data flowing into their application is accurate before sending any messages. ### System audit after an incident The engineering team needs to know who was communicating when a service went down. They instruct their agent to check the `list_blacklist` and review recent chatroom details using `query_chatroom` for all active groups. ## Benefits - Stop manually checking dashboards. You can use `check_online` to instantly confirm if a user is available before your agent sends a message, saving time on failed deliveries. - Need to ban someone? Instead of navigating menus, simply ask the agent to execute `block_user`. It handles the moderation action immediately through conversation. - Coordinating group efforts is simple. Your agent can use `create_chatroom` and then send messages via `send_chatroom_msg`, making broadcast communication as easy as asking a question. - The system keeps your credentials safe while you work. The agent uses `get_token` to securely retrieve the necessary connection tokens for any user session, keeping your workflow moving without manual steps. - Maintain clean communities by using `list_blocked_users` and `list_blacklist`. Your agent pulls this data instantly so you can see who needs moderation attention. ## How It Works The bottom line is you stop writing code for basic communication tasks; you just talk to your agent about what needs doing in RongCloud. 1. Subscribe to this MCP on Vinkius and provide your specific RongCloud App Key and App Secret credentials. 2. Connect the MCP to your preferred AI client (like Cursor or Claude). 3. Start talking. Your agent interprets natural language requests, translates them into API calls, and executes the required action. ## Frequently Asked Questions **How do I use the `send_private_msg` tool with RongCloud MCP?** You ask your agent to 'Send a message to User X.' The agent handles the formatting and execution of the private delivery, ensuring it reaches the intended recipient. **What is the difference between `list_blocked_users` and `list_blacklist`?** `list_blocked_users` shows people blocked by an admin or user in a specific context. `list_blacklist` gives you the master list of users banned system-wide. **Can I create a chatroom using the `create_chatroom` tool?** Yes, simply ask your agent to 'Create a new group chat for Project Alpha.' The MCP handles the room setup and provides you with the necessary details. **Does RongCloud MCP handle token management automatically?** The `get_token` tool allows your agent to retrieve connection tokens when needed, so you don't have to manage that sensitive credential flow manually or write code for it. **How do I know if a user is online with RongCloud MCP?** Just ask the agent 'Is User Y currently online?' It executes `check_online` and reports back their real-time status directly in your conversation.