LoL Client MCP Server

@johnnyinlee

Basic information

About LoL Client MCP Server

League of Legends Game Client API MCP Server

LoL Client MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

LoL Client MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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

Frequently asked questions

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.

Comments

More Other MCP servers

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi