How to Use the Netease Yunxin IM MCP in Mastra AI

Q: How do I chain Netease Yunxin IM tools together?

You build a workflow graph. Set getchatroommembers as your initial step. Pass its output into a conditional node that decides whether to trigger sendcustommessage or mutechatroommember based on the active user count.

Q: Does this setup support human-in-the-loop for Netease Yunxin IM actions?

It does. You can flag destructive tools like destroychatroom or blockimuser with requireToolApproval. The workflow will pause and wait for an admin to click approve before hitting the Netease API.

Automate chatroom moderation workflows and user lifecycle management using Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Netease Yunxin IM MCP to Mastra AI

Create your Vinkius account to connect Netease Yunxin IM to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Netease Yunxin IM with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Design Resilient Moderation Workflows

You can build a Mastra AI workflow that triggers `recall_message` when a user violates community guidelines. Chatroom moderation requires strict operational logic. The agent first attempts to hide the specific text. If that call fails due to a network timeout, Mastra automatically retries with exponential backoff via the MCP protocol. You define the escalation path. If the user repeats the offense, the workflow branches and executes `mute_chatroom_member`. For severe violations, it advances to `block_im_user`. The entire sequence runs reliably without human supervision, handling API edge cases through Mastra's built-in engine.

Manage Chatroom Lifecycles via MCP Server

Your agent can execute `create_chatroom` exactly five minutes before a broadcast begins. Live events demand precise timing for infrastructure provisioning. Once the room exists, it uses `get_chatroom_members` to monitor attendance and verify VIP users have joined. When the broadcast concludes, the teardown process begins. The workflow issues a final warning via `send_text_message` and then fires `destroy_chatroom` to clear the resources. You control the entire room lifecycle through a single MCP connection.

Synchronize Netease User Profiles

Mastra AI simplifies user management by treating `create_im_user` as a conditional step. Keeping your application database aligned with your messaging backend is a massive headache. When a new customer registers, your agent generates their messaging account instantly. If the user changes their display name in your app, the workflow triggers `update_im_user` to push that change to Netease Yunxin IM. You can wrap these tools in Mastra's requireToolApproval feature if you want an administrator to review profile updates before they hit the live server.

Setup guide

Set up Netease Yunxin IM MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Netease Yunxin IM tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "netease-yunxin-im-mcp-client",
  servers: {
    "netease-yunxin-im-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Netease Yunxin IM Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Netease Yunxin IM tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Netease Yunxin IM transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Netease Yunxin. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Netease Yunxin IM now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Netease Yunxin IM MCP in Mastra AI

Install @mastra/mcp. Initialize a new MCPClient and pass your Vinkius server URL in the configuration object. Call listTools() and spread the results into your agent's tool array.

Yes. Mastra automatically detects 429 status codes from the API. The framework pauses execution and retries the tool call based on your configured backoff strategy before failing the workflow.

You build a workflow graph. Set get_chatroom_members as your initial step. Pass its output into a conditional node that decides whether to trigger send_custom_message or mute_chatroom_member based on the active user count.

It does. You can flag destructive tools like destroy_chatroom or block_im_user with requireToolApproval. The workflow will pause and wait for an admin to click approve before hitting the Netease API.

This workflow processes user tokens, message payloads, and moderation logs. Vinkius isolates the MCP Server execution environment completely. Your data routes directly to the Netease endpoints without being cached or inspected by the hosting infrastructure.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript