jifrozen0110/mcp-riot

**MCP-Riot is a community-developed Model Context Protocol (MCP) server that integrates with the Riot Games API** to provide League of Legends data to AI assistants via natural language queries.
This project enables AI models to retrieve player information, ranked stats, champion mastery, and recent match summaries.
> **Disclaimer:** This is an open-source project *not affiliated with or endorsed by Riot Games.* League of Legends® is a registered trademark of Riot Games, Inc.
---
Demo
✨ Features
🧾 Player Summary
> "What's the current rank and top champions of Hide on bush?"
Provides the player's:
- Level
- Ranked Solo Tier
- Top champion masteries
- Recent match history
🔝 Top Champions
> "What champions is he best at?"
Returns the top N champions based on mastery points.
🎯 Champion Mastery
> "How good is this player with Ahri?"
Returns detailed champion mastery data for a specific champion.
🕹️ Recent Matches
> "Show the last 3 matches for this summoner"
Lists recent matches including champion used, K/D/A, and result.
📊 Match Summary
> "Summarize this match for a given match ID"
Returns the player’s match stats, such as KDA, damage, wards, and result.
---
🚀 Quick Start
1. Clone & Install
2. Get Your API Key and Set Environment
Create .env file with your Riot API key:
You can get your key from https://developer.riotgames.com/
3. Configure MCP Client
Register this server in your MCP client (e.g., Claude for Desktop).
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
> Replace /ABSOLUTE/PATH/TO/PARENT/FOLDER/ with the actual path to your project folder.
my case:
---
🛠️ Tools
The following tools will be exposed to MCP clients:
get_player_summary
Summarizes level, rank, top champions, and recent matches.
get_top_champions_tool
Returns top champions by mastery points.
get_champion_mastery_tool
Returns mastery details for a specific champion.
get_recent_matches_tool
Returns recent matches for the given summoner.
get_match_summary
Returns match performance stats for a given match ID and puuid.