# 4399 Open Platform MCP

> 4399 Open Platform MCP. Connect your AI agent directly to the leading Chinese game distribution ecosystem for full backend control. Validate user logins, track real-time payment status, monitor global leaderboards, and filter content—all from a single workflow.

## Overview
- **Category:** security
- **Price:** Free
- **Tags:** 4399-platform, game-distribution, auth-validation, payment-tracking, leaderboards, chinese-gaming

## Description

This MCP gives your agent deep access into the 4399 Open Platform, letting you manage critical server-side tasks for H5 and mobile games. Instead of jumping between multiple dashboards or relying on manual API calls, you let your AI client handle the heavy lifting. Need to know if a user session is legit? You can run `validate_login` instantly. Tracking payments is simple too; use `query_order` to get real-time status for any recharge order. Want to check if new chat content violates policy? Just fire off `check_sensitive_words`. The platform also lets you pull basic user data with `get_user_info`, manage social connections via `list_friends`, or submit scores using `submit_score` and `get_leaderboard`. When your agent handles this flow, it keeps everything automated. Vinkius makes connecting to complex systems like this straightforward, letting you build reliable game backends without the headache.

## Tools

### check_sensitive_words
Scans text content to filter out prohibited or sensitive terms defined by the platform policy.

### get_game_status
Checks and reports the current operational health status of the connected game project.

### get_leaderboard
Fetches a list showing the names and scores of top-ranking players in a specific competition.

### get_server_time
Retrieves the accurate, current timestamp used by the 4399 platform servers.

### get_user_info
Gathers and reports basic profile details for a specific user ID (UID).

### list_friends
Retrieves the list of friends associated with a given 4399 platform user.

### query_order
Checks the current status and details for any specific payment or recharge order ID.

### submit_score
Sends a new score record to be added to an existing global leaderboard.

### validate_login
Verifies if a user's provided login session and access token are legitimate and active.

## Prompt Examples

**Prompt:** 
```
Check the status of 4399 order ID 'order_999888777'.
```

**Response:** 
```
Running order query... I've retrieved the details for transaction 'order_999888777'. The current status is 'completed' for an amount of 50.00 CNY. Would you like me to log this transaction status?
```

**Prompt:** 
```
Validate login for 4399 user 'uid_123' with token 'tok_abc'.
```

**Response:** 
```
Connecting to 4399 authentication server... Validation successful! User 'uid_123' is correctly logged in. Session remains valid for the next 2 hours.
```

**Prompt:** 
```
Check if the text 'offensive word' is allowed by 4399 policy.
```

**Response:** 
```
Scanning content... The sensitive word filter flagged 1 term in your input. It is recommended to reject this content for role names or public chat.
```

## Capabilities

### Validate user sessions
Verifies if a connected user's login session and access token are currently active.

### Check payment order status
Retrieves the current, real-time operational status of any specific game recharge or transaction order.

### Retrieve user profiles
Fetches basic identifying and registration metadata for a given unique player ID (UID).

### Filter prohibited content
Scans text inputs, like role names or public chat messages, against a list of sensitive terms.

### Manage leaderboards and scores
Fetches the current top players list or submits new performance records to global rankings.

### Check game operational status
Retrieves the current service health and operational state of the connected game project.

## Use Cases

### A player submits a new high score.
The agent catches the submission. It first calls `get_server_time` to timestamp the event, then uses `submit_score` to post the record to the board, and finally runs `get_leaderboard` to confirm the user's new rank.

### A payment fails or is delayed.
The ops engineer asks the agent about a transaction ID. The agent immediately uses `query_order` to pull up the full status, letting them know if the failure was due to insufficient funds or an internal processing delay.

### A user account is suspected of cheating.
The team wants to audit the account. They use `get_user_info` to pull metadata and then run `list_friends` to see who the suspect was communicating with right before the suspicious activity.

### A new chat feature is rolled out.
The developer runs a pre-check. They feed sample text into `check_sensitive_words` and confirm that all potential offensive words are flagged, preventing any policy violations before launch.

## Benefits

- Automate payment reconciliation. Instead of manually checking transaction logs, you can use `query_order` to get the real-time status for any recharge or order ID.
- Maintain content integrity. When a user tries to chat or set a role name, use `check_sensitive_words` to automatically filter out prohibited terms before they hit the live server.
- Simplify user management. You don't need separate endpoints; you can pull basic player details with `get_user_info`, check their friends list via `list_friends`, and confirm active sessions using `validate_login`.
- Keep track of performance. Need to know who’s winning? Use `get_leaderboard` to fetch the top players, or use `submit_score` to instantly record a new high score.
- Reduce complexity with one source. Instead of juggling multiple APIs for user data and payments, this MCP centralizes all core 4399 functions into one repeatable workflow.

## How It Works

The bottom line is you get one unified command point for all 4399 platform features; no need to manage multiple APIs.

1. Subscribe to this MCP, then log into your 4399 Open Platform Console. Copy your AppKey (GameID) and Secret credentials.
2. Insert those keys into the configuration fields below. Your agent uses these credentials to connect directly to the platform's backend services.
3. You can now ask your AI client to perform complex tasks—like checking user info, querying order status, or validating a login—using natural language.

## Frequently Asked Questions

**How do I check a payment status using query_order?**
You pass the specific order ID to `query_order`. The tool returns the current state, telling you if the transaction is 'pending,' 'completed,' or 'failed,' along with relevant amounts.

**What kind of data does get_user_info provide?**
`get_user_info` pulls basic profile metadata for a UID. It's useful for getting registration details and general identifying information about the player.

**Can I check content moderation using check_sensitive_words?**
Yes, `check_sensitive_words` scans any given text—like role names or chat messages—against a built-in list of prohibited terms. It flags the specific words that violate policy.

**How do I submit scores using submit_score?**
You use `submit_score` and provide three things: the player ID, the score value, and optionally, a timestamp. The tool then pushes this data to the global leaderboard.

**What is the difference between get_user_info and list_friends?**
`get_user_info` gives you details about one person's profile. `list_friends` requires a user ID and returns a roster of other UIDs that are connected to them.

**What information does `validate_login` provide about a user's session?**
It confirms if a user is currently logged in and verifies their access token. The response tells your agent whether the session remains valid, often including an expiration time.

**How do I check the general health of the platform using `get_game_status`?**
It returns a clear operational status code for the 4399 Platform. Use this tool first to ensure services are up before having your agent attempt payments or leader updates.

**Can I filter which records appear when I run `get_leaderboard`?**
Yes, you pass specific criteria like player tiers or date ranges into the tool. This lets your agent pull highly filtered views instead of just fetching the overall top list.

**How do I validate a user login token from my backend?**
Use the `validate_login` tool with the user's `uid` and the `access_token` provided by the 4399 SDK. The agent will confirm if the session is legitimate and return the authentication code.

**Can I check the status of a specific payment order?**
Yes! Use the `query_order` tool with the 4399 order ID. Your agent will retrieve the transaction status, amount, and timestamp from the payment gateway.

**Does it support high score submission?**
Yes! The `submit_score` tool allows your agent to update the high score for a specific user ID on the configured 4399 leaderboard.