# Riot Games MCP for AI Agents AI Agent Connect > Riot Games MCP lets you pull League of Legends player data directly into your AI client. You can look up summoner profiles, check ranked stats, browse match histories, and see live game info. It handles the heavy lifting of interacting with the Riot Games API so you don't have to manually hunt for stats or copy-paste match details. ## Overview - **Category:** industry-titans - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_bjqCHNP2y9fVj1zcYKQNqevKdvPC3SwlyUu5r2cU/ai-agent-connect - **Tags:** player-profiles, match-data, ranked-stats, gaming-api, summoner-data ## Description This Connector connects you directly to the Riot Games API to pull League of Legends player data through natural conversation. Instead of jumping between browser tabs to look up stats, you can just ask your agent to find a specific summoner profile or check a player's ranked history. You can dig into recent matches to see exactly what items, runes, and gold totals a player had during a specific game. If you're trying to understand a player's skill level, you can pull their champion mastery points to see which characters they spend the most time on. It even handles live game data, showing you current team compositions and bans for games happening right now. For those who need to see high-level play, you can pull featured games from various regions to see what the pros are doing. By using this Connector within the Vinkius catalog, you turn your AI into a specialized gaming analyst. You get to skip the manual work of data entry and move straight to the analysis. Whether you're a coach looking for patterns or a player trying to improve, this gives you the raw data you need without the friction of manual searching. You can even get full champion details like abilities and lore to help with theorycrafting. It's about getting the facts you need quickly so you can spend more time on the game itself. ## Tools ### get_champion_masteries Retrieve a player's mastery levels, points, and tokens for every champion they've played. It helps show a player's experience. ### get_featured_games Look up high-elo live games currently in progress across different regions. This helps find the best games to watch. ### get_league_entries Pull ranked tier, LP, and win/loss records for a specific summoner. It gives a clear view of a player's competitive standing. ### get_account_by_riot_id Find a player's PUUID and metadata by searching for their specific game name and tag line. Use this to start any player lookup. ### get_champion_details Fetch full champion stats, abilities, and lore from the static data library. This is perfect for theorycrafting and research. ### get_champions List every champion in the game along with their specific locale and version data. Use this to see the full roster. ### get_account_by_puuid Get account metadata, including the game name and tag line, using a unique player ID. This is useful for verifying account details. ### get_active_game See the current live game for a summoner, including team info, bans, and runes. It provides a real-time look at ongoing matches. ### get_match Get comprehensive data for a specific match using its unique match ID. This provides the deepest level of match analysis. ### get_match_ids Pull a list of recent match IDs for a player to use for deeper history analysis. It's the first step to browsing a full history. ### get_summoner_by_id Retrieve a summoner's level and profile icon ID using their specific summoner ID. Use this for specific profile lookups. ### get_summoner_by_puuid Get a summoner's profile information based on their unique PUUID. This is the standard way to fetch profile data. ## Prompt Examples **Prompt:** ``` Find the summoner Faker on KR server. ``` **Response:** ``` Faker#KR1 found. * **Summoner Level:** 687 * **PUUID:** xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx * **Summoner ID:** xxxxxxxxxxxxxx I can now pull match history or ranked stats for this account if you'd like. ``` **Prompt:** ``` What's Faker's ranked stats on KR? ``` **Response:** ``` Here are the current ranked stats for **Faker#KR1** on the KR server: | Queue | Tier | LP | Record | Win Rate | | :--- | :--- | :--- | :--- | :--- | | **Solo/Duo** | Challenger I | 1456 | 412W / 298L | 58.0% | | **Flex** | Master I | 234 | 89W / 67L | 57.1% | * **Hot Streak:** Yes ``` **Prompt:** ``` Get Faker's last 5 match IDs. ``` **Response:** ``` Found 5 recent matches for **Faker#KR1**: 1. KR_7234567890 2. KR_7234567889 3. KR_7234567888 4. KR_7234567887 5. KR_7234567886 Would you like me to pull the full details for any of these matches? ``` ## Capabilities ### Look up player profiles Find a specific player by their game name and tag line to get their unique ID and account details. ### Extract match history Pull a list of recent matches and get deep details on KDA, items, and gold for each game. ### Check ranked progress View current tiers, league entries, and win rates for a specific summoner across different queues. ### View champion masteries See how much time a player has spent on specific champions including mastery levels and points. ### Monitor live games See who is currently in-game along with their team composition, bans, and selected runes. ### Fetch champion data Get full details on any champion including their abilities, base stats, and lore. ## Use Cases ### The Coach's Post-Game A coach asks for the last 10 match IDs and wants a summary of the team's KDA. The agent pulls the data and highlights the most impactful plays. ### The Content Creator's Hunt A creator wants to find high-elo live games to see what the best players in the world are doing. The agent finds featured games instantly. ### The Theorycrafter's Research A player wants to know the mastery points and tokens for a champion they're trying to learn. The agent pulls the exact mastery data. ### The Rival Scout A player wants to see the ranked stats and tier of a specific opponent before a match. The agent pulls the league entries and win rates. ## Benefits - Stop copy-pasting match data. Use get_match and get_match_ids to let your agent handle the heavy lifting of history analysis. - Analyze meta trends faster. Use get_champion_masteries to see which champions are actually being played in high-level play. - Get real-time scouting. Use get_active_game to see what the competition is doing in live matches right now. - Simplify player lookups. Use get_account_by_riot_id to find any player's details without searching through external websites. - Deep dive into champion lore. Use get_champion_details to get complete stats and abilities for every character in the game. ## How It Works The bottom line is you get direct access to League of Legends data without ever leaving your chat interface. 1. Subscribe to the Riot Games MCP on Vinkius. 2. Enter your Riot Games API key from the developer portal. 3. Ask your AI client to find stats or match history for any player. ## Frequently Asked Questions **Can the Riot Games MCP find a player by their name?** Yes, you can find any player by searching for their game name and tag line. The Connector will then provide their unique ID and account details. **How can I use the Riot Games MCP to see live matches?** You can ask your agent to check if a specific player is currently in a game. It will return the game mode, team composition, and current bans. **Does the Riot Games MCP show champion mastery points?** Yes, it can pull mastery levels, points, and tokens for every champion a player has interacted with, making it easy to see their experience. **Can I get match history with the Riot Games MCP?** You can pull a list of recent match IDs and then request full details for any of those matches, including KDA, items, and gold totals. **Can I use the Riot Games MCP for esports coaching?** It is perfect for coaching. You can analyze player performance, check ranked distributions, and review match data to build better strategies. **What regions does the Riot Games MCP support?** The Connector supports several major regions including North America, Europe, Korea, Japan, and others. Just specify the region when asking for data. **How do I get a Riot Games API key?** Register at [**developer.riotgames.com**](https://developer.riotgames.com/) and sign in with your Riot account to get your personal development API key. It's free and works immediately. **What is a PUUID?** PUUID (Player Universally Unique Identifier) is a unique ID assigned to every Riot account. It's required for most API calls like match history and champion masteries. Get it using get_account_by_riot_id with the player's game name and tag line. **What are platform codes?** Platform codes identify specific game servers: na1 (North America), euw1 (Europe West), eun1 (Europe Nordic & East), kr (Korea), br1 (Brazil), jp1 (Japan), la1/la2 (Latin America), tr1 (Turkey), oc1 (Oceania). Match history uses regional routing instead: americas, europe, asia, sea. **What are the API rate limits?** Development API keys are limited to 20 requests per second and 100 requests per 2 minutes. If you exceed these limits, the API returns a 429 error. Wait a moment and retry.