League of Legends MCP Server: stats and coaching

🎮 League of Legends MCP Server

League of Legends MCP Server connects AI assistants (Claude Desktop, ChatGPT, and any MCP-compatible agent) to live League of Legends data via the Model Context Protocol. Let AI analyze your games, find what's costing you LP, and coach you on your real numbers: 26 tools covering player profiles, ranked stats, match history, champion mastery, live games, league standings, Clash, challenges, and AI-powered coaching.

Ask Claude "Analyze my last 20 ranked games and tell me why I'm stuck in Bronze" and it calls lol_get_player_profile and lol_analyze_performance, then hands you a coaching report with strengths, weaknesses, and a climbing plan. No Riot API key needed, no setup, no coding. Just connect and start analyzing.

For Teamfight Tactics, the same setup works with the TFT API for Claude.

What is LoL MCP Server?

LoL MCP Server runs in Apify's Standby mode as a persistent server that conversational AI assistants (Claude Desktop, ChatGPT, and any MCP-compatible client) call to read and analyze any player's League of Legends data. Ask in plain language, and the AI pulls your real numbers and coaches you on them.

• 🩺 Performance diagnosis that names the leak: deaths per game, CS economy, vision habits and KDA benchmarked against your rank, from your real ranked games
• 🎯 A champion pool built for your playstyle: not a generic tier list, but recommendations grounded in the champions that actually win for you
• 📜 Full match breakdowns: KDA, damage, objectives, gold and minute-by-minute timelines, name-resolved via Data Dragon (no cryptic IDs)
• 📡 Live & ladder intel: scout live games, Challenger/GM/Master ladders, any tier page, Clash teams and challenge leaderboards
• ⚔️ 26 tools, 14 regions: EUW to KR, with AI analysis in English or French
• 🔑 Zero setup, built-in Riot key: no developer account, no 24-hour key to regenerate, just connect and ask
• 🔌 Speaks MCP over Streamable HTTP: built for Claude Desktop, ChatGPT, and any MCP-compatible client
• ⚡ Standby mode: fast responses once warm, and a cold start adds ~5–10 s only on the first call after idle

Quick Start: Connect in 2 minutes

No Riot API key needed: the server includes a built-in key. Your connection URL is the same for every client. Replace YOUR_APIFY_TOKEN with your Apify API token:

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

1. Connect your AI assistant

• Claude Desktop: Settings → Connectors → Add custom connector, paste the URL above, save.
• ChatGPT (Plus / Pro / Team / Enterprise): Settings → Connectors, enable Developer mode, Add custom connector, paste the URL, save. Also available in deep research.
• Apify Universal MCP: already using mcp.apify.com? Skip the separate config and add this server as a tool: https://mcp.apify.com?tools=mrbridge/lol-mcp-server.

2. Start asking questions

That's it! Try:

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

The endpoint speaks Streamable HTTP at /mcp. There is no /sse endpoint.

Real Example: AI coaching from your match history

Here is the kind of analysis Claude produces for a real player (Bronze III jungle main, EUW) over 50 ranked games, using only this MCP server's tools, with no manual data entry.

The diagnosis (from lol_analyze_performance):

Your problem isn't creating plays (8.2 assists per game is above your rank's average). It's dying: 6.8 deaths per game against a sub-4.5 target, for a 1.61 KDA. And your farming collapses under pressure, with 87 vs 262 CS in games of similar length, roughly 600–700 gold per game left on the table.

What works vs what holds you back (mastery and win rates cross-referenced):

Champion	Ranked games	Win rate	Verdict
Rammus	41	44%	⭐ statistically reliable main: keep
Udyr (M20, 271K pts)	12	25%	🚩 highest mastery, worst results: retrain first
Alistar	7	~14%	🚩 avoid until mechanics improve

From there Claude drew the actionable plan: keep Rammus as primary with a backup for ban games, cut deaths by changing gank exits, stabilize the farming routine under pressure. Then it laid out ELO benchmarks and a 90-day improvement plan.

Every number above came from the player's real match history through this MCP server. Just ask your AI to analyze any Riot ID.

Try it yourself:

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

Other MCP clients

Any MCP-compatible client speaks to the same Streamable HTTP endpoint (/mcp) with your Apify token in the Authorization: Bearer header or ?token= query. This server is built for conversational assistants: Claude Desktop and ChatGPT are where game coaching shines.

