Rankedtoday Mcp

io.github.RyanKramerPublished by GitHub account RyanKramerv0.1.0Updated Oct 24, 2026

League of Legends math for AI agents: MMR estimation, climb projections, KDA, hours. No API key.

VerifiedSTDIODesktop onlyLocation & LifestyleData & Analytics

Overview

AI-generated overview

Offline League of Legends math tools for assistants: MMR estimation, climb projections, KDA, lifetime hours, latency and readiness references.

What you can do
  • Estimate MMR from LP gain/loss asymmetry and project games needed to reach a target LP total
  • Calculate KDA with a role-aware reading and lifetime hours from account level
  • Break down a reaction-test score into monitor and mouse latency
  • Look up sleep and cognition research findings and days to a ranked season boundary
  • Point to free web-based cognitive tests and League tools
When to use it
Useful when a League of Legends player wants arithmetic-backed answers about rank, MMR, climbing pace, KDA, playtime or reaction time, and prefers estimates that show their assumptions rather than hidden-data claims.
Requirements
Runs as a local stdio process, installed with uvx or pip from the rankedtoday-mcp package. No API key, Riot account or network calls are needed.
Before you install
Estimates are inferences, not real MMR or playtime data: MMR is derived from LP exchange rates and hours carry roughly plus-or-minus 20% error. Readiness figures are a personal probabilistic signal, not a win predictor. Not affiliated with Riot Games.

Installation

In SourceWeft

  1. Open Rankedtoday Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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.

Web versions: shouldiplayrankedtoday.com/tools

Install

json
{  "mcpServers": {    "rankedtoday": {      "command": "uvx",      "args": ["rankedtoday-mcp"]    }  }}

Or pip install rankedtoday-mcp.

Tools

ToolWhat it does
estimate_mmrInfers whether MMR sits above or below your rank from LP gain/loss asymmetry
climb_calculatorGames required to reach a target LP total, or whether the climb runs backward
kdaKDA with a role-aware read and the winrate caveat
hours_playedLifetime hours from account level, with the math and the error bars
hardware_latency_budgetHow much of a reaction-test score is your monitor and mouse, not you
readiness_referenceWhat the sleep/cognition research supports — and explicitly what it does not
season_countdownDays to a ranked season boundary
rankedtoday_toolsFree 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.

Development

bash
git clone https://github.com/RyanKramer/rankedtoday-mcpcd rankedtoday-mcppip install -e .rankedtoday-mcp

About

Built by Ranked Today — a 3-minute daily cognitive readiness check for League players. Free cognitive tests, no signup.

Not affiliated with or endorsed by Riot Games.

MIT licensed.

Source: README.md at commit 613cee4

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts