Provides read-only access to the local Riot Live Client Data API for an active League of Legends match, enabling retrieval of game status, active player details, abilities, all players, game stats, and events.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
A TypeScript SDK for the local Riot Live Client Data API, plus a Model Context Protocol (MCP) server that exposes the live game state as tools.
The API is served by the League of Legends client on https://127.0.0.1:2999 while a game is running. The SDK is a typed client for it; the MCP server lets an AI assistant query the game through six read-only tools.
Disclaimer: This project is not endorsed by Riot Games and does not reflect the views or opinions of Riot Games or anyone officially involved in producing or managing Riot Games properties. Riot Games and all associated properties are trademarks or registered trademarks of Riot Games, Inc.
Bun 1.x
A running League of Legends game on the same machine (the Live Client Data API is only available during a match)
Related MCP server: OP.GG MCP Server
git clone https://github.com/jayjayholic/league-of-legends-game-mcp.git
cd league-of-legends-game-mcp
bun installThe server speaks MCP over stdio. Point your MCP client at it, for example:
{
"mcpServers": {
"league-of-legends": {
"command": "bun",
"args": ["run", "/absolute/path/to/league-of-legends-game-mcp/src/mcp/server.ts"]
}
}
}Tool | Returns |
|
|
| Local player: summoner name, level, gold, champion stats |
| Passive and Q/W/E/R abilities with levels |
| All players: champion, team, position, scores, items |
| Game mode, map, terrain and game time |
| Game events so far (kills, objectives, start and end) |
Every tool returns its result as JSON text. Errors are returned as tool errors with a readable message.
import { LiveClient, GameNotRunningError } from "./src/sdk/index";
const client = new LiveClient({ timeoutMs: 2000 });
try {
const player = await client.getActivePlayer();
console.log(player.summonerName);
} catch (error) {
if (error instanceof GameNotRunningError) {
console.log("No game is running.");
} else {
throw error;
}
}Options: baseUrl (default https://127.0.0.1:2999, injectable for tests), timeoutMs (default 2000) and fetch (replacement fetch implementation).
Errors: GameNotRunningError (port closed or refused), RiotApiTimeoutError (no answer within the timeout), RiotApiError (non-2xx status or invalid JSON, with status).
The game uses a self-signed certificate. Certificate verification is disabled only when the request host is exactly 127.0.0.1. Requests to any other host keep normal verification.
bun run test # vitest suite (SDK and MCP tool call against a local fake server)
bun run typecheck # tsc --noEmit, strict mode
bun run start # run the MCP server on stdioTests use a plain-HTTP fake server on a random loopback port; no game is needed.
MIT. See LICENSE.
This server cannot be deployed
Live competitive-game predictions, meta data and decision tools for AI agents.
Teamfight Tactics data & AI coaching for Claude and ChatGPT — 19 tools, built-in Riot key.
Live sports stats and pre-computed analysis for AI assistants across NBA, MLB, NFL, and NHL.
Pay-per-call tools for AI assistants: code, data, finance, spreadsheets, media, web, time.
