Skip to content
MCP server

Riot Games

MCP server exposing Riot Games API data for League of Legends players and analysts

Install
Pricing
Freemium
Platforms
API, CLI, Web
Runs
Locally or Remotely
Version
0.2.1
Listing updated
today

Similar MCP servers

About Riot Games

Riot Games is a freemium MCP server for sports data. It can run locally on your machine or as a hosted remote server.

The README describes this as a gateway pack that wraps the Riot Games public API for League of Legends, with TFT, Valorant and Legends of Runeterra also named in its scope. Tools cover Riot ID and PUUID account lookups, summoner details, recent match IDs, full match records and per-frame timelines, ranked ladder entries, free champion rotations, champion mastery, and platform status.

A Riot developer key is required for direct use: the website says the pack is bring-your-own-key only and passes it as a query parameter on the gateway URL. Without a key, anonymous calls to the gateway are capped per day, and a free Pipeworx account raises that cap. The npm package runs as a local stdio bridge that forwards calls to the hosted endpoint.

The README states this is an unofficial integration not affiliated with or endorsed by Riot Games. Connecting to a pack endpoint also lists the gateway's shared meta-tools alongside the pack's own tools.

Install

Run in a terminal

claude mcp add --transport http riot-games https://gateway.pipeworx.io/riot-games/mcp

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/riot-games/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "riot-games": {
      "url": "https://gateway.pipeworx.io/riot-games/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "riot-games": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/riot-games/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "riot-games": {
      "serverUrl": "https://gateway.pipeworx.io/riot-games/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "riot-games": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/riot-games/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.

Tools this server provides (12)

Taken from the project documentation; the running server may differ.

account_by_riot_id
Resolve a Riot ID to a puuid and account details.
account_by_puuid
Look up a Riot account by puuid.
summoner_by_puuid
Fetch LoL summoner details for a puuid on a platform.
summoner_by_name
Deprecated; use the Riot ID flow instead.
match_ids_by_puuid
List recent match IDs for a puuid with filters.
match
Fetch full match detail by match ID.
match_timeline
Fetch per-frame event timeline for a match ID.
league_entries
List ranked ladder entries for a queue, tier and division.
champion_rotations
Return the free champion rotation.
champion_mastery
Return the full champion mastery list for a puuid.
summoner_top_mastery
Return the top N champion mastery entries for a puuid.
status
Return platform status.

What it does

Riot ID account lookup
Resolves a Riot ID to a PUUID and fetches account details by PUUID across regional clusters.
Match history and detail
Lists recent match IDs with queue and time filters and returns full match records and timelines.
Ranked ladder entries
Lists ranked solo queue entries by tier and division on a chosen platform, with pagination.
Champion mastery data
Returns full or top-N champion mastery lists for a player on a platform.
Rotations and platform status
Provides the free champion rotation and platform status for a given region.

Good for

  • Pull a player's recent ranked matches into an AI assistant for review
  • Build a tracker showing champion mastery and ranked standing
  • Analyse match timelines for kills, item purchases and level-ups
  • Check whether a League of Legends platform is up before running a query

Pricing

Freemium, from $49 a month

Anonymous calls capped daily; free account raises the cap; paid usage via credits or subscription.

Prices change. Check pipeworx.io before you buy.

Riot Games FAQ

Do I need an API key to use it?

The website describes the pack as bring-your-own-key only and asks for a developer key from Riot. The npm README says calls without a Pipeworx key are anonymous and capped daily, with a free key raising the cap.

Which games does it cover?

The README lists League of Legends, TFT, Valorant and Legends of Runeterra as public data sources, but the tool list is focused on League of Legends.

Is it an official Riot product?

No. The README states it is an independent, unofficial integration and is not affiliated with, endorsed by or published by Riot Games.

Is Riot Games free?

Riot Games has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

How do I add Riot Games to Claude Code?

Run this command in your terminal: claude mcp add --transport http riot-games https://gateway.pipeworx.io/riot-games/mcp

What are the best alternatives to Riot Games?

The closest alternatives to Riot Games are Opendota, Last Fm, LeagueApps MCP by usefulapi and Seatgeek.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers