io.github.RyanKramer/rankedtoday-mcp (Ranked Today MCP)

Ranked Today MCP is a Model Context Protocol (MCP) server providing League of Legends math for AI agents, including MMR estimation from LP flow, climb projections, KDA calculations, and lifetime hours. It also includes research references on sleep and reaction time, presented without folklore. It requires no API key and makes no network calls.

🛠️ Key Features

Estimate MMR from LP flow
Project a climb
Calculate KDA and lifetime hours
Provide sleep and reaction time research

🚀 Use Cases

Building AI agents that need LoL rank or performance math
Computing rank-related metrics without relying on external services
Using a cognitive-readiness reference alongside gameplay analytics

⚡ Developer Benefits

No API key
No Riot account
No network calls
Tools described as pure functions with arithmetic shown

⚠️ Limitations

Scope appears limited to League of Legends math and cognitive-readiness research; no other game-specific systems are described.

🔎 Related Resources

Web tools: shouldiplayrankedtoday.com/tools

Ranked Today MCP

League of Legends math and cognitive-readiness reference for AI agents. Estimate MMR from LP flow, project a climb, calculate KDA and lifetime hours, and get the research on sleep and reaction time without the folklore.

No API key. No Riot account. No network calls. Every tool is a pure function and every estimate shows its arithmetic.

Tools

Tool

What it does

estimate_mmr

Infers whether MMR sits above or below your rank from LP gain/loss asymmetry

climb_calculator

Games required to reach a target LP total, or whether the climb runs backward

kda

KDA with a role-aware read and the winrate caveat

hours_played

Lifetime hours from account level, with the math and the error bars

hardware_latency_budget

How much of a reaction-test score is your monitor and mouse, not you

readiness_reference

What the sleep/cognition research supports — and explicitly what it does not

season_countdown

Days to a ranked season boundary

rankedtoday_tools

Free cognitive tests and League tools on the web

Design notes

Nothing here pretends to read hidden data. Riot removed public MMR from the API years ago, and there is no lifetime hours counter. estimate_mmr infers from the LP exchange rate and says so; hours_played converts account level and reports plus-or-minus 20% along with what it cannot see. Any tool printing an exact MMR from a summoner name is guessing without telling you.

readiness_reference includes the disconfirming evidence. It lists what the research supports (+49 ms after one all-nighter, 5x more attention lapses, the 516-player rank correlation) and what it does not — including a controlled study where sleep-deprived players' cognition tanked while game outcomes barely moved. Readiness is a probabilistic personal signal, never a win predictor.

climb_calculator will tell you the climb runs backward. Below your breakeven winrate, more games means less LP. It returns that verdict rather than a games-required number, because the honest answer is that this climb does not finish.

io.github.RyanKramer/rankedtoday-mcp