Skip to main content
Glama

LUMA NBA Impact Metrics

Server Details

Free NBA impact metrics: ARC, LOKI, game ratings, on/off, lineups, box scores. SQL + player tools.

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
ChatGPT
–
Claude
–

TDQS

A3.5/5.0

Scored across 16 tools

Disambiguation3/5

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.

Naming Consistency3/5

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.

Tool Count4/5

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.

Completeness4/5

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 tools
compareB
Read-onlyIdempotent
Inspect

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.

describeA
Read-onlyIdempotent
Inspect

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.

docsA
Read-onlyIdempotent
Inspect

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.

explainA
Read-onlyIdempotent
Inspect

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_logB
Read-onlyIdempotent
Inspect

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_ratingsA
Read-onlyIdempotent
Inspect

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.

leaderboardA
Read-onlyIdempotent
Inspect

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.

lineupsB
Read-onlyIdempotent
Inspect

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.

onoffB
Read-onlyIdempotent
Inspect

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.

playerA
Read-onlyIdempotent
Inspect

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_docA
Read-onlyIdempotent
Inspect

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_pageA
Read-onlyIdempotent
Inspect

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_playersA
Read-onlyIdempotent
Inspect

Find players by (part of) name, accent-insensitive. Returns pid, name, first/last season, position group (G/W/B).

Inputs: query (required), limit.

sqlA
Read-onlyIdempotent
Inspect

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_hereA
Read-onlyIdempotent
Inspect

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.

wowyA
Read-onlyIdempotent
Inspect

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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP 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.
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides comprehensive NBA player statistics from basketball-reference.com, delivering detailed stats including career summaries, season comparisons, advanced metrics, and shooting analytics.
      5
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      12
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources