League of Legends MCP Server

Connect AI assistants to League of Legends data via Model Context Protocol. Let AI analyze your performance, identify weaknesses & suggest optimal strategies. Access player profiles, match history, ranked stats & champion mastery.

🎮 Features

• Player Profiles - Search players by Riot ID (gameName#tagLine) across all regions
• Ranked Stats - Get tier, rank, LP, win/loss ratio and league standings
• Match History - Retrieve recent matches with detailed statistics
• Champion Mastery - View mastery levels, points and top champions
• Performance Analysis - Let AI analyze your gameplay and suggest improvements
• Live Game - Check if a player is currently in a match
• Player Comparison - Compare stats between two players
• Data Dragon Integration - Champion, item, rune and spell names automatically resolved
• Intelligent Caching - Reduces API calls with smart TTL-based caching
• Multi-Region Support - EUW, NA, KR, BR, and all other LoL servers

🚀 Quick Start

No Riot API key needed — this Actor includes a built-in API key. Just connect and play!

1. Connect to Claude Desktop

1. Open Claude Desktop → Settings → Connectors
2. Click Add Custom Connector
3. Paste this URL:

https://mrbridge--lol-mcp-server.apify.actor/mcp?token=YOUR_APIFY_TOKEN

Replace YOUR_APIFY_TOKEN with your Apify API token.

2. Start asking questions

That's it! Claude can now access League of Legends data. Try asking:

"Look up the profile of Faker on KR and tell me his current rank"

📋 Real Example: 22-Page Performance Report

Here's what Claude generated for a Bronze III Rammus jungle main using this MCP server — a full coaching report based on 50 ranked games:

Player Snapshot

Metric	Value	Bronze Avg	Verdict
Win Rate	44.0%	~45%	Borderline
KDA	1.61	2.00	Needs work
Deaths/game	6.8	5.0	Critical
Assists/game	8.2	7.0	Above average
CS/min	5.4	5.5	Borderline
Vision/min	0.41	0.38	Good

What the report covers (22 pages)

1. Player profile & key statistics — Win rate, KDA, CS/min, vision score vs Bronze benchmarks
2. Champion pool analysis — Why Rammus at 44% WR is better than Udyr at 25% WR despite higher mastery
3. Rammus deep dive — Engage timing, gank patterns, taunt usage efficiency
4. Farm & CS economy — Variance analysis (87 CS vs 262 CS in same-length games)
5. Gank execution — 0% first blood rate identified as critical weakness
6. Teamfight & engage patterns — High assist count (8.2/game) shows good presence
7. Vision & map control — Above-average for Bronze, a rare strength to protect
8. KDA & death management — 6.8 deaths/game identified as #1 climbing blocker
9. Macro game & objectives — Dragon/Baron participation analysis
10. ELO benchmark comparison — Current stats vs Bronze/Silver/Gold targets
11. 90-day improvement plan — Phase 1: Survive, Phase 2: Farm, Phase 3: Climb to Silver
12. Builds, runes & resources — Optimal Rammus builds with situational variants

This entire report was generated by Claude Desktop using only the tools from this MCP server. No manual data entry — just ask Claude to analyze any player and it does the rest.

Try it yourself:

"Analyze my last 50 ranked games and create a detailed performance report with a plan to climb. My Riot ID is YourName#TAG on EUW."

🔧 Available Tools

Once connected, your AI assistant can use these tools:

Tool	Description
lol_get_account	Get account info by Riot ID (gameName#tagLine)
lol_get_summoner	Get summoner info (level, profile icon)
lol_get_ranked	Get ranked stats (tier, rank, LP, wins/losses)
lol_get_match_history	Get list of recent match IDs
lol_get_match_details	Get detailed info about a specific match
lol_get_match_timeline	Get minute-by-minute match timeline
lol_get_champion_mastery	Get champion mastery data
lol_get_player_profile	Get complete player profile in one call
lol_get_live_game	Check if a player is currently in game
lol_analyze_performance	Analyze recent performance with recommendations
lol_analyze_champion	Analyze performance on a specific champion
lol_get_improvement_tips	Get personalized improvement tips
lol_compare_players	Compare stats between two players

💬 What can AI do with your LoL data?

Post-game coaching

"I just lost 3 games in a row. Analyze what went wrong — am I repeating the same mistakes?"

Champion pool optimization

"Based on my last 50 games, which 3 champions should I focus on to climb fastest?"

Duo synergy analysis

"Compare me and my duo partner. What are our strengths together? What should we work on?"

Role swap readiness

"I'm a support main thinking of switching to mid. Analyze my stats — am I ready?"

Improvement tracking

"Compare my stats from this week vs last week. Am I getting better or stuck?"

Live scouting

"I'm in game right now. Look up my opponents and tell me what to watch out for."

🌍 Supported Regions

Region Code	Server
euw1	Europe West
eun1	Europe Nordic & East
na1	North America
kr	Korea
br1	Brazil
la1	Latin America North
la2	Latin America South
oc1	Oceania
tr1	Turkey
ru	Russia
jp1	Japan
ph2	Philippines
sg2	Singapore
th2	Thailand
tw2	Taiwan
vn2	Vietnam

🔑 Riot API Key

This Actor includes a built-in Riot API key — you don't need to get your own. All 25 tools work out of the box, no setup required.

⚙️ Input Configuration

Field	Type	Default	Description
defaultRegion	string	euw1	Your primary game server
defaultLanguage	string	en	Language for AI analysis (en or fr)
cacheEnabled	boolean	true	Intelligent caching for faster responses

📊 Output

The MCP server exposes League of Legends data through the Model Context Protocol, allowing any MCP-compatible AI assistant to:

• Query player information in real-time
• Analyze match statistics
• Provide personalized coaching advice
• Track progress over time

🔒 Privacy & Security

• A built-in Riot API key is provided — no need to share your own
• No player data is stored permanently
• All requests are made directly to Riot Games' official API
• This Actor complies with Riot Games API Terms of Service

🐛 Troubleshooting

"API Key Invalid" Error

• The built-in key should always work. If you provided your own key, check that it's valid
• If the issue persists, try removing your custom key and using the built-in one

"Player Not Found" Error

• Verify the Riot ID format: gameName#tagLine (e.g., Faker#KR1)
• Check you're using the correct region
• The player may have changed their name recently

Claude Desktop Not Connecting

• Ensure you're using the full URL with /mcp path: https://mrbridge--lol-mcp-server.apify.actor/mcp?token=YOUR_TOKEN
• Verify your Apify token is valid at console.apify.com
• Restart Claude Desktop after configuration changes
• The server may need a few seconds to start on first connection (cold start)

💰 How much does it cost?

This MCP server uses Apify's pay-per-event pricing. You only pay for the tools you actually use:

Event	Price	Description
Tool call	$0.01	Each MCP tool invocation

Free tier: Apify gives you $5 free credits every month. That's enough for approximately 500 tool calls — plenty for regular gameplay analysis.

Example costs:

• Quick player lookup (1 tool call): ~$0.01
• Full performance analysis (3-5 tool calls): ~$0.03-$0.05
• Detailed coaching session (10-15 tool calls): ~$0.10-$0.15

FAQ

Do I need a Riot API key?

No. This Actor includes a built-in API key. You can start using it immediately without any Riot developer account.

Does this work with ChatGPT?

Yes. Any MCP-compatible AI client can connect to this server. It works with Claude Desktop, ChatGPT, and other AI agents that support the Model Context Protocol.

Is my data stored?

No. The server processes requests in real-time and does not store any player data permanently. All data is fetched directly from Riot Games' official API.

Which regions are supported?

All League of Legends regions are supported: EUW, EUNE, NA, KR, BR, LAN, LAS, OCE, TR, RU, JP, PH, SG, TH, TW, VN.

Can I analyze other players?

Yes. You can look up any player's public data by providing their Riot ID (gameName#tagLine). No special permissions are needed for public data.

Related Actors

• Vivino Wine Scraper - Extract wine ratings and prices from Vivino
• Millesima Wine Scraper - Scrape wine data with critic ratings from Millesima.fr

📚 Resources

• GitHub Repository
• Riot Developer Portal
• Riot API Documentation
• Claude Desktop MCP Setup
• Apify MCP Documentation

📝 License

This Actor is provided as-is for educational and personal use. Usage must comply with Riot Games API Terms and Conditions.

---

Built with ❤️ for the League of Legends community