Zapier, Make & n8n

LoL MCP Server runs on Apify, which integrates natively with automation platforms: use the Apify Zapier integration, the Apify Make integration, or the Apify n8n node with Actor ID EC9IhPoWo8Z4mHPJU. Example Zap: daily ranked-stats analysis posted to Discord.

Authentication

All requests require an Apify API token (get it here), passed either as the ?token= query parameter or as an Authorization: Bearer header (preferred for production). An invalid token returns HTTP 401 and consumes nothing. No Riot API key is required: the server includes a built-in key.

What tools are available? (26 tools)

Account & Profile

Billed as Data Retrieval ($0.003/call), except lol_get_player_profile, which bills as Match Data ($0.005/call).

Tool	What it does
lol_get_account	Account by Riot ID, with the PUUID used by other calls
lol_get_summoner	Summoner info (level, profile icon) by PUUID
lol_get_ranked	Ranked info (tier, rank, LP, win/loss) by PUUID
lol_get_player_profile	Complete profile (account + summoner + ranked) in one call: the recommended starting point

Match Data

Billed as Match Data ($0.005/call).

Tool	What it does
lol_get_match_history	Recent match IDs for a player
lol_get_match_details	Detailed match data with resolved champion, item and rune names
lol_get_match_timeline	Minute-by-minute timeline: gold differences, kills, objectives

Champion Mastery

Billed as Data Retrieval ($0.003/call).

Tool	What it does
lol_get_champion_mastery	Top champion masteries with points, levels and champion roles
lol_get_mastery_by_champion	Detailed mastery for one champion: level, points, progression, season milestones

Live Game

Billed as Match Data ($0.005/call).

Tool	What it does
lol_get_live_game	Check if a player is in game, with live details: participants, champions, runes, spells

Leagues & Ranked Ladders

Billed as Data Retrieval ($0.003/call).

Tool	What it does
lol_get_league_top	Challenger, Grandmaster or Master league: the 50 highest players by LP, each with puuid and Riot ID
lol_get_league_entries	League entries by queue, tier and division (paginated), with puuid
lol_get_league_by_id	League by its UUID: up to 100 players with puuid, and the Riot IDs of the 50 highest
lol_get_league_entries_exp	Paginated entries including apex tiers (Master+), with puuid

Clash

Billed as Data Retrieval ($0.003/call).

Tool	What it does
lol_get_clash_player	Clash registration info for a player (teams, positions)
lol_get_clash_team	Clash team: name, tier, captain and players
lol_get_clash_tournaments	Active Clash tournaments, by ID or by team

Challenges

Billed as Data Retrieval ($0.003/call).

Tool	What it does
lol_get_challenges	Challenge configurations, percentiles or leaderboards
lol_get_player_challenges	A player's challenge progression: points, categories, progress

Utility

Billed as Data Retrieval ($0.003/call), except lol_get_featured_games, which is free.

Tool	What it does
lol_get_champion_rotation	Current free champion rotation
lol_get_featured_games	Riot retired the featured games endpoint in October 2025: returns that notice. For one player's current game, use lol_get_live_game
lol_get_server_status	Server status for a region: incidents and maintenance

AI Analysis

Billed as AI Analysis ($0.015/call).

Tool	What it does
lol_analyze_performance	Recent performance: stats, strengths, weaknesses, rank-based tips
lol_analyze_champion	Performance on a specific champion with stats and tips
lol_get_improvement_tips	Personalized, actionable tips with current vs target values
lol_compare_players	Compare two players side by side: KDA, CS, vision, damage

What can AI do with your LoL data?

• Post-game coaching: "I just lost 3 games in a row. Analyze what went wrong."
• Champion pool optimization: "Which 3 champions should I focus on to climb fastest?"
• Duo synergy analysis: "Compare me and my duo partner. What are our strengths together?"
• Live scouting: "I'm in game right now. Scout my opponents."

What does the output look like?

A sample response 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 Gold average; strong early game
Weaknesses: deaths spike after 25 min; champion pool too wide
Recommendation: narrow your pool to Jinx (68% WR) and Kai'Sa (62% WR).

Which regions are supported?

