# Apex Legends MCP > Apex Legends MCP gives you direct access to real-time game data, including player combat metrics, detailed match histories, global leaderboards, and current server status. Stop juggling multiple websites; pull every performance stat or map rotation directly into your agent's workflow. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** apex-legends, battle-royale, player-stats, gaming-api, match-tracking ## Description Need to track competitive gaming data? This MCP connects your AI client straight to the Apex Legends API. You can get accurate player statistics by name or unique ID, pulling detailed combat metrics and rank information instantly. Need a deep dive on performance? Use it to grab entire match records over time, managing both recent and legacy history. It also provides critical live data points, like tracking which maps are currently in rotation or checking the overall server health. This eliminates having to open five different websites just to build one report. By connecting this MCP through Vinkius, you're putting a full suite of competitive analysis tools right into your natural conversation flow. ## Tools ### get_leaderboard Retrieves a list of the top 500 players based on specific, regularly updated statistics. ### manage_legacy_match_history Allows you to perform actions like adding, retrieving, or deleting records for historical match data. ### get_map_rotation Returns the list of maps that are currently active or scheduled next in the game's rotation cycle. ### get_match_history Pulls a player’s most recent match results; note that this data needs continuous requests to collect new entries. ### get_name_to_uid Converts a general username into the system's unique identifier (UID) across multiple gaming platforms. ### get_origin_uid Retrieves a player’s unique ID specifically when using an Origin account name on PC. ### get_player_stats_by_name Gets a player's combat statistics using their visible username and associated platform (for PC users). ### get_player_stats_by_uid Fetches a player's current, detailed performance metrics using their permanent unique ID; this is the most reliable method for repeated queries. ### get_predator_requirements Calculates and returns the specific Rank Points (RP/AP) needed to achieve Apex Predator status. ### get_server_status Checks the current operational health and status of the main Apex Legends game servers. ## Prompt Examples **Prompt:** ``` What is the current map rotation for Battle Royale? ``` **Response:** ``` I'll check that for you. Currently, the map is 'World's Edge' with 45 minutes remaining. The next map in rotation will be 'Storm Point'. ``` **Prompt:** ``` Get the stats for player 'Genburten' on PC. ``` **Response:** ``` Fetching stats for Genburten... Found! They are currently at Apex Predator rank with 25,400 RP. Their most played legend recently is Horizon with 15,000+ kills tracked. ``` **Prompt:** ``` Show me the top 5 players on the global leaderboard for Wraith kills. ``` **Response:** ``` Accessing the leaderboard... The top 5 Wraith players globally are: 1. PlayerA (210k kills), 2. PlayerB (195k kills), 3. PlayerC (188k kills), 4. PlayerD (182k kills), 5. PlayerE (175k kills). ``` ## Capabilities ### Analyze Player Performance Get detailed combat metrics and rank data for any player using their name or unique identifier. ### Review Match Records Access a player's recent match results, managing both current and long-term history tracking. ### Check Global Rankings View the top players on global leaderboards or determine the rank points needed for Apex Predator status. ### Monitor Game Status Stay up-to-date on current server health and which maps are rotating in the game mode. ### Resolve Player IDs Convert a player's visible username into their unique system ID (UID) for reliable data querying. ## Use Cases ### Analyzing an Opponent's Weaknesses A coach needs to know if a rival player relies on close-quarters combat. They ask their agent, 'Check the kill metrics for PlayerX using get_player_stats_by_uid.' The agent returns precise data showing high long-range damage output, telling the coach exactly where they need to focus defensive strategy. ### Building a Weekly Performance Report A data analyst needs weekly stats for five players. They ask their agent to get_player_stats_by_uid for all five IDs, then request the top 50 global rankings using get_leaderboard to build a single, cohesive report. ### Pre-Game Content Scheduling A content creator needs to write an article about upcoming gameplay changes. They ask their agent for the current map rotation using get_map_rotation and check if the server is operational using get_server_status before publishing anything. ### Tracking a Player's Rank Progress A dedicated player wants to track their journey to Apex Predator. They ask for the current requirements with get_predator_requirements, then check their historical data using manage_legacy_match_history to see how many wins it took. ## Benefits - Stop guessing a player's rank. Use get_player_stats_by_uid to reliably pull their current combat metrics, whether they play on PC or console. - Never lose track of performance data again. You can build comprehensive reports by accessing both recent match results via get_match_history and managing old records with manage_legacy_match_history. - Keep your community informed instantly. Check server health using get_server_status, so you know immediately if the game is having issues before anyone asks you. - Understand the meta. Use get_map_rotation to see which maps are currently active or scheduled next, giving you a competitive edge in predicting gameplay. - Quickly identify targets for analysis. If you only have a player's username, use get_name_to_uid first to get their permanent ID before running any other stats tool. ## How It Works The bottom line is you tell your AI client what data you need, and it handles connecting to the game API and pulling the results for you. 1. First, subscribe to the Apex Legends MCP and enter your API key credentials. 2. Next, prompt your AI client with a request like 'What were Player X's stats last week?' 3. Finally, the agent uses the necessary tools to pull structured data—whether it's match history or leaderboard rankings—and delivers it in plain text. ## Frequently Asked Questions **How do I find a player's stats if I only know their username?** You must first convert the name to an ID. Use get_name_to_uid or get_origin_uid to grab the unique UID, and then pass that UID into get_player_stats_by_uid for accurate metrics. **Is get_match_history real-time?** No, you must make a repeated request every four minutes using get_match_history to ensure the agent collects all available new match data for the player. **What is the best way to run multiple stat checks?** For reliability and efficiency on repeat queries, always use your unique ID with get_player_stats_by_uid rather than relying on searching by name using get_player_stats_by_name. **How do I check if the game servers are online?** Use the get_server_status tool. This instantly checks the current operational health of the main Apex Legends game services, letting you know if players can connect right now. **Can I see what maps will be used next in a match?** Yes, running get_map_rotation provides both the currently active map and the subsequent maps that are scheduled to rotate into play for the current game mode.