kostadindev/league-mcp repository overview

⁠League of Legends MCP Server 🎮

A Model Context Protocol server that provides LLMs comprehensive access to League of Legends game data through the Riot Games API. This server enables LLMs to retrieve player statistics, match history, champion information, tournament data, and much more. ⚡

⁠Available Tools 🛠️

⁠Account API 👤

• get_account_by_puuid - Get account information by PUUID
• get_account_by_riot_id - Get account by Riot ID (gameName#tagLine)
• get_active_shard - Get the active shard for a player
• get_active_region - Get the active region for a player

⁠Summoner API 🧙‍♂️

• get_summoner_by_puuid - Get summoner information by PUUID
• get_summoner_by_account_id - Get summoner by account ID
• get_summoner_by_summoner_id - Get summoner by summoner ID
• get_summoner_by_rso_puuid - Get summoner by RSO PUUID

⁠Match API ⚔️

• get_match_history - Get match history IDs with filtering options
• get_match_details - Get detailed match information and player statistics
• get_match_timeline - Get match timeline with events and frame-by-frame data

⁠League API 🏆

• get_challenger_league - Get challenger tier league information
• get_grandmaster_league - Get grandmaster tier league information
• get_master_league - Get master tier league information
• get_league_entries_by_puuid - Get league entries for a player
• get_league_entries_by_summoner - Get league entries by summoner ID
• get_league_by_id - Get league information by ID
• get_league_entries - Get league entries by tier and division

⁠Champion API 🦸‍♀️

• get_champion_rotations - Get current free-to-play champion rotation

⁠Spectator API 👁️

• get_active_game - Get active game information for a summoner
• get_featured_games - Get list of featured games

⁠Clash API 🛡️

• get_clash_player - Get Clash tournament registrations for a player
• get_clash_team - Get Clash team information
• get_clash_tournaments - Get list of Clash tournaments
• get_clash_tournament_by_team - Get tournament information by team ID
• get_clash_tournament_by_id - Get tournament by ID

⁠Challenges API 🎯

• get_all_challenges - Get all challenge configuration data
• get_challenge_config - Get specific challenge configuration details
• get_challenge_leaderboards - Get challenge leaderboards (Master/Grandmaster/Challenger)
• get_player_challenges - Get player challenge progress and achievements
• get_challenge_percentiles - Get challenge percentile data

⁠Tournament API 🏅

• register_tournament_provider - Register as tournament provider (Production key required)
• create_tournament - Create tournaments for organized play
• create_tournament_code - Generate tournament codes for matches
• get_tournament_code - Get tournament code details and participants
• get_lobby_events - Monitor tournament lobby events

⁠Status API 📊

• get_platform_status - Get platform status and maintenance information

⁠Resources 📚

⁠Data Dragon Resources 🐉

• ddragon://versions - All available Data Dragon versions
• ddragon://languages - Supported localization languages
• ddragon://champions - All champions summary data
• ddragon://champion/{id} - Detailed champion information
• ddragon://items - Complete items database
• ddragon://summoner_spells - Summoner spells data

⁠Game Constants 🎲

• constants://queues - Queue types and IDs reference
• constants://routing - Platform/regional routing guide

⁠Installation 📦

⁠Using Docker 🐳

# Pull and run directly from Docker Hub
docker run -i -e RIOT_API_KEY=your_api_key_here kostadindev/league-mcp:latest

# For web integrations (SSE transport)
docker run -p 8000:8000 -e RIOT_API_KEY=your_api_key_here kostadindev/league-mcp:latest league-mcp --transport sse

⁠Configuration ⚙️

⁠Using Docker 🐳

{
  "mcpServers": {
    "league-mcp": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "RIOT_API_KEY=your_riot_api_key_here", "kostadindev/league-mcp:latest"],
      "env": {}
    }
  }
}

⁠Testing the Server 🧪

You can test the League MCP Server using:

⁠Option 1: Provided MCP Client

Use the included MCP client with a web UI for interactive testing

The MCP client is available at: https://github.com/kostadindev/League-of-Legends-MCP/tree/main/mcp-client⁠

⁠Option 2: Claude Desktop 🤖

Configure the server in Claude Desktop using the configuration examples above.

⁠Customization 🎨

⁠Transport Types 🚚

The server supports two transport types:

• stdio (default): Standard input/output transport for direct integration with MCP clients like Claude Desktop
• sse: Server-Sent Events transport for web-based integrations and HTTP connections

⁠API Coverage 📈

This server provides comprehensive coverage of the Riot Games API:

• 10 API endpoints with 35+ tools 🔧
• Static game data via Data Dragon resources 🐉
• Game constants for queues, routing, and more 🎲

⁠Disclaimer ⚠️

This project is not endorsed by Riot Games and does not reflect the views or opinions of Riot Games or anyone officially involved in producing or managing Riot Games properties. Riot Games and all associated properties are trademarks or registered trademarks of Riot Games, Inc.