Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@League of Legends MCP Server get match history for Dragontamer on EUW"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server exposing 35 tools for League of Legends player analysis, match review, and training-plan generation.
npm install -g @rexlmanu/lol-mcp-servernpx @rexlmanu/lol-mcp-servergit clone https://github.com/rexlManu/lol-mcp-server.git
cd lol-mcp-server
pnpm install
pnpm buildRelated MCP server: MCP Riot Server
cp .env.example .env
# Edit .env and add your RIOT_API_KEYGet your Riot API key at https://developer.riotgames.com/
Add to your MCP client config (Cursor, Claude Desktop, etc.):
{
"mcpServers": {
"league-of-legends": {
"command": "lol-mcp-server",
"env": {
"RIOT_API_KEY": "your-api-key-here"
}
}
}
}Or if installed from source:
{
"mcpServers": {
"league-of-legends": {
"command": "node",
"args": ["/path/to/lol-mcp-server/dist/index.js"],
"env": {
"RIOT_API_KEY": "your-api-key-here"
}
}
}
}Runtime: Node.js 20+, TypeScript
Package manager: pnpm
MCP SDK: @modelcontextprotocol/sdk
Validation: zod
Scraping: cheerio (Lolalytics, League Wiki)
Static data: Data Dragon API
Testing: vitest
pnpm dev # Run with tsx (hot reload)
pnpm build # Compile to dist/
pnpm start # Run compiled server
pnpm test # Run tests
pnpm typecheck # Type checking{
"mcpServers": {
"league-of-legends": {
"command": "node",
"args": ["dist/index.js"],
"env": {
"RIOT_API_KEY": "your-api-key-here"
}
}
}
}{
"mcpServers": {
"league-of-legends": {
"command": "node",
"args": ["dist/index.js"],
"env": {
"RIOT_API_KEY": "your-api-key-here"
}
}
}
}Tool | Description |
| Get Riot account info by Riot ID |
| Get summoner info (level, icon) by PUUID |
| Get ranked stats (tier, rank, LP, win rate) |
| Complete player profile in one call |
Tool | Description |
| Get recent match IDs (with filters) |
| Get detailed match data (batch supported) |
| Get minute-by-minute match timeline |
Tool | Description |
| Compact review stats for one player in one match |
| Chronological death timeline with killer, assists, position, and context |
| Compact vision review with wards, control wards, trinkets, and phase grouping |
| Multi-match compact review for recent games on one champion |
| Filtered timeline events by participant, event type, and time range |
Tool | Description |
| Get champion mastery data |
| Check if player is in game |
| Get free champion rotation |
| Get featured games |
Tool | Description |
| Get league info by ID |
| Get league entries by summoner |
| Get league entries (paginated, by queue/tier/division) |
| Get top players (challenger/grandmaster/master) |
| Get active Clash tournaments |
| Get Clash player info |
| Get Clash team info |
Tool | Description |
| Get all challenge configurations |
| Get player challenge progress |
| Get server status (maintenance/incidents) |
Tool | Description |
| List all champions (from Data Dragon) |
| Detailed champion info (Data Dragon + Wiki) |
| List all items with stats, cost, build path |
| Get rune trees with keystones and descriptions |
Tool | Description |
| Scrape Lolalytics for builds, runes, counters, meta |
Tool | Description |
| Analyze recent performance with recommendations |
| Analyze performance on a specific champion |
| Get personalized improvement tips |
| Compare stats between two players |
User-facing regions: euw, eune, na, kr, br, lan, las, oce, ru, tr, jp, ph2, sg2, th2, tw2, vn2
Platform routing: euw1, eun1, na1, kr, jp1, br1, la1, la2, oc1, tr1, ru
Regional routing: europe, americas, asia, sea
Data Type | TTL |
Live game / server status | 15-30s |
Account / summoner / ranked | 60s |
Champion mastery / match history | 2min |
Lolalytics pages | 5min |
Match details / timelines | 1h |
Static data (champions/items/runes) | 24h |
Error | Description |
| Player/match not found |
| Auto-retry with backoff |
| Private data or restricted access |
| Invalid Riot API key |
| Lolalytics page structure changed |
| Connection/API error |
| Unknown region code |
src/
index.ts # Entry point, MCP server setup
config.ts # Environment config
riot/
client.ts # Riot API HTTP client with rate limiting
regions.ts # Region routing maps
types.ts # Core Riot API types
types-extra.ts # Additional Riot API types
cache/
cache.ts # TTL-based in-memory cache
static-data/
dataDragon.ts # Data Dragon API client
wikiScraper.ts # League Wiki scraper (cheerio)
types.ts # Static data types
lolalytics/
scraper.ts # Lolalytics page fetcher
parser.ts # HTML parser (cheerio)
types.ts # Lolalytics types
tools/
account.ts # Account, summoner, ranked, profile, match tools
champion.ts # Mastery, live game, rotation, featured games
league.ts # League, clash, challenges, status
staticData.ts # Champions, items, runes
lolalytics.ts # Lolalytics builds
analysis.ts # Performance analysis, tips, comparison
analysis/
performance.ts # Performance analysis engine
championReview.ts # Champion-specific analysis
trainingPlan.ts # Improvement tips generator
compare.ts # Player comparison
tests/
regions.test.ts # Region mapping tests
cache.test.ts # Cache tests
lolalytics-parser.test.ts # Parser tests
analysis.test.ts # Analysis engine testsMIT
Analyze performance on a specific champion
Inputs: puuid (required), champion (required), region, platform, +1 more.
Analyze recent performance and give recommendations
Inputs: puuid (required), queue, region, champion, +2 more.
Compare stats between two players
Inputs: tagLineA (required), tagLineB (required), gameNameA (required), gameNameB (required), +3 more.
Get Riot account info by Riot ID (gameName#tagLine)
Inputs: tagLine (required), gameName (required), region.
List all current champions with ID, name, title, roles/tags
Inputs: patch.
List all items with stats, cost, build path
Inputs: group, patch.
Scrape Lolalytics for best builds, runes, counters, and meta data for a champion
Inputs: champion (required), lane, rank, patch, +1 more.
Get all challenge configurations
Inputs: platform.
Get detailed champion info (stats, abilities, cooldowns, ratios, passive, skill order)
Inputs: champion (required), patch.
Get champion mastery data (list or single champion)
Inputs: puuid (required), platform, championId.
Get compact multi-match review for recent games on one champion
Inputs: tagLine (required), gameName (required), championName (required), limit, +3 more.
Get current free champion rotation
Inputs: platform.
Get Clash info for a player
Inputs: puuid (required), platform.
Get Clash team info
Inputs: teamId (required), platform.
Get active/upcoming Clash tournaments
Inputs: platform.
Get featured games
Inputs: platform.
Get personalized improvement tips
Inputs: puuid (required), goal, role, region, +3 more.
Get league info by league ID
Inputs: leagueId (required), platform.
Get league entries by PUUID
Inputs: puuid (required), platform.
Get league entries by queue, tier, division (paginated)
Inputs: tier (required), queue (required), division (required), page, +1 more.
Get top players in a league (challenger/grandmaster/master)
Inputs: tier (required), queue (required), platform.
Check if a player is currently in game
Inputs: summonerId (required), platform.
Get detailed info for one or more matches
Inputs: matchIds (required), region.
Get recent match IDs
Inputs: puuid (required), count, queue, start, +6 more.
Get minute-by-minute match timeline
Inputs: matchId (required), region.
Get player challenge progress
Inputs: puuid (required), platform.
Get chronological death events for a player in a match with compact coaching context
Inputs: matchId (required), tagLine (required), gameName (required), region.
Get compact review stats for one player in one match without full match blob
Inputs: matchId (required), tagLine (required), gameName (required), region.
Get complete player profile in one call (account, summoner, ranked, mastery summary)
Inputs: tagLine (required), gameName (required), region, platform.
Get compact vision review data for a player in one match
Inputs: matchId (required), tagLine (required), gameName (required), region.
Get ranked stats (tier, rank, LP, wins, losses, winRate)
Inputs: puuid (required), platform.
Get rune trees with keystones, minor runes, descriptions
Inputs: group, patch.
Get server status (maintenance/incidents) for a region
Inputs: region.
Get summoner info (level, profile icon) by PUUID
Inputs: puuid (required), platform.
Get filtered timeline events by participant, event type, and time range
Inputs: matchId (required), limit, region, endTimeMs, +3 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 35 tools
Most tools target distinct data or actions, but some overlap exists: lol_get_league_entries and lol_get_league_entries_exp both handle league entries via different parameters, and lol_get_player_profile composites multiple endpoints, which could blur boundaries.
All tools follow a consistent lol_verb_noun pattern (e.g., lol_get_live_game, lol_analyze_performance), with verbs like get, analyze, compare, and nouns clearly describing the resource, making the naming predictable and easy to navigate.
35 tools is on the higher end, covering many specific endpoints (e.g., death events, vision summary) and composite functions. While each tool has a purpose, the count feels slightly bloated; could be streamlined by reducing redundancy.
The tool set covers a broad range of League of Legends data and analysis: account, matches, champions, items, runes, builds, and performance tips. Only minor gaps like advanced spectator features or tournament data beyond Clash are missing.
Market data tools for the MCP ecosystem: server stats, events, search, leaderboards, package trends.
Marketplace and infrastructure for MCP servers and skills: deploy, host, monetize, analytics.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
MCP server providing access to the Scorecard API to evaluate and optimize LLM systems.
