# Oppo Game Open Platform MCP > Validate user sessions, query payments, and report player data for Oppo games. This MCP provides 8 tools to manage game distribution backend tasks directly from your AI agent. You can check if a user is logged in using `validate_login`, find the status of any payment with `query_order`, or send high scores via `report_game_data`. It's your single source for Oppo gaming logistics. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** oppo-games, mobile-distribution, game-center, auth-validation, payment-tracking, player-data ## Description ## Oppo Game Open Platform MCP This service gives your AI client direct command over the backend logistics for anything running on the **Oppo Game Open Platform**. You're not just reading data; you're managing core server functions—user authentication, payment records, and player progress reports. It’s everything you need to run a tight ship without ever touching a console. ### User Identity & Session Management You gotta know who you’re talking to before you let them do anything else. You'll use `validate_login` first; that verifies if the user's login session is active and legit using their Oppo SDK token. Once that passes, you can grab basic profile details for any specific player with `get_user_info`. If you need to know what in-app items they’ve bought or what’s available for purchase, run `list_sku_details` to query all the configured SKUs. ### Tracking Progress and Roles Keeping track of player activity is huge. You'll use `report_game_data` to submit anything from high scores and achievements to complex progress metrics directly into the official Oppo records. If you need to update a character’s status—like their name, level, or server assignment—you call `report_role_info`. It keeps your entire roster accurate in the system. ### Payments and System Health When money's involved, you gotta be airtight. Use `query_order` to check any specific payment transaction ID; it spits out the real-time status so you know if the sale went through or if something broke. For general platform health checks, run `get_oppo_app_status` to confirm the live operational state of the Oppo Game Center app. You can also sync up your clock by running `get_oppo_server_time`, which pulls the accurate server time from the platform. ### How It Works in Practice Think of it like this: Your agent handles a new user login attempt. First, you check credentials with `validate_login`. If that passes, your agent grabs their profile data using `get_user_info`. Next, when they play and hit a high score, the system sends the data to `report_game_data` for official tracking. If they buy a new skin, you confirm the payment status right away with `query_order`. Meanwhile, if an admin needs to update their character's rank or level, they just use `report_role_info`. You get all that crucial backend control—authentication, financial records, and player data reporting—all through these eight tools. It's your single stop for Oppo gaming logistics. ## Tools ### get_oppo_app_status Checks the live operational status of the Oppo Game Center application. ### get_oppo_server_time Retrieves the current, accurate server time from the Oppo platform. ### get_user_info Gets basic profile data for an identified Oppo user ID. ### list_sku_details Queries a list of all configured in-app purchase items (SKUs) available to the game. ### query_order Checks and reports the current status of any specific Oppo payment transaction ID. ### report_game_data Submits player scores, progress metrics, and achievements to the official Oppo platform records. ### report_role_info Sends updated character role data, like names and levels, to the tracking system for record keeping. ### validate_login Verifies if a user's login session is active and legitimate using their Oppo SDK token. ## Prompt Examples **Prompt:** ``` Check the status of Oppo order ID 'oppo_pay_123456789'. ``` **Response:** ``` Connecting to Oppo payment gateway... I've retrieved the details for order 'oppo_pay_123456789'. The current status is 'Success' for an amount of 30.00 CNY. The transaction has been confirmed and is ready for virtual item fulfillment. ``` **Prompt:** ``` Validate the user session with token 'tok_oppo_xyz' and ssoid 'sso_777'. ``` **Response:** ``` Requesting validation from Oppo Auth... Success! The session is legitimate. User SSOID: `sso_777`. You can now initialize the player's profile and progress. ``` **Prompt:** ``` List all configured in-app purchase items for my Oppo game. ``` **Response:** ``` Retrieving SKU catalog... I found 3 configured items: 1. 100 Gems (ID: gem_100, Price: 6.00 CNY), 2. Starter Pack (ID: bundle_1, Price: 30.00 CNY), 3. Season Pass (ID: pass_s1, Price: 68.00 CNY). ``` ## Capabilities ### Verify User Identity and Session The agent validates a user's login session using an Oppo SDK token, confirming if the credentials are legitimate before proceeding with any data calls. ### Check Payment Status You can check the real-time status of any payment order by submitting the transaction ID to determine success or failure. ### Report Player Progress and Scores The agent submits player achievements, high scores, and level data directly to the Oppo Game Center for official tracking. ### Retrieve User Profile Details Your AI client fetches basic profile information for a specific Oppo user ID. ### Manage Character Roles and Levels You update or report critical character data, including names, levels, and server assignments. ### Check App and Server Health The agent confirms the current application status and synchronizes the system clock against the Oppo platform time. ## Use Cases ### Handling a Failed Purchase A user claims they paid for a gem bundle but it never showed up. Instead of emailing support, your agent runs `query_order` with the transaction ID. The result shows 'Success,' and your agent can immediately trigger the virtual item delivery logic. ### New User Onboarding A new user logs in. Your agent first calls `validate_login` to confirm their SSOID is active. If successful, it then uses `get_user_info` to pull the initial profile data needed for the game lobby. ### End-of-Season Ranking Dump The season ends and scores need aggregating. Your agent iterates through all top players, calling `report_game_data` for each one to submit their final high score to the Oppo platform center. ### System Time Drift Fix The game server clock drifts slightly from the official Oppo time. Your agent quickly calls `get_oppo_server_time` to pull the correct timestamp, ensuring all transaction logging is accurate and synchronized. ## Benefits - Stop guessing about user status. Use `validate_login` to confirm a session token is live before letting the user proceed. This cuts down on failed transactions at the start of a game. - Never manually check payment records again. Calling `query_order` gives you immediate, programmatic access to transaction success or failure, which is key for virtual item fulfillment. - Keep your game data accurate. When a player levels up or scores high, use `report_game_data`. This tool ensures the official Oppo platform sees the progress immediately. - Manage user identity centrally. Instead of just getting basic info, use `get_user_info` to pull a clean profile snapshot for immediate backend processing. - Fixing data errors is fast. If player roles are wrong, you don't need an admin portal; call `report_role_info` directly and send the correct record. ## How It Works The bottom line is: You give us your credentials, and we handle all the back-and-forth with the Oppo platform for you. 1. First, subscribe to this server on Vinkius and get your AppID/AppKey from the Oppo Developer Console. 2. Next, pass those credentials into the MCP fields. Your agent initializes the connection layer using these keys. 3. Finally, you call a tool like `validate_login`. The service uses the stored keys to communicate with the live Oppo platform and returns the structured result. ## Frequently Asked Questions **How do I check if an Oppo payment was successful using query_order?** Call `query_order` and pass the specific transaction ID. The response provides a clear status (e.g., 'Success' or 'Pending') and confirms if the funds were transferred for that amount. **Do I need to use validate_login before running other tools?** Yes, it is best practice. Always call `validate_login` first. It confirms the session integrity and gives you a verified SSOID, which should then be used for subsequent calls like `get_user_info`. **Can I use report_game_data to update player names?** No. Use `report_game_data` only for scores and progress metrics. To change a character's name or level, you must call the dedicated `report_role_info` tool. **What is the best way to get basic user details?** First, run `validate_login` to ensure the session works. Then, use `get_user_info`, passing the resulting verified SSOID to pull their profile data. **If my application is having issues, how do I check the health using get_oppo_app_status?** Run `get_oppo_app_status` to confirm your integration point. This tool checks if the core Oppo Game Center services are active and reachable. It's essential for debugging connectivity issues before running any data reporting or login validation. **What specific parameters does report_role_info need for accurate player tracking?** The `report_role_info` tool requires the unique user ID, the role name (e.g., 'Warrior'), and the current level number. Sending an incomplete payload will fail validation because it can't track character progress properly. **Why should I use get_oppo_server_time instead of my local clock?** You must use `get_oppo_server_time` to ensure transaction timestamps are accurate. Relying on your client's system time can cause sync errors, especially when reconciling payments or ranking data against the central Oppo platform records. **How do I verify that a specific item is available by using list_sku_details?** You use `list_sku_details` and filter by the Item ID or SKU name. The tool returns all configured items, allowing you to confirm existence and see current pricing without needing to query an external catalog. **How do I validate an Oppo login token from my backend?** Use the `validate_login` tool with the token and `ssoid` provided by the Oppo SDK. The agent will connect to the Oppo verification server and confirm if the session is legitimate. **Can I automatically query the status of an Oppo transaction?** Yes! Use the `query_order` tool with your unique CP Order ID. Your agent will retrieve the payment status, amount, and internal order metadata directly from the Oppo gateway. **How do I list the configured virtual goods (SKUs) for my app?** Use the `list_sku_details` tool. Your agent will return all in-app purchase items configured in your Oppo Developer Console, including prices and product names.