# NetEase Cloud Gaming MCP

> NetEase Cloud Gaming manages your entire cloud gaming lifecycle. This MCP lets your AI agent create, monitor, and terminate game sessions across NetEase's infrastructure. You can also check user quotas, get server health stats, or list available games directly from your workflow.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** netease, cloud-gaming, gaming-paas, streaming-infrastructure, session-management

## Description

Listen up. This MCP server connects your AI agent straight into NetEase Cloud Gaming's back end. It gives you total control over the entire gaming lifecycle—from starting a stream to shutting it down and managing user credits. You don't gotta jump through five different developer dashboards just to know if a session is running or how much time a user got left. This tool handles all that stuff in one place.

### Managing Game Sessions

When you need to get people playing, your agent uses the `create_session` tool; it spins up a brand new cloud gaming instance using specific game and user IDs. If something goes south or they're done with the game, you can force an immediate shutdown with `stop_session`, which kills that specific session ID instantly. And if you need to know what's going on right now—whether the stream's up or stalled out—you check the current status using `get_session_status`. 

### Checking the Platform and Inventory

You gotta know where your stuff is running. You can pull a full list of all active geographical server clusters available on NetEase Cloud Gaming using `list_clusters`, and if you need specifics, `get_cluster_info` pulls detailed operational info for just one cluster ID. When it comes to the games themselves, you don't have to guess what titles are supported; `list_games` gives you a complete catalog of everything the platform runs. If you want to know the technical specs or metadata for a specific game title, use `get_game_detail`. For overall confidence in the system, you check the total operational status with `get_system_health`; this reports the whole platform's health metrics.

### Handling User Accounts and Quotas

Managing users means managing time. To see how much playtime a user has left, your agent calls `get_user_quota`, which returns that specific remaining balance for an account. If you gotta top off an account or grant extra access, the system lets you increment a user's available play time using `add_user_quota`.

Basically, this server gives your AI client all ten tools it needs to manage sessions, check where they're running, make sure the platform is healthy, and handle the user accounts—all from one workflow. It’s everything you need right here.

## Tools

### add_user_quota
Increments a user's available play time on their account.

### create_session
Starts a brand new cloud gaming session using specific game and user IDs.

### get_cluster_info
Retrieves detailed operational information for one specified server cluster.

### get_game_detail
Fetches technical specs and metadata for a single NetEase cloud game title.

### get_session_status
Checks the current running status of an active gaming session ID.

### get_system_health
Reports the overall operational health of the entire cloud platform.

### get_user_quota
Returns the remaining play time balance for a specified user account.

### list_clusters
Provides a list of all active geographical server clusters available on NetEase Cloud Gaming.

### list_games
Generates an exhaustive catalog of all games supported by the platform.

### stop_session
Forces the immediate shutdown and termination of a specific, running session ID.

## Prompt Examples

**Prompt:** 
```
Create a cloud gaming session for game 'game_456' and user 'user_789'.
```

**Response:** 
```
Initializing NetEase cloud instance... Session created successfully. ID: `sess_abc123`. The game is now loading on the remote server. Would you like to monitor the session status?
```

**Prompt:** 
```
List all games currently available on the NetEase Cloud platform.
```

**Response:** 
```
Retrieving NetEase game catalog... I found several optimized titles including: 1. Onmyoji (ID: g1), 2. Naraka: Bladepoint (ID: g2), 3. Identity V (ID: g3). Which one would you like to launch?
```

**Prompt:** 
```
Show the remaining quota for user 'user_beta_1'.
```

**Response:** 
```
Checking user quota... User 'user_beta_1' has 120 minutes of cloud play time remaining out of a total monthly allowance of 500 minutes.
```

## Capabilities

### Create Game Sessions
Initializes a new, active cloud gaming instance for a user and game.

### Stop Active Sessions
Forces the immediate termination of a running cloud gaming session ID.

### Check Platform Health
Retrieves the overall operational status and health metrics for NetEase Cloud Gaming.

### Adjust User Quotas
Adds specific amounts of play time to a user's account quota.

### Query Game Details
Fetches technical specifications and metadata for any listed NetEase cloud game title.

### Inventory Server Clusters
Lists all active, regional server clusters managed by the platform.

