# Netease Yunxin IM MCP

> Netease Yunxin IM gives your AI Agent full admin control over live chat rooms. Use its 11 tools to moderate members, block users, create private chats, or broadcast custom messages without writing any server-side code. It's built for high-concurrency messaging in Asia.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** instant-messaging, chatroom-moderation, real-time-communication, webhook-notifications, concurrency-management

## Description

The Netease Yunxin IM MCP Server gives your AI agent full admin control over live chat rooms and user accounts within the Netease network. You're running a high-concurrency messaging system, so this tool lets you manage everything—from basic text sends to complex moderation actions—without ever having to write server code. It’s built for massive Asian chat environments.

When you need to handle users and accounts, the agent can generate a new IM user profile using `create_im_user`, or it'll update an existing account's details like display names with `update_im_user`. You've got full control over access levels; if someone screws up, the agent can block their entire IM account using `block_im_user`, and when they clean up their act, you can reverse that status with `unblock_im_user`.

For managing the chat environment itself, you'll find tools for the whole lifecycle of a room. You can spin up a brand-new, large-scale chatroom instance using `create_chatroom`, and when it's dead and gone, you destroy it completely with `destroy_chatroom`. Before moderation hits, you pull a list of everyone currently in a specific room by calling `get_chatroom_members`; this gives you the exact roster of active users. If someone starts spamming or harassing people, the agent can mute them using `mute_chatroom_member` so they can't send another message.

Communication isn’t just about simple text. You can dispatch plain text messages between two specific users (P2P) using `send_text_message`. For richer interactions—like sending structured data or attaching complex payloads—the agent uses `send_custom_message`, which accepts a full JSON payload to ensure the recipient gets exactly what you send it. When misconduct happens, if a message needs to vanish from the history, the agent can remove it entirely using `recall_message`.

Your ability to control messages and users is comprehensive: besides sending text or structured data payloads, you've got administrative tools to keep the rooms clean. The entire system allows your AI client to operate like a moderator with access to every key function required for massive chat operations.

## Tools

### block_im_user
Blocks an IM user account within the Netease network.

### create_chatroom
Creates a new, large-scale chatroom instance.

### create_im_user
Generates and registers a new IM user account profile.

### destroy_chatroom
Deletes an existing chatroom instance entirely.

### get_chatroom_members
Retrieves a list of all active users currently in the specified chatroom.

### mute_chatroom_member
Silences a specific user within a chatroom, preventing them from sending messages.

### recall_message
Removes a message that was previously sent in the chatroom history.

### send_custom_message
Sends a complex, structured data payload (JSON) to a specific recipient.

### send_text_message
Dispatches a simple, plain text message between two users (P2P).

### unblock_im_user
Reverses the block status on an IM user account.

### update_im_user
Changes details like the display name or profile info for an existing IM user.

## Prompt Examples

**Prompt:** 
```
Mute the user 'spammer01' who is publishing spam in the chatroom '198273'. I am the operator 'admin01'.
```

**Response:** 
```
User 'spammer01' has been definitively muted inside chatroom 198273 via the administrative endpoint. They can no longer send broadcast messages.
```

**Prompt:** 
```
Send a text message saying 'Welcome back' from 'systemBot' to user 'john_doe'.
```

**Response:** 
```
The message 'Welcome back' has been dispatched by `systemBot` asynchronously via the IM servers.
```

## Capabilities

### Moderate Chatroom Participants
The agent can mute specific members in a room based on context (e.g., spamming).

### Manage User Accounts
You can ask the agent to block, unblock, or update profile details for any IM user.

### Create and Destroy Rooms
The system handles creating new chatrooms and cleaning them up when they're no longer needed.

### Send Custom Messages
The agent sends rich, structured data payloads (JSON) or simple text messages to specific users or groups.

### Retrieve Member Lists
You get a list of active members currently participating in any given chatroom.

## Use Cases

### Spam Moderation in Gaming Rooms
A gaming guild chatroom gets flooded with spam. The ops engineer tells their agent: 'Mute the last three users who sent excessive links.' The agent immediately runs `get_chatroom_members` to identify them, then uses `mute_chatroom_member` for rapid cleanup.

### Onboarding New Users
A new user signs up. Your support bot needs a profile and immediate greeting. The agent first runs `create_im_user` to establish the account, then uses `send_text_message` with a welcome message.

### Correcting Misinformation
A chatroom sends out wrong information. A moderator needs to correct it and stop further discussion on that topic. The agent runs `recall_message` to take down the incorrect post, then uses `send_custom_message` to broadcast the corrected facts.

### Archiving Old Groups
A temporary project chat is finished and needs cleanup. Instead of leaving dangling rooms, the agent runs `destroy_chatroom` after confirming all necessary data has been archived via other systems.

## Benefits

- Control spam instantly. Use `mute_chatroom_member` to silence disruptive participants in massive chats without manual intervention.
- Manage user accounts fully. You can use `block_im_user`, `unblock_im_user`, and `update_im_user` to maintain strict community governance.
- Send rich data payloads. The `send_custom_message` tool lets your agent push structured JSON objects, not just plain text.
- Handle the chatroom lifecycle. Use `create_chatroom` for new rooms and `destroy_chatroom` when the conversation ends.
- Get real-time member counts. `get_chatroom_members` instantly lists who is active in a room without needing custom API calls.

## How It Works

The bottom line is that you feed the keys once, and the MCP takes care of all the messy authentication logic for every tool call.

1. Sign up on the Netease Yunxin panel to grab your AppKey and AppSecret.
2. Add those credentials securely into Vinkius (Vurb).
3. The MCP handles the rest: it translates your agent's natural calls, automatically building the complex `SHA1 Nonce` cryptographic checksum.

## Frequently Asked Questions

**How do I block a user using the Netease Yunxin IM MCP Server?**
You call the `block_im_user` tool, providing the target user's ID. This immediately prevents that account from sending any messages in the network.

**What is the difference between `send_text_message` and `send_custom_message`?**
`send_text_message` handles simple, plain chat text (P2P). Use `send_custom_message` when you need to send structured data—like a system alert or an order confirmation payload.

**Can I recall messages using the Netease Yunxin IM MCP Server?**
Yes. You use the `recall_message` tool, which allows administrators to remove specific posts from the chatroom history once they've been sent.

**How do I create a new user account?**
The `create_im_user` tool handles this. It registers the new IM profile and generates the necessary credentials for use in your system.

**When using the Netease Yunxin IM MCP Server, how should I handle authentication details like AppKeys and AppSecrets?**
You must register your unique AppKey and AppSecret in the Vinkius platform. The MCP handles translating these credentials into the complex cryptographic checksums automatically. Treat these keys as sensitive; don't expose them.

**What data does the `get_chatroom_members` tool return for a specific chatroom?**
It returns an array of active member objects. Each object includes the user ID, current status (online/offline), and join time. You use this list to verify who is present before taking moderation action.

**If my AI agent calls `mute_chatroom_member` too frequently, are there rate limits I need to worry about?**
Yes, the underlying Netease API enforces usage limits. If your client hits a threshold, it will return an explicit error code indicating a rate limit violation. You'll need to implement backoff logic in your agent for retries.

**What specific information can I change using the `update_im_user` tool?**
You can modify several user profile fields, including display names and status messages. This function requires both the target User ID and a JSON object detailing the specific fields you want to overwrite.

**Is the cryptographic checksum handled locally?**
Yes! Netease API requires a very specific API Hash (Nonce + Secret + CurTime). This MCP server generates it securely on the fly so you just feed literal variables straight to the AI.