All 14 League of Legends regions, from euw1 (Europe West) and na1 to kr. The full list is in the input form. Riot merged PH2 and TH2 into SG2 on 2025-01-09. The server still accepts ph2 and th2, answers them with SG2 data, and says so in the answer. Configuration options: defaultRegion (default euw1), defaultLanguage (en or fr, used for AI analysis), cacheEnabled (default true).

Standby mode & performance

The server runs in Apify Standby mode: a persistent HTTP server that stays warm between requests.

• Cold start: ~5–10 seconds on the first request after inactivity. Requests are fast while warm.
• Idle timeout: 5 minutes without requests, then the server shuts down and the next request triggers another cold start.
• Platform usage while awake: on top of the tool-call events, you pay the platform usage of the server while it is awake. It stops when the server shuts down after the idle timeout.

How much does it cost?

LoL MCP Server uses a pay-per-event pricing model: your AI assistant's tool calls are billed under three events (Data Retrieval, Match Data, and AI Analysis), and you're charged only on successful calls. See the Pricing tab for the live price table by Apify subscription tier.

A typical session (one profile check plus a 20-match performance analysis) costs about $0.04.

What is NOT charged: errors (for example a player that Riot cannot find, or a Riot outage), input errors such as an unknown champion name, lol_get_featured_games, and calls made after your spending limit is reached.

Cost cap: you can cap spending with Apify's maximum total charge limit (ACTOR_MAX_TOTAL_CHARGE_USD). Once the cap is reached, further tool calls are rejected instead of billing past your limit.

More gaming MCP servers

• Teamfight Tactics stats MCP: Teamfight Tactics profiles, stats, match history and placement coaching, with no Riot API key.
• Dota 2 match stats MCP server: Dota 2 rank medals, match history, hero win rates, counters and item builds from public match data.
• chess MCP server: player ratings, analyzed games reviewed mistake by mistake, engine evaluations and the daily puzzle.
• PC game deals MCP server: the cheapest store for a PC game, deals and free giveaways, each with its lowest recorded price.

FAQ

Do I need a Riot API key?

No. The server includes a built-in Riot API key. You can start immediately without a Riot developer account.

Why is my first request slow?

Cold start: after 5 idle minutes the server shuts down and the next request takes ~5–10 s to spin it up (see Standby mode).

Does this work with ChatGPT?

Yes, via Developer-mode connectors and deep research (see Quick Start). Claude Desktop and any MCP-compatible client work too.

What rate limits apply?

The server follows the limits Riot sets for its API key in each region. Bursts of tool calls wait in a queue, and cached answers cost no request at all. Apify starts an instance of the server for each user, and more when one user sends many calls at once. All instances share the key's limits: each one reads Riot's count of the key's requests and waits when a limit is reached. If a call would have to wait longer than a tool call allows, it stops early and tells you when to try again. That call is not charged.

What happens when I hit my spending cap?

Subsequent tool calls return an error instead of being billed. You are never charged beyond your cap.

Can I analyze other players?

Yes. Any player's public data can be looked up by Riot ID (gameName#tagLine). No special permission is needed for public data.

Can I reuse a PUUID from the TFT server?

No. A PUUID is only valid on the server that returned it. The LoL and TFT servers run on two Riot applications, and Riot encrypts PUUIDs per application, so a PUUID from the TFT server is refused here. Look the player up again by Riot ID with lol_get_account.

Is my data stored?

No. Requests are processed in real time and no player data is stored permanently. All data comes directly from Riot Games' official API.

How do I see my usage and costs?

In the Apify Console under Billing → Usage, filtered by this Actor.

Built by MrBridge

This MCP server is built by MrBridge. See the LoL MCP server overview or the MCP server catalog. Learn more about what we do at mr-bridge.com.

Resources

• LoL MCP Server solution page
• Riot Developer Portal
• Claude Desktop MCP Setup
• Apify MCP Documentation

Legal & responsible use

This Actor retrieves publicly available game data through the official Riot Games API. You are responsible for ensuring your use complies with the Riot Games API Terms of Service and applicable data-protection regulation. LoL MCP Server is not endorsed by and is not affiliated with Riot Games. League of Legends is a trademark of Riot Games, Inc.

Your feedback

Found a bug or have a feature request? Open an issue on the Issues tab. We read every report.

---

Built with ❤️ for the League of Legends community