# Heybox MCP > Heybox MCP provides direct access to China’s major PC gaming database, Heybox (小黑盒). Track market prices for in-game items like CS2 or PUBG skins, review detailed match history, and pull player statistics from competitive accounts. It lets your AI client monitor community trends and track item values directly. ## Overview - **Category:** data-management - **Price:** Free - **Tags:** heybox, xiaoheihe, steam-stats, gamer-database, gaming-community, market-data ## Description This MCP connects your agent to the vast data network of Heybox, one of China's biggest gaming platforms. Instead of manually checking multiple websites for price changes or stats, you let your AI client handle the work. You can pull granular information about specific games, check current market values for skins and items, and track a player’s entire match history across competitive titles like PUBG and CS2. It pulls together everything from trending community posts to official game news and item listings. Whether you're checking if a title is gaining popularity or monitoring the price of a rare skin, your AI agent gets the data instantly. All this functionality is managed through Vinkius, which hosts and manages this MCP so you can connect it once from any compatible client. ## Tools ### get_heybox_app_status Checks the operational status and task progress within the Heybox application. ### get_game_info Retrieves comprehensive details about a specific game title. ### get_market_prices Gets the current trading values for specific in-game items, like skins or virtual goods. ### get_match_history Retrieves a list of recent matches played by a user in competitive games. ### get_post_detail Fetches the full, complete text content of any single community board post. ### get_user_stats Gathers specific gaming statistics and metrics for a designated user account. ### list_community_posts Shows the most popular or trending posts across any given community board. ### list_discount_games Lists all games that are currently marked as discounted on the platform. ### list_game_news Retrieves the latest articles and general news updates from the gaming industry. ### list_lotteries Fetches a list of current, official item lotteries or giveaways running on Heybox. ## Prompt Examples **Prompt:** ``` Get the current market prices for CS2 items from Heybox. ``` **Response:** ``` Retrieving market data... I found current prices for top CS2 skins. For example, 'Butterfly Knife | Lore' is trending at ¥XXXX. Would you like a full list of recent skin transactions? ``` **Prompt:** ``` Show me the top trending posts in the PUBG board. ``` **Response:** ``` Fetching community feed for PUBG... I found 3 trending posts: 1. 'New Map Leak' (2.5K likes), 2. 'Pro Tips for Sniping' (1.8K likes), 3. 'Tournament Announcement' (1.2K likes). ``` **Prompt:** ``` Get detailed info for Steam game ID '570' (Dota 2). ``` **Response:** ``` Querying Heybox game database... Dota 2 (ID: 570) has a community score of 9.5/10. It is currently one of the most played games in the Chinese region. Would you like to see recent news for this title? ``` ## Capabilities ### Monitor Market Value Check current market prices for specific game items and monitor active item lotteries. ### Analyze Player Performance Retrieve a player's full match history, playtime totals, and rank progression records. ### Track Game/Title Details Get core information about any game title, including community ratings and market presence. ### Review Community Sentiment List the top posts, news articles, and trending discussions from massive gaming boards. ### Identify Discounted Games Retrieve a list of games currently on sale or discounted through the platform. ## Use Cases ### Analyzing Competitive Player Growth A team needs to know if a competitor's top player is improving. Instead of manually logging into their profile, the agent runs get_user_stats and checks get_match_history for the last two months to plot rank progression and playtime changes. ### Pricing a Rare Item for Sale A trader wants to price an item. The agent calls get_market_prices to see the current average sale value, checks list_lotteries to see if similar items are being given away, and gets game info to confirm the title's general popularity. ### Tracking Dev Interest in a Title A developer wants to gauge interest in an older Steam title. They run list_community_posts on the associated board, check get_game_info for current ratings, and cross-reference it with list_game_news to find buzz. ### Monitoring Platform Activity A business intelligence analyst wants a broad view of activity. They combine calling list_community_posts, getting the latest game news via list_game_news, and checking get_heybox_app_status to build a daily operational report. ## Benefits - Market Intelligence: Use get_market_prices to stop guessing. You can track the real-time value of skins or items, which is crucial for e-commerce selling. - Deep Performance Metrics: Get a full picture of player skill by running get_user_stats and reviewing specific match history records using get_match_history. - Community Pulse Check: List community posts gives you immediate insight into what players are talking about. You can see exactly which topics are trending without manual searching. - Game Discovery: Need to know what's hot? list_discount_games shows available deals, and getting game info helps you understand the market reception for a title. - Stay Updated: Instead of checking multiple sources for news, simply calling list_game_news centralizes all major industry updates in one API call. ## How It Works The bottom line is, once you feed it the right keys, your agent has access to deep data across multiple game verticals without needing to visit any external site. 1. First, you must subscribe to this MCP and log into the Heybox Developer Platform. 2. Next, apply for official API access there. This process gives you an API Key—you'll need that key and your User ID. 3. Finally, input those credentials into the connection fields. Your AI client can then start automating gaming market research. ## Frequently Asked Questions **How do I check current skin prices with get_market_prices?** You pass the specific item name or ID to the tool. It returns the live, updated market value for that skin across multiple exchanges and lotteries. **Can I find out how good a player is using get_user_stats?** Yes, this tool gathers comprehensive metrics about the user's history. It provides performance stats like total matches played and rank progression over time. **What does list_community_posts do?** It lists the most popular or trending posts on a given board, so you can quickly gauge current community interest without reading every thread. **Do I need an API Key to use get_game_info?** Absolutely. The Heybox Developer Platform requires an official API key and user credentials for the MCP to function, ensuring data integrity. **How do I check my connection status using get_heybox_app_status?** This tool verifies your current operational status within Heybox. Before running complex data queries, use it to confirm that your API key and access are correctly configured. This saves time by preventing errors from bad connections. **What is the difference between listing posts and using get_post_detail?** While list_community_posts shows titles, get_post_detail retrieves the complete content of a single post. Use this function when you need to analyze detailed discussions or specific quotes from a community board. **Are there any rate limits I should know about when using get_match_history?** Yes, keep usage mindful of the API's rate limits. We recommend batching your requests for match history rather than making rapid, individual calls to ensure stable and reliable data flow. **How do I find out which games are currently discounted using list_discount_games?** This tool pulls a specific list of titles marked down or on sale across the platform. It's helpful for quickly identifying deals without having to filter through all available market data. **Can I check my PUBG or CS2 rankings automatically?** Yes! Use the `get_user_stats` tool with your Heybox User ID and the target game identifier. Your agent will retrieve your current rank, playtime, and other competitive metrics. **How do I find the correct board ID for community posts?** Board IDs correspond to specific game communities (e.g., PUBG, CS2, Cyberpunk 2077). You can find these IDs in the URL of the board when browsing the Heybox web portal. **Can I list active giveaways and lotteries on Heybox?** Yes! Use the `list_lotteries` tool. It will retrieve all currently active community giveaways where users can win game keys or other prizes.