
Riot Games
MCP server exposing Riot Games API data for League of Legends players and analysts
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/riot-games/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"riot-games": {
"url": "https://gateway.pipeworx.io/riot-games/mcp"
}
}
}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.