## Use Cases

### Player retention check after an outage
A player reports that their session keeps dropping. The agent runs `get_session_status` to confirm if the connection is unstable, then uses `get_cluster_info` to see if the local cluster has known issues. This quickly isolates whether it’s a client problem or an infrastructure failure.

### Onboarding new game titles
The product team needs to check specs for 5 new games. They use `list_games` first, then run `get_game_detail` on each one individually to pull necessary data points (like required RAM or minimum network speed) before handing the info off to developers.

### Handling a runaway test account
A QA engineer leaves a testing session running overnight. Instead of having to find the ID and manually stop it, they pass the ID to `stop_session` directly through their agent. The instance shuts down immediately, saving resources.

### Checking premium user limits
A support agent needs to know if a high-value customer is running low on time. They use `get_user_quota` to check the remaining minutes, and if necessary, they can call `add_user_quota` instantly to extend the service.

## Benefits

- Check system uptime immediately. Instead of logging into a monitoring dashboard to find out if the platform is having issues, just call `get_system_health` to get one clean status report.
- Manage user access right from your chat. Need to give a test account more play time? Use `add_user_quota` instead of going through the billing backend system.
- Know exactly what's available. List all games with `list_games`, or dive deep into one title using `get_game_detail` before building integration points.
- Control resource usage precisely. Start a session when needed (`create_session`), and then guarantee it shuts down by calling `stop_session` to prevent billing waste.
- Track user limits without guessing. Use `get_user_quota` to see exactly how many minutes are left before a player hits their cap.

## How It Works

The bottom line is: you pass parameters to a tool, the MCP server talks to NetEase, and you get actionable operational data back in your chat window.

1. First, you subscribe to the NetEase Cloud Gaming MCP and generate your necessary `AccessKey` and `SecretKey` through the developer portal.
2. Next, your AI agent uses a tool—like `create_session`—passing in game IDs and user credentials. The server initiates the cloud instance on the backend.
3. Finally, the API returns the session ID and real-time status. You can then monitor it using tools like `get_session_status`.

## Frequently Asked Questions

**How do I use get_session_status to check if a game is running?**
You pass the active session ID to `get_session_status`. It returns the current state—like 'Running,' 'Paused,' or 'Error'—so you know what's actually happening with the stream.

**What is the difference between list_clusters and get_cluster_info?**
`list_clusters` gives you a directory of all available regions. You use `get_cluster_info` when you need deep, specific details (like load or uptime) about one cluster by name.

**Can I use add_user_quota to fix billing issues?**
Yes, if the issue is simply running out of minutes. You call `add_user_quota` and specify the amount in minutes that needs to be added back to the account balance.

**How do I list all the games available on NetEase Cloud Gaming?**
Call `list_games`. This returns a complete catalog of every optimized title you can stream, giving you their internal IDs needed for session creation.

**How does the `get_system_health` tool report on the NetEase Cloud Gaming platform's overall stability?**
It provides a snapshot of the entire infrastructure. The output details global system status, helping you quickly determine if there are any widespread issues across multiple server clusters before initiating work.

**If I need specific technical specs, what does the `get_game_detail` tool provide for a given title ID?**
You get comprehensive data on a single game. This includes optimized performance requirements and detailed specifications needed to ensure that the chosen game can run correctly in a cloud instance.

**What should I know about using the `stop_session` tool to terminate an active instance?**
This tool forces an immediate shutdown of a running session. It's best for cleanup or when a user needs to abandon a game quickly, preventing billing issues from orphaned instances.

**How can I use `get_user_quota` to check a user's remaining allowance before starting work?**
The tool returns the exact amount of cloud play time left for that specific user. This allows you to verify if they have enough minutes before attempting to create or monitor any new session.

**Can I check the remaining play time for a specific user?**
Yes! Use the `get_user_quota` tool. It will return the remaining minutes and total quota for the provided user ID.

**How do I monitor the health of the entire cloud gaming platform?**
Use the `get_system_health` tool. Your agent will perform a global connectivity and status check on the NetEase Cloud Gaming infrastructure.

**Can I list all available server clusters in Malaysia?**
Yes! Use the `list_clusters` tool to see the geographic distribution and health of server clusters optimized for cloud gaming.