🎮 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" — it calls lol_get_player_profile and lol_analyze_performance and 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.

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; 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; 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, 16 regions — EUW to KR; AI analysis in English or French
• 🔑 Zero setup, built-in Riot key — no developer account, no 24-hour key to regenerate; connect and ask
• 🔌 Speaks MCP over Streamable HTTP — built for Claude Desktop, ChatGPT, and any MCP-compatible client
• ⚡ Standby mode — fast responses once warm; 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 — 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 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; returns 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; 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, sorted by LP
lol_get_league_entries	League entries by queue, tier and division (paginated)
lol_get_league_by_id	Full league by its UUID
lol_get_league_entries_exp	Paginated entries including apex tiers (Master+)

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

Tool	What it does
lol_get_champion_rotation	Current free champion rotation
lol_get_featured_games	Featured (spectatable) high-level games currently running
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 16 League of Legends regions, from euw1 (Europe West) and na1 to kr — the full list is in the input form. 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; the next request triggers another cold start.
• No idle cost for you: billing is per tool call only — you pay nothing while the server sits idle.

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: failed tool calls are never billed.

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.

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 respects Riot Games API limits (20 requests/second, 100 requests/2 minutes) with an internal rate limiter and caching, so bursts of tool calls are queued rather than failing.

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.

Is my data stored?

No. Requests are processed in real time; 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.

Other MCP servers by mrbridge

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

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

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