League of Legends MCP Server
Click on "Install 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 Serverget 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.
League of Legends MCP Server
MCP server exposing 30 tools for League of Legends player analysis, match review, and training-plan generation.
Installation
Via npm (recommended)
npm install -g lol-mcp-serverVia npx (no install)
npx lol-mcp-serverFrom source
git clone https://github.com/rexlManu/lol-mcp-server.git
cd lol-mcp-server
pnpm install
pnpm buildRelated MCP server: MCP Riot Server
Setup
cp .env.example .env
# Edit .env and add your RIOT_API_KEYGet your Riot API key at https://developer.riotgames.com/
MCP Client Configuration
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"
}
}
}
}Stack
Runtime: Node.js 20+, TypeScript
Package manager: pnpm
MCP SDK:
@modelcontextprotocol/sdkValidation: 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 checkingMCP Client Configuration
Cursor / VS Code
{
"mcpServers": {
"league-of-legends": {
"command": "node",
"args": ["dist/index.js"],
"env": {
"RIOT_API_KEY": "your-api-key-here"
}
}
}
}opencode
{
"mcpServers": {
"league-of-legends": {
"command": "node",
"args": ["dist/index.js"],
"env": {
"RIOT_API_KEY": "your-api-key-here"
}
}
}
}Tools (30 total)
Account & Profile (4)
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 |
Match History (3)
Tool | Description |
| Get recent match IDs (with filters) |
| Get detailed match data (batch supported) |
| Get minute-by-minute match timeline |
Champion & Live (4)
Tool | Description |
| Get champion mastery data |
| Check if player is in game |
| Get free champion rotation |
| Get featured games |
League & Clash (7)
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 |
Challenges & Status (3)
Tool | Description |
| Get all challenge configurations |
| Get player challenge progress |
| Get server status (maintenance/incidents) |
Static Game Data (4)
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 |
Lolalytics (1)
Tool | Description |
| Scrape Lolalytics for builds, runes, counters, meta |
AI Analysis (4)
Tool | Description |
| Analyze recent performance with recommendations |
| Analyze performance on a specific champion |
| Get personalized improvement tips |
| Compare stats between two players |
Region Support
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
Caching
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 Handling
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 |
Project Structure
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 testsLicense
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/rexlManu/lol-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server