Riot Games API Connector for AI agents.
12 live capabilities
Pull League of Legends player stats and match history instantly.
Waiting for input…
Why people use Riot Games API
Riot Games : Automating League of Legends Data Analysis
With this Connector, you just tell your agent to pull the last 20 matches. It fetches the IDs, grabs the stats, and gives you a clean summary in seconds.
What Vinkius changes
You get direct access to League of Legends data without ever leaving your chat interface.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
The Coach's Post-Game
A coach asks for the last 10 match IDs and wants a summary of the team's KDA.
- Real-world use case 02
The Content Creator's Hunt
A creator wants to find high-elo live games to see what the best players in the world are doing.
- Real-world use case 03
The Theorycrafter's Research
A player wants to know the mastery points and tokens for a champion they're trying to learn.
Complete set · 12capabilities
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 Capability
Get champion masteries
Retrieve a player's mastery levels, points, and tokens for every champion they've played. It helps show a player's experience.
- 02 Capability
Get featured games
Look up high-elo live games currently in progress across different regions. This helps find the best games to watch.
- 03 Capability
Get league entries
Pull ranked tier, LP, and win/loss records for a specific summoner. It gives a clear view of a player's competitive standing.
- 04 Capability
Get account by riot id
Find a player's PUUID and metadata by searching for their specific game name and tag line. Use this to start any player lookup.
05—08
4 capabilities in this set.
Part of 12 available through Riot Games API.
- 05 Capability
Get champion details
Fetch full champion stats, abilities, and lore from the static data library. This is perfect for theorycrafting and research.
- 06 Capability
Get champions
List every champion in the game along with their specific locale and version data. Use this to see the full roster.
- 07 Capability
Get account by puuid
Get account metadata, including the game name and tag line, using a unique player ID. This is useful for verifying account details.
- 08 Capability
Get active game
See the current live game for a summoner, including team info, bans, and runes. It provides a real-time look at ongoing matches.
09—12
4 capabilities in this set.
Part of 12 available through Riot Games API.
- 09 Capability
Get match
Get comprehensive data for a specific match using its unique match ID. This provides the deepest level of match analysis.
- 10 Capability
Get match ids
Pull a list of recent match IDs for a player to use for deeper history analysis. It's the first step to browsing a full history.
- 11 Capability
Get summoner by id
Retrieve a summoner's level and profile icon ID using their specific summoner ID. Use this for specific profile lookups.
- 12 Capability
Get summoner by puuid
Get a summoner's profile information based on their unique PUUID. This is the standard way to fetch profile data.
Set up in minutes
One URL. Then ask Riot Games API to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Riot Games API from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_bjqCHNP2y9fVj1zcYKQNqevKdvPC3SwlyUu5r2cU/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Riot Games API, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Riot Games API for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_bjqCHNP2y9fVj1zcYKQNqevKdvPC3SwlyUu5r2cU/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Riot Games API URL.
- Step 03
Save and start
Save the connection and enable Riot Games API in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"riot-games": {
"url": "https://edge.vinkius.com/vk_preview_bjqCHNP2y9fVj1zcYKQNqevKdvPC3SwlyUu5r2cU/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Riot Games API
Open Agent mode in chat and ask: "Using Riot Games API, help me...". 12 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"riot-games": {
"url": "https://edge.vinkius.com/vk_preview_bjqCHNP2y9fVj1zcYKQNqevKdvPC3SwlyUu5r2cU/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Riot Games API
Ask Copilot: "Using Riot Games API, help me...". 12 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"riot-games": {
"url": "https://edge.vinkius.com/vk_preview_bjqCHNP2y9fVj1zcYKQNqevKdvPC3SwlyUu5r2cU/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Riot Games API
Open Cascade and ask: "Using Riot Games API, help me...". 12 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"riot-games": {
"url": "https://edge.vinkius.com/vk_preview_bjqCHNP2y9fVj1zcYKQNqevKdvPC3SwlyUu5r2cU/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Riot Games API
Ask Cline: "Using Riot Games API, help me...". 12 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add riot-games --transport http "https://edge.vinkius.com/vk_preview_bjqCHNP2y9fVj1zcYKQNqevKdvPC3SwlyUu5r2cU/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Riot Games API
Ask Claude: "Using Riot Games API, show me...". 12 tools are ready
Where the request belongs
Work Riot Games API can move forward.
This is for the League of Legends community that lives in the data. It's for the coach who needs to justify a roster change with numbers, the content creator who wants to find hidden gems in high-elo games, and the player who wants to see exactly what they're missing in their own playstyle.
Esports Coach
Analyzes pro match history to build meta-strategies and identify player growth patterns.
Content Creator
Scours high-elo live games to find interesting highlights and new champion builds.
Competitive Player
Tracks personal ranked progress and champion mastery to optimize their own gameplay.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsApex Legends
Track Apex Legends player stats, match history, leaderboards, and server status directly from your AI agent.
OpenDota
Explore Dota 2 match data, player stats, heroes, teams and leagues. no API key required for basic access.
5E Arena
Automate competitive CS2 tracking via 5E Arena. fetch deep matchmaking stats, global leaderboards, and player performance scores natively from any AI agent.
Apex & Division Stats by TRN
Deep gaming analytics. player profiles, per-legend breakdowns, match history, and global leaderboards for Apex Legends and Division 2 via AI.
Faceit
Access competitive gaming data. search players, matches, hubs, tournaments and leaderboards for CS2, Valorant and more.
Clash Royale Tactical Intelligence
The definitive server for Clash Royale. track chest rotations, analyze battle decks, and monitor clan wars via AI.
Bring your own AI
Change the model, client or framework. Keep Riot Games API connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Riot Games API.
The practical details behind the request, access and result.
Can the Riot Games MCP find a player by their name?
Yes, you can find any player by searching for their game name and tag line. The Connector will then provide their unique ID and account details.
How can I use the Riot Games MCP to see live matches?
You can ask your agent to check if a specific player is currently in a game. It will return the game mode, team composition, and current bans.
Does the Riot Games MCP show champion mastery points?
Yes, it can pull mastery levels, points, and tokens for every champion a player has interacted with, making it easy to see their experience.
Can I get match history with the Riot Games MCP?
You can pull a list of recent match IDs and then request full details for any of those matches, including KDA, items, and gold totals.
Can I use the Riot Games MCP for esports coaching?
It is perfect for coaching. You can analyze player performance, check ranked distributions, and review match data to build better strategies.
What regions does the Riot Games MCP support?
The Connector supports several major regions including North America, Europe, Korea, Japan, and others. Just specify the region when asking for data.
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.
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.
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.
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.
One connection away
Give your agent a direct line to Riot Games API.
Connect Riot Games API once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available