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 35 tools for League of Legends player analysis, match review, and training-plan generation.
Installation
Via npm (recommended)
npm install -g @rexlmanu/lol-mcp-serverVia npx (no install)
npx @rexlmanu/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 (35 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 |
Match Review (5)
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 |
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
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseCqualityDmaintenanceAn MCP (Model-Controller-Processor) server for accessing League of Legends client data. This server provides a collection of tools that communicate with the League of Legends Live Client Data API to retrieve in-game data.Last updated1212Apache 2.0
- AlicenseBqualityCmaintenanceA community-developed Model Context Protocol server that integrates with the Riot Games API to provide League of Legends data, enabling AI assistants to retrieve player information, ranked stats, champion mastery, and match summaries through natural language queries.Last updated527MIT
- Flicense-qualityDmaintenanceAn MCP Server that provides access to League of Legends statistics via the SportData.io API, allowing agents to query and analyze LoL competitive gaming data.Last updated
- Flicense-qualityCmaintenanceMCP server for natural language analysis of baseball league data, enabling team statistics, standings, lineup suggestions, and scouting reports via Claude Desktop.Last updated
Related MCP Connectors
MCP server providing access to the Scorecard API to evaluate and optimize LLM systems.
An MCP server for deep research or task groups
Educational MCP server with 17 math/stats tools, visualizations, and persistent workspace
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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