Use Riot Games API with your AI.
Connect your account once and let the AI you already use work with it, without building another integration. Access League of Legends player data. summoner profiles, match history, ranked stats, champion masteries and live games.
Developed, maintained, and hosted by Vinkius.
MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED
Waiting for input…
Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.
Complete set · 12 capabilities
The complete Riot Games API capability set.
These are the exact actions your AI can choose when you ask it to work with Riot Games API.
01-04
4 capabilities in this set.
Part of 12 available through Riot Games API.
- 01
Get featured games
Returns game mode, banned champions, all players with their champions, summoner spells and game length. Platform codes: br1, na1, euw1, eun1, kr, jp1, oc1, la1, la2, tr1, ru. Get currently featured games (high elo live games)
- 02
Get champion details
Uses Data Dragon (static data, no API key needed). Get detailed info for a specific champion
- 03
Get account by riot ID
Returns the PUUID (Player Universally Unique Identifier), game name, tag line and account metadata. The PUUID is required for most other API calls. Get player account by Riot ID (game name + tag line)
- 04
Get champion masteries
Returns champion ID, mastery level (1-7), mastery points, last play time, chest earned status and tokens needed for next level. Platform codes: br1, na1, euw1, eun1, kr, jp1, oc1, la1, la2, tr1, ru. Get champion mastery data for a player
05-08
4 capabilities in this set.
Part of 12 available through Riot Games API.
- 05
Get champions
Uses Data Dragon (static data, no API key needed). Optional version (e.g. "14.1.1") and locale (e.g. "en_US", "pt_BR"). Get all League of Legends champions
- 06
Get league entries
Returns tier (IRON, BRONZE, SILVER, GOLD, PLATINUM, EMERALD, DIAMOND, MASTER, GRANDMASTER, CHALLENGER), rank (I-IV), LP, wins, losses and hot/streak info. Platform codes: br1, na1, euw1, eun1, kr, jp1, oc1, la1, la2, tr1, ru. Get ranked league entries for a summoner
- 07
Get account by puuid
Returns game name, tag line and account metadata. Get player account details by PUUID
- 08
Get active game
Returns game mode, game type, banned champions, all players with their champions, summoner spells, runes and team info. Returns 404 if the summoner is not in a game. Platform codes: br1, na1, euw1, eun1, kr, jp1, oc1, la1, la2, tr1, ru. Get current live game for a summoner
09-12
4 capabilities in this set.
Part of 12 available through Riot Games API.
- 09
Get match
Requires the regional routing where the match was played (americas, europe, asia, sea). Get detailed match data by match ID
- 10
Get match ids
Returns up to 20 match IDs by default. Use count (1-100) to get more matches and start for pagination. Regional routing: americas (NA, BR, LAN, LAS), europe (EUW, EUNE, TR, RU), asia (KR, JP), sea (PH, SG, TH, TW, VN, OCE). Get match history (match IDs) for a player
- 11
Get summoner by ID
Returns summoner level, profile icon ID, revision date and account ID. Platform codes: br1, na1, euw1, eun1, kr, jp1, oc1, la1, la2, tr1, ru. Get League of Legends summoner profile by summoner ID
- 12
Get summoner by puuid
The summoner ID is needed for league and spectator queries. Platform codes: br1, na1, euw1, eun1, kr, jp1, oc1, la1, la2, tr1, ru. Get League of Legends summoner profile by PUUID
Observed, not estimated
901ms average. Fast in production.
Riot Games API is checked daily against the live service.
- Fastest day
- 771ms
- Slowest day
- 1055ms
- 14-day trend
- Slowing+12%
Connect your client
One URL. Every client.
Activate the Connector, copy your link, and paste it into the client you already use. 12 capabilities arrive ready to run.
Preview access · not provider authentication
The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Riot Games API, so you can see the experience inside your AI.
It does not authenticate your account with Riot Games API. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.
Riot Games API Connector
You're all set. Choose your MCP client and follow the setup instructions.
https://edge.vinkius.com/vk_preview_bjqCHNP2y9fVj1zcYKQNqevKdvPC3SwlyUu5r2cU/mcpClaude Desktop
Follow the steps below to connect in seconds.
- 1In Claude Desktop, open Settings → Connectors.
- 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
- 3Click Add and start a new chat — Riot Games API capabilities are ready to use.
{
"mcpServers": {
"riot-games-mcp": {
"url": "https://edge.vinkius.com/vk_preview_bjqCHNP2y9fVj1zcYKQNqevKdvPC3SwlyUu5r2cU/mcp"
}
}
}
Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline
Step-by-step instructions for each client are in the guide. How to connect
FAQ
Questions Riot Games API owners ask.
- 01
How do I get a Riot Games API key?
Register at developer.riotgames.com and sign in with your Riot account to get your personal development API key. It's free and works immediately.
- 02
What is a PUUID?
PUUID (Player Universally Unique Identifier) is a unique ID assigned to every Riot account. It's required for most API calls like match history and champion masteries. Get it using get_account_by_riot_id with the player's game name and tag line.
- 03
What are platform codes?
Platform codes identify specific game servers: na1 (North America), euw1 (Europe West), eun1 (Europe Nordic & East), kr (Korea), br1 (Brazil), jp1 (Japan), la1/la2 (Latin America), tr1 (Turkey), oc1 (Oceania). Match history uses regional routing instead: americas, europe, asia, sea.
- 04
What are the API rate limits?
Development API keys are limited to 20 requests per second and 100 requests per 2 minutes. If you exceed these limits, the API returns a 429 error. Wait a moment and retry.
Explore
More in Industry Titans
Faceit AI Connector
Access competitive gaming data — search players, matches, hubs, tournaments and leaderboards for CS2, Valorant
ViewFortnite Cosmetics & Item Shop AI Connector
The definitive server for Fortnite cosmetics — track daily shop rotations, leaked skins, and rarity via AI.
ViewLeal AI Connector
Retain customers in Latin America with digital loyalty programs, cashback rewards, and personalized offers for
ViewAzure DevOps AI Connector
Manage work items, track builds, and coordinate releases across your Azure DevOps organization with full pipel
View
Suggestions
Gameball AI Connector
Turn customers into loyal fans with gamified rewards, referral programs, and engagement challenges that drive
ViewJoin AI Connector
Manage recruiting, jobs, and candidates via JOIN API.
ViewZetachain Explorer (ZetaChain Block Explorer API) AI Connector
Explore ZetaChain blockchain data — inspect blocks, transactions, addresses, and tokens directly through any A
ViewMicrosoft App Store AI Connector
Manage your Microsoft Store apps — track submissions, add-ons, and package flights via the Submission API.
View
