Riot Games · Python SDK
Build with the
Riot Games API.¶
Typed clients for your applications. A live-game terminal for your next match. A local MCP server for your AI tools.
import asyncio
from riotskillissue import PlatformRoute, RiotClient
async def main():
async with RiotClient(
default_route=PlatformRoute.EUW1
) as riot:
player = await riot.lol.player_profile("Player#EUW")
print(player)
asyncio.run(main())
from riotskillissue import PlatformRoute, SyncRiotClient
with SyncRiotClient(
default_route=PlatformRoute.EUW1
) as riot:
player = riot.lol.player_profile("Player#EUW")
print(player)
Set RIOT_API_KEY in your environment, then run.
Get your first response
One package. Five games. League of Legends · Teamfight Tactics · VALORANT · Legends of Runeterra · Riftbound
Choose your starting point¶
-
Python SDK
Resolve players, fetch match history, and call individual endpoints with typed asynchronous or synchronous clients.
-
Live game TUI
See teams, champions, ranks, and bans in your terminal, with automatic refreshes and visible data-quality warnings.
-
MCP server
Connect a local AI client to Riot data and League analysis tools that return structured match and player evidence.
Find the right level of detail¶
Work with a player or a match¶
Use game workflows when you want a complete task, such as a profile or a short match history. Start from runnable examples and choose the route for your game.
Call a specific endpoint¶
Use riot.raw for individual Riot operations. The reference lists Python
accessors, HTTP methods, authentication, and supported route families.
About API coverage
The generated API follows a community-maintained OpenAPI feed, not an official Riot specification. Available endpoints depend on your key's game access and permissions. See coverage and authentication.
Upgrading an existing project? Read the migration guide or check the release notes.