Riot Games

Riot Games

MCP server for League of Legends – fetch player info, ranks, champion stats, and match history via Riot API.

19
Stars
7
Forks
1
Releases

Overview

MCP Riot Server is a community-developed MCP server that integrates with the Riot Games API to provide League of Legends data to AI assistants via natural language queries. It enables models to retrieve player information, ranked stats, champion mastery, and recent match summaries. The project exposes a set of MCP tools to fetch a player's Level and Solo Queue rank, identify top champions by mastery points, retrieve detailed champion mastery for a given champion, list recent matches with champion, K/D/A, and results, and generate match summaries including metrics such as KDA, damage, wards, and outcome. The README documents quick-start steps: clone the repository, install dependencies (uv or pip), set the Riot API key in a .env file, and register this server in an MCP client (like Claude) by configuring an appropriate command and environment file path. It also lists the exposed tools: get_player_summary, get_top_champions_tool, get_champion_mastery_tool, get_recent_matches_tool, and get_match_summary, and points to Model Context Protocol Python SDK, Riot API docs, and Data Dragon as references. MIT License.

Details

Owner
jifrozen0110
Language
Python
License
MIT License
Updated
2025-12-07

Features

Player Summary

Provides the player's Level, Ranked Solo Tier, Top champion masteries, and Recent match history.

Top Champions

Returns the top N champions based on mastery points.

Champion Mastery

Returns detailed champion mastery data for a specific champion.

Recent Matches

Lists recent matches including champion used, K/D/A, and result.

Match Summary

Returns the player’s match stats, such as KDA, damage, wards, and result.

Audience

AI developersIntegrate Riot LoL data into MCP-enabled assistants via natural language queries.
MCP client users (e.g., Claude desktop users)Register and run the server to enable LoL data retrieval in chat assistants.

Tags

League of LegendsRiot Games APIMCPModel Context ProtocolChampion MasteryPlayer SummaryRecent MatchesMatch Summary