LUMA NBA Impact Metrics

Connect Remote server

claude mcp add --transport http luma https://lumahoops.org/api/mcp --header "x-luma-key: <X_LUMA_KEY>"

{
  "mcpServers": {
    "luma": {
      "url": "https://lumahoops.org/api/mcp",
      "headers": {
        "x-luma-key": "<X_LUMA_KEY>"
      }
    }
  }
}

{
  "servers": {
    "luma": {
      "type": "http",
      "url": "https://lumahoops.org/api/mcp",
      "headers": {
        "x-luma-key": "<X_LUMA_KEY>"
      }
    }
  }
}

Settings > Connectors > Add custom connector
URL: https://lumahoops.org/api/mcp

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools 16 found in our last check

• start_here

  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.

• describe

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

• search_players

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

• player

  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 s…

• leaderboard

  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…

• compare

  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 | xp…

• game_log

  Box-score game log for a player and season (regular season or playoffs). last_n limits to the most recent games.

• onoff

  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 o…

• wowy

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

• lineups

  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.

• game_ratings

  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 off…

• docs

  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.

• read_doc

  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.

• explain

  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.

• read_page

  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. Lo…

• sql

  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 lineup…

Headers

Details

More data and analytics servers See all

• Valuein — SEC EDGAR Fundamentals & Smart-Money Data

  Point-in-time, survivorship-free SEC EDGAR fundamentals + smart-money signals for AI agents.

• BeYadCha Israeli medical rights

  Israeli medical and disability rights in Hebrew: sourced guides and a visual eligibility map.

• Eikino

  Geolocate photos or video frames and check media for AI generation signs via API key.

• Stratum Market Research

  Global market size, trade and top exporters for 6,000+ markets, plus company rankings. Read-only.

• TradeStats - customs trade statistics

  Monthly customs trade statistics (Japan, UK) by HS code and partner country, for AI agents.

• TracePass DPP Compliance Assistant

  Answers EU Digital Product Passport questions: scope, required fields, registry and law changes.