# Riot Games

> Riot Games is a freemium MCP server for sports data. MCP server exposing Riot Games API data for League of Legends players and analysts. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, Web, self-hosted
- **Website:** https://pipeworx.io/packs/riot-games
- **Repository:** https://github.com/pipeworx-io/mcp-riot-games
- **MCP Registry name:** io.github.pipeworx-io/riot-games
- **Categories:** [sports data](https://ai-powered.com/categories/sports-data)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/riot-games/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "riot-games": {
      "url": "https://gateway.pipeworx.io/riot-games/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [Opendota](https://ai-powered.com/mcp/opendota): Opendota is a freemium MCP server for games and play.
- [Last Fm](https://ai-powered.com/mcp/last-fm-2): Last Fm is a freemium MCP server for sports data.
- [LeagueApps MCP by usefulapi](https://ai-powered.com/mcp/leagueapps-mcp-by-usefulapi): LeagueApps MCP by usefulapi is a freemium MCP server for sports data.
- [Seatgeek](https://ai-powered.com/mcp/seatgeek): Seatgeek is a freemium MCP server for sports data.

---
Source: https://ai-powered.com/mcp/riot-games
