LUMA NBA Impact Metrics
Server Details
Free NBA impact metrics: ARC, LOKI, game ratings, on/off, lineups, box scores. SQL + player tools.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 16 tools
The data-querying tools (player, compare, leaderboard, sql, lineups, onoff, wowy, game_log, game_ratings) are mostly distinct, but there is a cluster of six documentation/help tools (start_here, docs, read_doc, read_page, describe, explain) whose boundaries overlap substantially. Descriptions offer guidance on when to use each, but an agent can easily misselect among them.
Names mix verb_noun forms (search_players, read_doc, game_log) with bare nouns (player, leaderboard, lineups, sql, wowy) and a compressed form (onoff). The convention is readable and all lowercase, but there is no predictable single pattern across the set.
At 16 tools this is slightly above the comfortable 3-15 range, but each tool maps to a real analysis workflow in a complex metrics domain. A few documentation helpers could be consolidated, but the overall scope is reasonable.
Coverage is strong: player profiles, comparisons, leaderboards, game logs, game ratings, lineups, on/off, WOWY, raw SQL, and extensive docs. The main gap is the lack of a dedicated team-level profile/analysis tool, though SQL and team-level filters partially compensate.
Available Tools
16 toolscompareBRead-onlyIdempotentInspect
Side-by-side comparison of 2-6 players for one season. source: all (default: ARC net / O / D / SV / PV, the SV / PV tree, SV by zone, individual-skill view, PAC, xPTS-RAPM, skills, LOKI, on/off, box in one answer) | arc_season | arc_svpv | arc_zones | arc_skill | pac_season | xpts_rapm | skills_season | loki_release | onoff_season | box_season. window = ARC window, default 2.
Inputs: players (required), season, source, window.
describeARead-onlyIdempotentInspect
What a table, column or metric MEANS: definition, unit, which way is good, stability, flags. Pass a table (players, games, box_game, box_season, arc_season, arc_live, loki, loki_release, onoff_season, lineups, wowy, channels, xpts_rapm, player_seasons, pac_season, skills_season) or a metric id (e.g. sk_playmaking, ocreated, o_sel_rim, xq_d). Pass nothing for the conventions (units, seasons, sample sizes).
Inputs: table, column, metric.
docsARead-onlyIdempotentInspect
Map of the LUMA agent docs (agent-to-agent): house rules, what each model is, every column defined, how to read ARC, published test results, FAQ, and the public pages to read for more. Read once per session, before explaining any LUMA model to a user.
Inputs: no named parameters.
explainARead-onlyIdempotentInspect
Explain one LUMA term (e.g. "ARC", "LOKI", "shot value", "retention", "lineups", "Team FE", "cRAPM", "PAC", "p_top10"): the matching definitions from the agent docs plus any metric channels with that name. Use it when a user asks what something means.
Inputs: term (required).
game_logBRead-onlyIdempotentInspect
Box-score game log for a player and season (regular season or playoffs). last_n limits to the most recent games.
Inputs: player (required), last_n, season, season_type.
game_ratingsARead-onlyIdempotentInspect
LUMA game ratings (the lumahoops.org/games page): every NBA regular-season game of 2025-26 and 2026-27, each player's Game ARC (points he added to his team's margin vs an average player in the same possessions), Game ARC per 100 possessions, the four ARC channels (shot value offense / defense, possession value gained / retained), the 0-10 game rating (6.6 = a typical game), PAC and his box score. level: players (default) or teams (team totals, average rating, channels). Filters: date (YYYY-MM-DD, or "latest" = the latest rated day; the default when no other filter is given), from, to, game_id, team, player (name), min_minutes. decomposition: true (players level) adds the full Game ARC decomposition: each channel split into its counted parts, shot parts by zone (rim, paint, mid, three) and free throws, attempts and makes per zone, plus one lineup number per channel; parts + lineup = the channel. Updated daily. Up to 5,000 rows per call; use offset for more.
Inputs: to, date, from, team, +7 more.
leaderboardARead-onlyIdempotentInspect
Ranked list from one source. source: arc_season | arc_live | loki | loki_release | onoff_season | box_season | xpts_rapm | pac_season | skills_season (e.g. sk_switchability_pct) | channels (metric = a metric id from describe, e.g. sk_playmaking, ocreated, xq_d; window 1-5, LOKI channels have one value per season). metric must be a column of that source. Filters: season, window (arc_season 1-5), release (loki R1-R4, or weekly for the in-progress season; default R1, newest for the in-progress season), min_poss, pos (G/W/B), team, per (box_season: total|per_game).
Inputs: source (required), per, pos, team, +7 more.
lineupsBRead-onlyIdempotentInspect
Lineup groups (2-5 players together) for a team-season, or the groups a player is in. size 2-5 (default 5). No possession minimum (default sort = possessions; use min_poss to filter). sort: poss | net | ortg | drtg.
Inputs: size, sort, team, limit, +3 more.
onoffBRead-onlyIdempotentInspect
Raw on/off splits for a player across seasons: team ratings and shot diet with him on vs off (games he played) plus the NBA.com-style tenure version. Unadjusted -- depends on teammates and opponents. season = one season; or from_season / to_season. No possession minimum: check on_poss / off_poss.
Inputs: player (required), season, to_season, from_season.
playerARead-onlyIdempotentInspect
One-stop player profile for a season (owner 2026-10-25: show everything). ARC 2-season and 1-season (net, O, D, shot value SV, possession value PV), the full SV / PV tree (selection, conversion, retention, generation, O and D), SV by zone, ARC individual-skill view (a separate slicing of the same total), PAC, xPTS-RAPM, creation lens, top skills, LOKI, raw on/off, top WOWY partners, box score. Default season = the last full season until about the All-Star break of the season in progress (the response says so); pass season for the current one (2027 = 2026-27).
Inputs: player (required), season.
read_docARead-onlyIdempotentInspect
Read one LUMA agent doc. ids: README, boundary, concepts, how-to-read-arc, metrics, validation, faq. boundary = house rules (read before quoting numbers); concepts = the models; metrics = every column; how-to-read-arc = what an ARC number means; validation = test results; faq.
Inputs: id (required).
read_pageARead-onlyIdempotentInspect
Read a public LUMA page as text (lumahoops.org), for when the agent docs point to a page: e.g. /luma/arc/about, /luma/loki/about, /luma/pac, /luma/rapm, /luma/wins, /luma/changelog, /luma/papers/pac-working-paper-v1.pdf, /luma/research/possession-by-possession-fundamentalism. Long pages come in chunks: pass offset to continue.
Inputs: url (required), offset.
search_playersARead-onlyIdempotentInspect
Find players by (part of) name, accent-insensitive. Returns pid, name, first/last season, position group (G/W/B).
Inputs: query (required), limit.
sqlARead-onlyIdempotentInspect
Read-only SQL (DuckDB dialect) over the warehouse views: players, player_seasons (listed position / height by season), games, box_game, box_season, arc_season, arc_live, loki, loki_release, pac_season, skills_season (19 skill groups + season percentiles), onoff_season and lineups (incl. four factors and rebound shares), wowy, channels, xpts_rapm. One SELECT only, max 200 rows; PIVOT is not allowed (use max(x) filter (where ...)); quote "window" and "asof"; write every column alias with AS (a bare alias like load / value / rows / minutes is a syntax error). Use other tools first; call describe for column meanings.
Inputs: query (required), limit.
start_hereARead-onlyIdempotentInspect
CALL THIS FIRST. Returns the LUMA guide (LUMA.md): every table and column, conventions (seasons, heights, positions, per-100, traded players), worked SQL recipes, what is NOT available, and the rules for crediting the data. Read it before writing sql.
Inputs: no named parameters.
wowyARead-onlyIdempotentInspect
With-or-without-you for teammates in a team-season: team ratings with both on, only A, only B, neither. Give two players, or one player to list his partners. No possession minimum: check poss_together (small states are noise).
Inputs: player (required), with, limit, season.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
NBA and WNBA player-prop analytics: daily board, graded track record, matchup and referee data.
NFL/NBA/MLB/NHL/PGA + DFS and prediction-market data. Browse free; query with a free API key.
NBA and NFL stats: profiles, head-to-head, schedules, ratings, EPA, injuries, projections.
NBA MCP — player, team, and game data via the BallDontLie API
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to query NBA, WNBA, and men's and women's college basketball data through tools for play-by-play, shot charts, stats, odds, props, injuries, and ratings.MIT
- AlicenseNot gradedqualityBmaintenanceMCP server for querying validated EuroLeague and EuroCup basketball analytics, including possession-based metrics, four factors, and lineup-level on/off data reconstructed from play-by-play events.1MIT
- AlicenseNot gradedqualityDmaintenanceProvides comprehensive NBA player statistics from basketball-reference.com, delivering detailed stats including career summaries, season comparisons, advanced metrics, and shooting analytics.5MIT
- AlicenseAqualityCmaintenanceEnables querying NBA and WNBA player-prop model picks, the daily board, public track record, games, and player search through the nbaproplab.com REST API, with optional API-key tools for backtests, pick evaluation, and player research. All tools are read-only and most require no authentication.12MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.