# Easemob MCP MCP

> Easemob / 环信 gives your agent full control over complex, real-time communication systems. It lets you manage user accounts, build and moderate chat groups, and send direct messages using only natural conversation. You don't need to touch a dashboard—just tell your AI client what needs doing.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** instant-messaging, real-time-chat, user-management, group-chat, sdk-integration, customer-engagement

## Description

Managing large communities or internal support channels usually means jumping through hoops: checking separate dashboards for membership lists, manually initiating user registrations, or digging through chat logs just to find one specific message. This MCP changes that. It lets your agent act like a real-time communication specialist, handling all the heavy lifting in plain language.

Whether you're setting up an automated support bot or coordinating internal teams, you get immediate access to user data and messaging controls through any MCP-compatible client connected via Vinkius. You can instantly register new members, audit who belongs to a group, send messages between people, or review old chat history—all without writing complex commands or navigating technical menus.

## Tools

### add_group_member
Adds a specific user to an existing chat group.

### create_group
Establishes a new, dedicated chat group.

### delete_user
Removes an IM user account from the system.

### get_chat_history
Retrieves a record of past messages within a chat or group.

### get_group
Pulls all the details for one specific chat group.

### get_user
Fetches detailed information about a single IM user account.

### list_groups
Provides a list of all active chat groups currently in use.

### list_users
Retrieves a comprehensive list of every IM user account registered.

### register_user
Creates and activates a brand new IM user account in the system.

### send_text_message
Sends a plain text message to another user or broadcasts it across a group.

## Prompt Examples

**Prompt:** 
```
Register a new user 'test_user_01' with password 'pass123'.
```

**Response:** 
```
I've successfully registered the new user 'test_user_01'. Their IM account is now active and ready to send or receive messages. Would you like to set a nickname for them?
```

**Prompt:** 
```
Send a message from 'admin' to 'user_01' saying 'Hello, welcome to the group!'.
```

**Response:** 
```
Done! I've sent your text message to 'user_01'. The message has been delivered to the Easemob IM system for processing. Would you like me to check the chat history?
```

**Prompt:** 
```
Create a new group called 'Project Alpha' with 'admin' as owner.
```

**Response:** 
```
I've created the chat group 'Project Alpha'. The Group ID is '12345678'. I've also assigned 'admin' as the owner. Would you like to add any members to this new group now?
```

## Capabilities

### Manage User Identities
You can create, find details for, and remove IM user accounts.

### Build Group Structures
The system handles creating new chat groups and adding members to existing ones.

### Send Direct Messaging
You can send text messages one-on-one between any two users.

### Review Communication History
The agent retrieves and allows you to browse past chat logs for auditing or review.

## Use Cases

### Onboarding a new team member
A support lead needs to get a new employee set up. Instead of logging into multiple portals, they prompt their agent: 'Register user Jane Doe and add her to the Support Team group.' The agent executes `register_user()` and then uses `add_group_member()`, completing the setup in two steps.

### Moderating a massive community chat
A Community Manager finds disruptive activity. They ask their agent to 'Check who is in the main forum group' (using `get_group()`) and then use `delete_user()` on any banned accounts, keeping the group clean automatically.

### Investigating a data leak or complaint
A security officer needs to know exactly what was said yesterday. They ask their agent to 'Show me the chat history for the finance group from last Tuesday.' The agent fetches and presents the required log using `get_chat_history()`.

### Building a dedicated project channel
A product team needs to start coordinating on a new feature. They ask their agent to 'Create a group named Project Phoenix.' The agent runs `create_group()`, giving the team an instant, structured communication hub.

## Benefits

- Forget manual dashboard clicks. Instead of listing users in a separate system, you simply ask your agent to `list_users()` and get the data instantly.
- When onboarding staff, your agent handles the entire workflow: it first uses `register_user()`, then creates the necessary group with `create_group()`, all from one prompt.
- Need to audit a conflict? You don't manually pull logs. You ask the agent to `get_chat_history()` and review everything that happened in plain text format.
- Group moderation is simplified. Instead of guessing who belongs, you can use `list_users()` or `add_group_member()` to manage membership lists on demand.
- Message sending becomes effortless. Use `send_text_message` to communicate directly with users or broadcast alerts across entire groups without needing a complex API call.

## How It Works

The bottom line is you talk to your agent like a person, not a database administrator.

1. First, subscribe to the MCP and enter your specific Easemob credentials (Org Name, App Name, Client ID, and Secret).
2. Next, connect this MCP through your preferred AI client—like Claude or Cursor.
3. Finally, give simple instructions in natural language; your agent translates that into commands to manage users, groups, and messaging.

## Frequently Asked Questions

**How do I use `register_user`?**
You tell your agent the user's details (like username and password). The tool handles creating a brand new, active IM account in the system.

**What is the best way to see all current users using `list_users`?**
`list_users()` gives you every registered user. This is perfect for auditing or figuring out who needs access rights adjusted after an employee leaves.

**How do I use `send_text_message`?**
You simply ask your agent to send the message and specify the recipient (a user ID or a group name). The tool sends it out directly.

**Can I check old chats using `get_chat_history`?**
Yes. You prompt the agent for the specific chat history you need, and the tool retrieves all messages from that thread or group over time.

**How do I check the specific details of an existing chat group using `get_group`?**
You can retrieve all metadata for a given Group ID with `get_group`. This returns ownership information, member lists, and creation dates. It's useful for auditing group structure before you make changes.

**Before I try to send a message, how do I verify a user’s status using `get_user`?**
Running `get_user` provides comprehensive data points about a specific IM account. Check the returned status code; this confirms if the user is active or if the provided account ID is invalid.

**What happens if I try to add a member using `add_group_member` but they are not properly registered?**
The agent returns an error code detailing why the addition failed. You must ensure the target user exists and has appropriate permissions before attempting to execute `add_group_member`.

**If I use `delete_user`, does this also erase all historical messages associated with that account?**
No, using `delete_user` only removes the IM user record. Chat history remains accessible through dedicated auditing functions or system logs.