home / mcp / lol client mcp server

LoL Client MCP Server

League of Legends Game Client API MCP Server

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "johnnyinlee-lol-client-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\lol-client-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

You run a lightweight MCP server that taps into the League of Legends Live Client Data API to fetch real-time in-game data. The server exposes a set of practical tools you can call from an MCP client to retrieve game stats, active player data, events, and more, all while the LoL client is running.

How to use

Start by launching the MCP server in your environment. Once running, you can connect your MCP client (such as Claude or another integrating tool) to access endpoints that return game data like current stats, active player details, and event history. The server relies on the Live Client Data API provided by the LoL game client, so you should keep the LoL client open and a game in progress to obtain live data.

How to install

Prerequisites and setup are straightforward: ensure you have Python 3.8 or higher and the FastMCP tooling available via the UV wrapper.

Install the required Python packages using UV with the following command.

uv pip install httpx fastmcp

How to use with Claude and other MCP clients

There are two common integration paths you can follow to connect with Claude.

1) Claude Desktop Configuration — add this MCP server entry to your claude_desktop_config.json.

{
    "mcpServers": {
        "lol-client-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\lol-client-mcp",
                "run",
                "main.py"
            ]
        }
    }
}

2) Using with Web Application

To connect the MCP server to the Claude web application, follow these steps.

First, start the MCP server using Python.

python main.py

Configuration notes

The server is designed to work when the League of Legends client is running and a game is in progress. Ensure you comply with Riot Games API usage policies and only access data while a game is active.

Troubleshooting

- Connection issues: Make sure the League of Legends client is running and a game is in progress.

- Timeout issues: Confirm that a game has started; the API does not operate in the game lobby.

Notes and precautions

- The MCP server relies on real-time data from the LoL client and operates only while a game is actively in progress.

- Use in compliance with Riot Games API policies.

License

All rights belong to Riot Games.

Available tools

get_all_game_data

Fetches data from a subset of the Live Client Data API endpoints for testing and broad data access.

get_game_stats

Retrieves basic data about the current game session.

get_event_data

Returns a list of events that have occurred in the game.

get_active_player

Provides all data about the currently active player.

get_active_player_name

Returns the active player's name.

get_active_player_abilities

Fetches the abilities available to the active player.

get_active_player_runes

Retrieves the full list of runes for the active player.

get_player_list

Retrieves the list of heroes in the game and their stats.

get_player_scores

Gets the current scores for a specified player by riot_id.

get_player_summoner_spells

Retrieves the summoner spells for a specified player.

get_player_main_runes

Fetches the basic runes for a specified player.

get_player_items

Retrieves the list of items for a specified player.