Riot Games MCP. Analyze match history and ranked performance instantly.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Riot Games MCP Server accesses League of Legends player data through your AI client. It pulls summoner profiles, current ranked stats (LP/Tier), full match history details (KDA, items, gold), and live game compositions for any Riot ID or PUUID.
What your AI agents can do
Get account by puuid
Gets the game name, tag line, and metadata for an account using its PUUID.
Get account by riot id
Translates a player's Riot ID (game name + tag line) into the required PUUID, along with basic account details.
Get active game
Returns detailed info on a summoner currently in a game, including team comps, bans, and spells. Returns 404 if they aren't playing.
Get a player's unique PUUID and account metadata by supplying their Riot ID or searching by existing PUUID.
Retrieve current league standings, including tier, LP, win/loss counts, and hot streak status for any competitive queue.
Fetch detailed data—like KDA, items, runes, gold, and damage—for a specific match ID or browse up to 20 recent matches.
Determine if a summoner is currently in a game, returning team compositions, banned champions, and active spells. It can also list high-elo games happening now.
View how skilled a player is with specific champions by pulling their mastery levels, points, and the tokens needed for the next rank.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Riot Games MCP Server: 12 Tools for Player Data
These tools give your agent the ability to pull every piece of structured League of Legends data, from basic account IDs to deep match history metrics.
019d8478get account by puuid
Gets the game name, tag line, and metadata for an account using its PUUID.
019d8478get account by riot id
Translates a player's Riot ID (game name + tag line) into the required PUUID, along with basic account details.
019d8478get active game
Returns detailed info on a summoner currently in a game, including team comps, bans, and spells. Returns 404 if they aren't playing.
019d8478get champion details
Fetches static data for any champion, including abilities, stats, and lore (no API key needed).
019d8478get champion masteries
Returns a player's mastery level, points, and tokens for specific champions on different servers.
019d8478get champions
Lists all League of Legends champions using static data, supporting optional version and locale inputs.
019d8478get featured games
Retrieves details on high-elo live games currently in progress, showing compositions and spells.
019d8478get league entries
Gets a player's current ranked league standing, including tier, LP, wins/losses, for specified queues and servers.
019d8478get match
Pulls full match details—including KDA, items, runes, etc.—by providing the regional routing and a specific match ID.
019d8478get match ids
Gets up to 20 recent match IDs for a player based on their PUUID and regional setting.
019d8478get summoner by id
Retrieves core profile data (level, icon ID, account ID) using the summoner's unique ID number.
019d8478get summoner by puuid
Gets a player's general profile info by providing their PUUID. This is often needed before querying stats.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Riot Games, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Yo, this isn't just some API wrapper—it’s your full source for League of Legends player data. Your AI client pulls everything you need: summoner profiles, current ranked stats (LP/Tier), deep match history details (KDA, items, gold), and even what players are running in live games. You don't talk about the stats; your agent uses these specific tools to pull structured info.
Identifying Players:
If you only have a player’s Riot ID—like "PlayerName#TAG"—you gotta start by using get_account_by_riot_id to translate that into their required PUUID, and it'll hand back basic account details too. If you already got the unique number (the PUUID), you can use get_summoner_by_puuid for general profile info, or if you have the raw summoner ID number, run get_summoner_by_id to get core data like level and icon ID.
Tracking Rank:
You want to know how good they are? Use get_league_entries. You specify which server and queue you're looking at, and it returns the player's current league standing, including their tier, LP score, and total wins versus losses for that competitive season.
Reviewing Matches:
To see what they've actually done, first run get_match_ids. This gives you a list of up to 20 recent match IDs based on the player’s PUUID. Then, take one of those IDs and feed it into get_match along with the regional routing; that pulls the entire match breakdown—KDA, specific items used, runes, gold earned, and damage dealt.
Assessing Skill Depth:
Want to know if they're actually good at a certain champion? Run get_champion_masteries. You feed it the player and the champ name, and you get back their mastery level, points, and tokens—it tells you exactly how far away they are from hitting the next rank. Need to check out all possible champions? Use get_champions to list every single champion in the game, supporting optional version or locale inputs.
What's Happening Now:
If they’re live, your agent can tell you with get_active_game, giving detailed info on team comps, banned champions, and active spells—or it tells you nothing if they aren't playing. You can also check out high-elo games happening right now by running get_featured_games; that returns details on current compositions and spells for top matches.
Champion Basics:
Whenever you need a static reference, use get_champion_details to fetch everything about any champion—their abilities, stats, and lore. This tool doesn't even require an API key.
This server lets your AI client do all the heavy lifting, turning simple queries into structured data for player identity via get_account_by_puuid, ranking status using get_league_entries, match history analysis with a two-step process of getting IDs via get_match_ids and then pulling details with get_match, checking live activity through get_active_game or get_featured_games, and nailing down champion skill levels using get_champion_masteries.
It’s clean, direct data every time.
How Riot Games MCP Works
- 1 First, your AI agent uses
get_account_by_riot_idto translate a human-readable Riot ID into the necessary PUUID. - 2 Next, it calls
get_match_idsusing that PUUID to get a list of recent match IDs, then iterates through them callingget_matchfor full details. - 3 Finally, you ask your agent to combine this data with
get_league_entriesandget_champion_masteriesto build the final performance report.
The bottom line is: it chains multiple API calls together behind a single conversational interface so you don't have to manually manage the sequence of requests.
Who Is Riot Games MCP For?
Coaches and professional analysts who spend hours clicking through match history dashboards are going to love this. It cuts out the data gathering phase entirely, letting them focus on strategy. Content creators need it too—no more copy-pasting stats from external sites.
Analyzing a player's performance across multiple queues by comparing their ranked stats via get_league_entries against specific champion weaknesses found in match history.
Pulling bulk data to track trends, such as how often certain champions are picked or the average damage output from a player's last 10 games using get_match and get_match_ids.
Quickly checking live game status (get_active_game) to get real-time content ideas or verifying a player's current rank for video scripting.
What Changes When You Connect
- See a player's full competitive standing immediately. Instead of visiting the ranking page, you call
get_league_entriesto get their current tier, LP, win/loss records, and hot streak status directly into your agent's context. - Track performance over time without manual effort. Use
get_match_idsfirst; then feed those IDs intoget_match. This gives you the full data packet (KDA, items, gold) for a whole batch of games in one flow. - Know where players are right now. The
get_active_gametool tells you if they're live and what their team composition is, saving you from guessing if they've logged off. - Understand why a player excels. You can check champion mastery using
get_champion_masteriesto see exactly how many points or tokens the player has accumulated on specific champions. - Get foundational account data fast. Start by running
get_account_by_riot_id. This immediately gives your agent the PUUID, which is the key required for most other stats calls.
Real-World Use Cases
Diagnosing a Ranked Drop
A coach notices a player's ranking dropped suddenly. They ask their agent to run get_match_ids and then use the resulting IDs with get_match. The agent pulls the full match data, allowing the coach to check for low KDA or poor item choices in the specific games that caused the drop.
Building a Player Dossier
A content creator needs stats on Faker. They first call get_account_by_riot_id to get the PUUID, then use get_summoner_by_puuid for basic profile details, and finally run get_league_entries to pull all current rank data into one structured payload.
Checking a Live Lobby
A teammate needs to know if a player is available. Instead of checking the client dashboard, they ask their agent to run get_active_game. If it returns data, the player is live and in-game; otherwise, the process stops.
Analyzing Champion Specialization
An analyst wants to know if a player favors one champion. They use get_champion_masteries for that player across several champions. The agent returns mastery levels and points, making it easy to identify the player's true specialty.
The Tradeoffs
Treating data as manual lookup
A developer tries to fetch a player's rank by manually calling get_summoner_by_id, then trying to find the league info from another endpoint, resulting in mismatched IDs and failed calls.
→
You must first run get_account_by_riot_id to get the PUUID. Use that PUUID as input for get_league_entries to guarantee you pull the correct, up-to-date ranking data.
Ignoring regional requirements
The developer forgets to specify the region when calling an endpoint like get_match, and the API returns a generic error or irrelevant match history.
→
Always confirm your desired platform code (e.g., NA1, EUW1) is specified in the prompt or tool call parameters for endpoints like get_league_entries.
Over-relying on one endpoint
Calling only get_match_ids and stopping there. You get a list of IDs, but no actual stats or KDA information.
→
The ID list is just the start. Remember that you must pass those retrieved match IDs to the get_match tool to pull the full, actionable details.
When It Fits, When It Doesn't
Use this server if your goal is structured data extraction from League of Legends performance metrics. Specifically, when you need a sequence: ID -> PUUID -> Match History -> Current Rank/Mastery. Don't use it if you only need to know basic champion lore or general game information; get_champion_details handles that static stuff fine. If your data needs are focused solely on match IDs without details, stick to get_match_ids. But for anything useful—stats, KDA, rank—you'll be chaining calls across get_account_by_riot_id, get_league_entries, and the match tools.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Riot Games API. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 12 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Getting a full player profile used to mean clicking through five different tabs.
Today, if you want to build a comprehensive profile for a champion or player, you have to start on the ranking page. Then you click 'Match History,' which takes you to a new view. You copy specific IDs, then open another tab to check their current rank. Finally, you might need to visit the masteries section just to see how good they are with one specific champ.
With this MCP server, your agent handles that entire sequence automatically. Give it a Riot ID and tell it what you want—a full profile, for instance. It coordinates calls across `get_account_by_riot_id`, `get_league_entries`, and the match tools, delivering all the structured data in one go.
Riot Games MCP Server: Pulling live game status with get_active_game
Before this tool, figuring out if a player was actually online involved checking multiple dashboards—was the client running? Did they join a scrim lobby? Was their account flagged as active? It was guesswork.
Now, you just ask your agent to run `get_active_game`. If it returns data, you know they're in a game. The payload includes team compositions and bans, giving you hard facts about their current activity level.
Common Questions About Riot Games MCP
How do I get a Riot Games API key? +
Register at 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.
If I run `get_active_game`, how do I know the summoner isn't playing right now? +
The tool returns a specific 404 error code when the summoner is not in an active game. This confirms they are offline or away from current action. You can then switch to checking their ranked status using get_league_entries.
When using `get_match_ids`, how do I get more than the default 20 matches? +
You must use the optional count parameter, setting it to a number between 1 and 100. To pull full match history, request batches of 100 IDs at a time for comprehensive coverage.
Does `get_champion_details` use live API data or static data? +
It uses Data Dragon, which is a set of static data. This means the champion information—like abilities and base stats—will not change based on real-time game updates. It's always consistent.
Before running `get_league_entries`, what is the most reliable way to find the required PUUID? +
Use the get_account_by_riot_id tool first. This function reliably retrieves the Player Universally Unique Identifier (PUUID) using just the player's visible Riot ID (game name + tag line). That PUUID is what you need for accurate stats.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Salesforce Service Cloud
Manage support cases, search the knowledge base, track case metrics, and resolve customer issues through natural conversation.
Kingdee / 金蝶
Comprehensive enterprise ERP platform — manage materials, customers, and business flows via AI.
Google Lighthouse SEO Auditor
Transform your AI into a Technical SEO & Performance Agency. Instantly run official Google PageSpeed Insights (Lighthouse) audits on any website and get exact code fixes to achieve a perfect 100/100 score.
You might also like
Email (.eml) File Parser
Transform heavy raw email exports into crystal-clear text local. Let your AI act as your personal secretary, instantly summarizing threads without wasting context window tokens.
BattleMetrics
Global game server tracking and player analytics — monitor servers, search players, and audit bans via AI.
FeedBlitz
Manage mailing lists, RSS feeds, and email marketing campaigns through AI.