# Vivo Game Open Platform MCP > The Vivo Game Open Platform MCP manages mobile game distribution logistics for developers. It lets your agent validate user logins, check real-time payment order status, and report player progress directly into the Vivo Game Center. Use this if you need to automate backend processes for any app running on Vivo devices. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** vivo-games, mobile-distribution, game-center, auth-validation, payment-tracking, player-data ## Description If you manage a high-volume mobile or mini-game, you know that data integrity is everything—especially when money and player scores are involved. This MCP gives your agent direct access to the core services of the Vivo Game Open Platform. You can automate server validation by retrieving user profiles and validating tokens, query payment orders for their real-time status, and programmatically report detailed player activity. It lets you update character roles or fetch current application settings without logging into a console. For payments and player progress reports, every call generates a cryptographically signed audit trail through Vinkius. This means you always have a tamper-proof record of exactly who did what and when—a must-have for live operations teams. The platform also lets you list available virtual items or check the current server time to keep your game logic perfectly synchronized. ## Tools ### get_app_config Retrieves current application configuration settings defined on the Vivo platform. ### get_server_time Synchronizes your local system time with the official Vivo platform server clock. ### get_user_info Pulls basic profile data for a specific user from the Vivo account service. ### list_game_servers Queries and returns a list of currently configured game servers. ### list_items Retrieves details on all virtual items that are available for use in the application. ### query_order Checks the real-time status of a specific payment order ID. ### report_game_data Submits player progress, scores, and achievements to the Vivo Game Center rankings system. ### report_role_info Updates or reports character/role information, like names and server assignments, for a user. ### validate_login Verifies if a provided user login token is valid against the Vivo SDK credentials. ## Prompt Examples **Prompt:** ``` Check the status of Vivo order ID 'cp_order_555666'. ``` **Response:** ``` Connecting to Vivo payment servers... I've retrieved the details for order 'cp_order_555666'. The current status is 'success' for an amount of 10.00 CNY. The transaction is ready for virtual item delivery. ``` **Prompt:** ``` Validate the login token 'tok_vivo_abc' from the client. ``` **Response:** ``` Requesting validation from Vivo Auth... Success! The token is valid and corresponds to OpenID: `user_888999`. You can now proceed with the user's game session. ``` **Prompt:** ``` List all active game servers configured in the Vivo console. ``` **Response:** ``` Retrieving server list... I found 3 active servers: 1. Asia-East (ID: srv_1), 2. Global-South (ID: srv_2), 3. Test-Net (ID: srv_3). All are currently 'online'. ``` ## Capabilities ### Authenticate Users Validate user tokens and retrieve unique basic profile data from the Vivo account service. ### Handle Payments Check the status of specific payment orders to reconcile transactions against virtual goods delivery. ### Manage Player Data Submit player progress, high scores, and character role details into the official Vivo Game Center rankings. ### Check System Status Retrieve current application configuration settings or list active game servers for deployment checks. ## Use Cases ### Handling Failed Payments A user reports a payment issue. Instead of logging into the Vivo console, your agent runs query_order using the specific order ID, confirms the status is 'failed,' and alerts the operations team immediately. ### Onboarding New Servers The DevOps engineer needs to confirm deployment readiness. The agent first calls list_game_servers to see all active IDs, then uses get_app_config to verify which settings should be applied across the board. ### Player Leveling Sync When a player reaches a new milestone, the system automatically runs report_role_info to update their character name and level on the Vivo platform before triggering the next game sequence. ### Session Security Check Before allowing any user to access premium content, your agent calls validate_login with the provided token. If it fails, the session is immediately blocked, preventing unauthorized access. ## Benefits - Stop manually checking order statuses. Use query_order to get real-time payment reconciliation data directly into your agent's response. - Maintain player history integrity by using report_game_data, which pushes scores and progress straight to the Vivo Game Center rankings. - Keep your game logic consistent everywhere. Calling get_server_time ensures that time-sensitive functions run on the platform's clock. - Validate users instantly. validate_login checks tokens against the Vivo SDK so you know immediately if a client session is legitimate. - Manage player assets by using report_role_info to update character data, and list_items to check what virtual goods are available for sale. ## How It Works The bottom line is that you get an automated bridge between your backend logic and the official Vivo game distribution systems. 1. First, you need your AppID, AppKey, and AppSecret from the Vivo Developer Console. 2. Next, plug those credentials into the MCP fields. This lets your agent connect to the protected platform services. 3. Your AI client then uses the configured tools to run specific actions, like checking a payment order or updating player scores. ## Frequently Asked Questions **How do I validate a Vivo login token from my backend?** Use the `validate_login` tool with the user's token provided by the Vivo SDK. The agent will connect to the Vivo verification server and return the `openid` if the session is legitimate. **Can I automatically query the status of a specific order?** Yes! Use the `query_order` tool with your CP Order ID. Your agent will retrieve the payment status, amount, and internal transaction reference directly from the Vivo gateway. **How do I report character role information to the platform?** Use the `report_role_info` tool with a JSON string containing the character details (name, level, server). This is essential for compliance and social features within the Vivo ecosystem. **How do I check the current application settings using `get_app_config`?** It retrieves all necessary app configurations directly from the Vivo platform. This is vital for ensuring your agent uses the correct keys and endpoints before making any other calls. **How can I check if my game servers are online using `list_game_servers`?** The tool queries and returns a list of all configured game servers. You can use the returned IDs to verify which endpoints are currently active for your player sessions. **If my payment reports fail due to time differences, how do I sync using `get_server_time`?** Running this tool synchronizes your agent's clock with the official Vivo platform server time. This guarantees that timestamps in your data submissions are accepted by the backend systems. **What virtual items are available for sale using `list_items`?** The tool fetches a list of all cataloged virtual items associated with your app. This is useful for building inventories and ensuring the payment system knows what to deliver after a successful transaction. **What data points should I include when calling `report_game_data`?** You must submit player progress, high scores, and level data to the Vivo Game Center. The agent requires specific parameters for these fields to accurately record player achievements.