Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • Agent Twitter Client MCP
  • Amazon VPC Lattice MCP Server
  • Joern MCP Server
  • Fantasy Premier League MCP Server
  • MCPWolframAlpha
Back to MCP Servers
lol-client-mcp Public

lol-client-mcp Public

Public
johnnyinlee/lol-client-mcp

Access real-time League of Legends client data through a Model Context Protocol server offering comprehensive endpoints for in-game stats, player info, events, and abilities via the Live Client Data API.

python
0 tools
May 30, 2025
Updated Jun 4, 2025

Supercharge Your AI with lol-client-mcp Public

MCP Server

Unlock the full potential of lol-client-mcp Public through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available • No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

LoL Client MCP

An MCP (Model-Controller-Processor) server for accessing League of Legends client data. This server provides a collection of tools that communicate with the League of Legends Live Client Data API to retrieve in-game data.

Overview

This project accesses real-time game data using the League of Legends game client's Live Client Data API. It utilizes the FastMCP framework to expose various endpoints as tools.

API information can be found at https://developer.riotgames.com/docs/lol.

Installation and Usage

Prerequisites

  • Python 3.8 or higher
  • uv - Fast and reliable Python package manager
    • Installation: pip install uv
  • League of Legends client installed

Project Setup

  1. Clone this repository:
git clone https://github.com/yourusername/lol-client-mcp.git cd lol-client-mcp
  1. Install required packages using uv:
uv pip install httpx fastmcp

Running the MCP Server

To run directly:

python main.py

Integration with Claude

There are two ways to use this with Claude:

1. Claude Desktop Configuration

Add the following to your claude_desktop_config.json file:

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

Important: Replace C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\lol-client-mcp with the actual path to your project.

2. Using with Web Application

To connect the MCP server to the Claude web application:

  1. Run the MCP server:

    python main.py
  2. Configure the server connection in the Claude web interface:

    • Go to MCP settings at the bottom when starting a conversation
    • Select 'lol-client-mcp' and connect

API Tools List

Game Data

  • get_all_game_data(): The Live League of Legends Client Data API has a number of endpoints that return a subset of the data returned by the /allgamedata endpoint. This endpoint is great for testing the Live Client Data API, but unless you actually need all the data from this endpoint, use one of the endpoints listed below that return a subset of the response.
  • get_game_stats(): Basic data about the game.
  • get_event_data(): Get a list of events that have occurred in the game.

Active Player Data

  • get_active_player(): Get all data about the active player.
  • get_active_player_name(): Returns the player name.
  • get_active_player_abilities(): Get Abilities for the active player.
  • get_active_player_runes(): Retrieve the full list of runes for the active player.

Player List and Individual Player Data

  • get_player_list(): Retrieve the list of heroes in the game and their stats.
  • get_player_scores(riot_id): Retrieve the list of the current scores for the player.
  • get_player_summoner_spells(riot_id): Retrieve the list of the summoner spells for the player.
  • get_player_main_runes(riot_id): Retrieve the basic runes of any player.
  • get_player_items(riot_id): Retrieve the list of items for the player.

Troubleshooting

  • Connection Error: Check if the League of Legends client is running.
  • Timeout Error: Verify that the game has actually started. This API does not work in the game lobby.

Precautions

  • This API only works when the League of Legends client is running and a game is in progress.
  • Use in compliance with Riot Games API policies.

License

All rights belong to Riot Games.

Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • Agent Twitter Client MCP
    Agent Twitter Client MCP

    Model Context Protocol server enabling AI models to interact with Twitter through cookie, username/p...

    Added May 30, 2025
  • Amazon VPC Lattice MCP Server
    Amazon VPC Lattice MCP Server

    Model Context Protocol server offering tools to access, manage, and automate AWS VPC Lattice resourc...

    2 tools
    Added May 30, 2025
  • Joern MCP Server
    Joern MCP Server

    A Python-based Model Context Protocol server integrating with Joern to facilitate advanced code revi...

    Added May 30, 2025
  • Fantasy Premier League MCP Server
    Fantasy Premier League MCP Server

    Provides comprehensive access to Fantasy Premier League data and tools via Model Context Protocol, e...

    Added May 30, 2025
  • MCPWolframAlpha
    MCPWolframAlpha

    Seamlessly integrate Wolfram Alpha's computational knowledge into chat applications via a Model Cont...

    Added May 30, 2025