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.

No Riot API key needed, no setup, no coding. Just connect your AI assistant and start analyzing.

What can LoL MCP Server do?

• 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 — Connect in 2 minutes

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

What tools are available?

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 top champion masteries with progression
lol_get_mastery_by_champion	Get detailed mastery for a specific champion
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."

What does the output look like?

Here's a sample response from the lol_get_player_profile tool:

Player Profile: Faker#KR1

Region: KR
Level: 782

Ranked Solo/Duo:
  Tier: Challenger | LP: 1,547
  Wins: 312 | Losses: 248 | Win Rate: 55.7%

Top Champions (by Mastery):
  1. Azir — Mastery 7 (1,247,892 pts) | 62% WR (89 games)
  2. Ryze — Mastery 7 (987,432 pts) | 58% WR (72 games)
  3. LeBlanc — Mastery 7 (876,123 pts) | 61% WR (65 games)

Recent Form (last 10 games):
  7W 3L | Avg KDA: 4.2 | Avg CS/min: 9.1

And from lol_analyze_performance:

Performance Analysis: YourName#EUW (last 20 ranked games)

Overall: 12W 8L (60% WR) | Avg KDA: 2.8 | Avg CS/min: 6.4

Strengths:
  - Vision score above average for Gold (0.92/min vs 0.71 avg)
  - Strong early game: 65% first blood participation
  - Consistent CS in first 15 min (avg 112 CS)

Weaknesses:
  - Deaths increase after 25 min (4.2 avg in late game)
  - Low dragon participation (35% vs 52% Gold avg)
  - Champion pool too wide: 12 different champions in 20 games

Recommendation: Narrow your pool to 3 champions. Your best performers
are Jinx (68% WR, 8 games) and Kai'Sa (62% WR, 5 games). Drop champions
below 45% win rate.

Which regions are supported?

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

Do I need a Riot API key?

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

How do I configure the server?

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

What data format does it return?

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

Is my data safe?

• 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?

Tier	Cost	What you get
Per call	$0.003-$0.025	Simple reads cost less, AI analysis costs more
Free tier	$5 free credits/month	~200-1,600 tool calls for free every month
Starter plan	$49/month	~2,000-16,000 tool calls/month

This MCP server uses Apify's pay-per-event pricing. You only pay when your AI assistant uses a tool — no idle costs. Start with $5 free credits.

Estimates based on event pricing only. Actual costs may include minimal platform compute fees. The free $5 credit covers both.

Detailed pricing:

Operation	Price	Examples
Read	$0.003	get_account, get_ranked, get_champion_mastery
Match	$0.005	get_match_history, get_match_details
Live	$0.008	get_live_game
Analysis	$0.015	analyze_performance
Compare	$0.025	compare_players

Example costs:

• Quick player lookup (1 read): ~$0.003
• Full performance analysis (3-5 tool calls): ~$0.02-$0.04
• Detailed coaching session (10-15 tool calls): ~$0.05-$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.

Other MCP servers by mrbridge

Server	Category	Tools	Best for
ESPN MCP Server	Sports	12 tools	Live scores, standings & stats for 25+ leagues
TFT MCP Server	Gaming	10 tools	Teamfight Tactics comp analysis & coaching
Latest News MCP	News	14 tools	Real-time news from 27 free APIs
Todoist AI Assistant	Productivity	16 actions	Smart task management & AI prioritization

All servers use pay-per-event pricing. $5 free credits/month included.

Resources

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

Changelog

• v2.0.1 (2026-03-20) — SEO-optimized headings, anti-friction messaging, cross-sell table, input schema sections

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