MCP Riot Server

League of Legends MCP Server

python

21

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jifrozen0110-mcp-riot": {
      "command": "/Users/jifrozen/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/jifrozen/mcp-riot/src/",
        "run",
        "--env-file",
        "/Users/jifrozen/mcp-riot/.env",
        "server.py"
      ],
      "env": {
        "RIOT_API_KEY": "YOUR_RIOT_API_KEY"
      }
    }
  }
}

MCP Riot Server connects the Riot Games API to your AI assistant so you can query League of Legends data through natural language. You can retrieve player summaries, top champions, champion mastery details, recent matches, and match summaries, empowering your AI to answer complex questions about players and games.

How to use

You run the MCP Riot Server locally and connect it to your MCP client. From your client, you invoke the exposed tools to fetch LoL data and feed it into your AI conversations. Use the Riot data to answer questions like a summoner’s current rank, top champions by mastery, or details about a specific match.

Available tools (exposed to MCP clients) include: Get a player summary, Get top champions, Get champion mastery, Get recent matches, and Get match summary. Use these tools by calling them through your MCP client to obtain structured data that you can present to users in natural language.

How to install

# 1) Clone the MCP Riot project
git clone https://github.com/jifrozen0110/mcp-riot.git
cd mcp-riot

# 2) Install dependencies (choose your preferred runtime)
uv sync
# or, if you prefer Python tooling:
pip install -r requirements.txt

Configuration and run notes

#  RIOT API key must be provided via environment file
RIOT_API_KEY=your_riot_api_key

You configure your MCP client to run the server by specifying the stdio command and arguments shown in the examples below. This ensures your client can start the server and load the correct environment for Riot data access.

## Security and keys

Keep your Riot API key secure. Do not commit the key in public repositories or share it. Use an environment file and restrict access to the file path configured in your MCP client.

## Notes

Two example runtime configurations are provided to illustrate how to run the server from your MCP client. Use the one that matches your file layout and environment setup.

If you have multiple local setups, you can define additional MCP server entries in your client configuration as long as you point each to its corresponding environment file and script.

## Available tools

### get\_player\_summary

Summarizes a player's level, rank, top champions, and recent matches for quick assessment.

### get\_top\_champions\_tool

Returns the top champions based on mastery points for a given summoner.

### get\_champion\_mastery\_tool

Provides detailed mastery data for a specific champion for a summoner.

### get\_recent\_matches\_tool

Lists recent matches for the specified summoner, including champion, K/D/A, and result.

### get\_match\_summary

Returns detailed performance stats for a given match ID and puuid, including KDA, damage, wards, and result.