LoL Client MCP

What is LoL Client MCP?

LoL Client MCP is a Model Context Protocol server that provides tools to access League of Legends client data through the Live Client Data API. It is intended for developers who need real-time in-game information during a live match.

How to use LoL Client MCP?

Install Python 3.8+, uv, and clone the repository. Install dependencies (httpx, fastmcp) with uv pip install, then run python main.py. For Claude Desktop, add a configuration entry in claude_desktop_config.json with the absolute path to the project. For the Claude web app, start the server and connect via MCP settings.

Key features of LoL Client MCP

• Retrieve all game data or specific subsets (stats, events)
• Access active player details: name, abilities, runes
• Query player list and individual stats
• Get player scores, summoner spells, runes, and items
• Built on FastMCP framework for easy integration

Use cases of LoL Client MCP

• Monitoring real-time game state during a League of Legends match
• Building companion tools that react to in-game events
• Analyzing active player abilities, runes, and item builds
• Fetching player scores and summoner spells for coaching or analysis
• Testing the Live Client Data API with the comprehensive /allgamedata endpoint

FAQ from LoL Client MCP

Why do I get a connection error?

Check if the League of Legends client is running. The server requires an active client connection.

Why do I get a timeout error?

Verify that the game has actually started. The Live Client Data API does not work in the game lobby.

What are the requirements for LoL Client MCP?

Python 3.8 or higher, the uv package manager, and the League of Legends client must be installed.

When does the API work?

Only when the League of Legends client is running and a game is in progress. It does not function in the lobby or client menus.

Are there compliance requirements?

Use LoL Client MCP in compliance with Riot Games API policies.