Riot Games

liveGames

Riot Games API — League of Legends player accounts, match history, ranked entries, champion mastery, and rotations.

11tools
0msauth
free tier50 calls/day
🔑Authentication

BYO key only — get a development key at developer.riotgames.com. Pass _apiKey on the gateway URL.

Config with credentials
{
  "mcpServers": {
    "pipeworx-riot-games": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gateway.pipeworx.io/riot-games/mcp?_apiKey=your_riot_key"
      ]
    }
  }
}

Get an API key →

Tools

account_by_riot_id

Riot ID → account/puuid.

No parameters required.

▶Try it
account_by_puuid

Look up a Riot account (game_name, tag_line, puuid) by puuid via the regional Riot Account API (americas | europe | asia).

No parameters required.

▶Try it
summoner_by_puuid

Fetch LoL summoner details (summoner ID, account ID, summonerLevel, profileIconId, revisionDate) for a puuid on a specific platform (e.g. na1, euw1).

No parameters required.

▶Try it
match_ids_by_puuid

List recent LoL match IDs for a puuid on a regional cluster; filter by queue type, start/end timestamp, and paginate with start + count.

No parameters required.

▶Try it
match

Fetch full LoL match detail by match ID (e.g. NA1_123): participants, champions, stats, team outcomes, and game metadata.

No parameters required.

▶Try it
match_timeline

Fetch per-frame event timeline for a LoL match ID — kills, item purchases, level-ups, building destructions at each minute interval.

No parameters required.

▶Try it
league_entries

List all LoL ranked ladder entries for a queue (RANKED_SOLO_5x5), tier (DIAMOND), and division (I) on a platform; paginates with page parameter.

No parameters required.

▶Try it
champion_rotations

Free champion rotation.

No parameters required.

▶Try it
champion_mastery

Return full champion mastery list for a puuid on a platform: mastery level, points, chest granted, tokens earned for every champion.

No parameters required.

▶Try it
summoner_top_mastery

Highest champion mastery entries for one League of Legends account from the Riot Games API, given a puuid and a platform routing value such as na1, euw1, or kr, with count controlling how many champio

No parameters required.

▶Try it
status

Platform status.

No parameters required.

▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/riot-games/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/riot-games/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"account_by_riot_id","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("account_by_riot_id", {});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("riot games api — league of legends player accounts, match history, ranked entries, champion mastery, and rotations");