MCP.so
Sign In

LoL Client MCP

@johnnyinlee

Repository

About LoL Client MCP

League of Legends Game Client API MCP Server

Basic information

Category

Other

License

Apache-2.0 license

Runtime

python

Transports

stdio

Publisher

johnnyinlee

Submitted by

johnnyinlee

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"
      ]
    }
  }
}

Tools

No tools detected

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

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.

Comments

More Other MCP servers

Inbox Zero AI MCP

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

🚀 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

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

Awesome-MCP-ZH

yzfly

MCP 资源精选， MCP指南，Claude MCP，MCP Servers, MCP Clients

7.4K