MCP Riot Server

by jifrozen0110

27 stars
161 downloads
Not rated
GitHub

About

Integrates with the Riot Games API to provide League of Legends data to AI assistants.

Details

Author
jifrozen0110
GitHub stars
27
Downloads
161
Categories
Cloud Service, Infrastructure, Other

- Player summary: level, rank, top champions, recent matches
- Top champions by mastery points
- Champion mastery data for a specific champion
- Recent matches with champion, K/D/A, result
- Match summary with KDA, damage, wards, result

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP Riot Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Clone the repository, install dependencies with uv sync, obtain a Riot API key from developer.riotgames.com, and create a .env file with RIOT_API_KEY. Configure your MCP client (e.g., Claude for Desktop) to point to the server script with the absolute path and the .env file.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp riot server": {
            "mcp-riot": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-riot": {
        "command": "uv",
        "args": [
            "sync"
        ]
    }
}

MCP Riot Server

MCP-Riot is a community-developed Model Context Protocol (MCP) server that integrates with the Riot Games API to provide League of Legends data to AI assistants via natural language queries.

This project enables AI models to retrieve player information, ranked stats, champion mastery, and recent match summaries.

> Disclaimer: This is an open-source project not affiliated with or endorsed by Riot Games. League of Legends® is a registered trademark of Riot Games, Inc.

---

Demo


mcp-riot-lol

✨ Features

🧾 Player Summary

> "What's the current rank and top champions of Hide on bush?"

Provides the player's:
- Level
- Ranked Solo Tier
- Top champion masteries
- Recent match history

🔝 Top Champions

> "What champions is he best at?"

Returns the top N champions based on mastery points.

🎯 Champion Mastery

> "How good is this player with Ahri?"

Returns detailed champion mastery data for a specific champion.

🕹️ Recent Matches

> "Show the last 3 matches for this summoner"

Lists recent matches including champion used, K/D/A, and result.

📊 Match Summary

> "Summarize this match for a given match ID"

Returns the player’s match stats, such as KDA, damage, wards, and result.

---

🚀 Quick Start

1. Clone & Install

```bash
git clone https://github.com/jifrozen0110/mcp-riot.git
cd mcp-riot

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.