# LUMA NBA Impact Metrics (remote · lumahoops.org)

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

- Trust score: 68/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- remote · `lumahoops.org`: 68/100 (this document), [markdown](https://verifymcp.io/servers/org-lumahoops-luma/api-mcp.md), [page](https://verifymcp.io/servers/org-lumahoops-luma/api-mcp)

## Channel facts

- Endpoint: `https://lumahoops.org/api/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Endpoint Security**: 74/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Nothing on it is marked destructive, but we can't show that an anonymous caller can only read: full credit needs the server to list at least one tool and every tool to be verifiably read-only. We use a best-effort check of tool names and descriptions to tell read-only tools from tools that change things, so some genuinely read-only tools may not get full credit. Names that start with a read verb (get, list, read, search and similar) and accurate readOnlyHint annotations help. Meet that to earn full credit, or require authorisation.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 56/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 3194 tokens (~199/item across 16 items; 16 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 20/100
  - Stability observed for 6 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 68/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 5% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 16 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 17 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the LUMA NBA Impact Metrics MCP server?

LUMA NBA Impact Metrics is a hosted endpoint at https://lumahoops.org/api/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http org-lumahoops-luma 'https://lumahoops.org/api/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "org-lumahoops-luma": {
      "url": "https://lumahoops.org/api/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "org-lumahoops-luma": {
      "type": "http",
      "url": "https://lumahoops.org/api/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.org-lumahoops-luma]
url = "https://lumahoops.org/api/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "org-lumahoops-luma": {
      "type": "remote",
      "url": "https://lumahoops.org/api/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add org-lumahoops-luma --url 'https://lumahoops.org/api/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  org-lumahoops-luma:
    url: "https://lumahoops.org/api/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "org-lumahoops-luma": {
      "Transport": "http",
      "Url": "https://lumahoops.org/api/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add org-lumahoops-luma -t streamable-http -u 'https://lumahoops.org/api/mcp'
```

### Other

```json
{
  "mcpServers": {
    "org-lumahoops-luma": {
      "type": "http",
      "url": "https://lumahoops.org/api/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-20 (score 68, +1)

No change was recorded against any check on this day. Stability & Change Management went from 13 to 17. That category is still filling its 30-day observation window: 4 days of observed history at the previous scan, 5 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-18 (score 67, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-16 (score 66, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-11-15 (score 65)

First indexed and scored.

## MCP tools (16)

### `start_here` (~67 tokens)

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` (~148 tokens)

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

Input parameters:

- `column` (string)
- `metric` (string)
- `table` (string)

### `search_players` (~52 tokens)

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

Input parameters:

- `limit` (integer)
- `query` (string, required)

### `player` (~189 tokens)

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

Input parameters:

- `player` (string, required): name or pid
- `season` (integer): end year, e.g. 2026 = 2025-26

### `leaderboard` (~254 tokens)

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

Input parameters:

- `ascending` (boolean)
- `limit` (integer)
- `metric` (string)
- `min_poss` (integer)
- `per` (string)
- `pos` (string)
- `release` (string)
- `season` (integer)
- `source` (string, required)
- `team` (string)
- `window` (integer)

### `compare` (~156 tokens)

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.

Input parameters:

- `players` (array, required)
- `season` (integer)
- `source` (string)
- `window` (integer)

### `game_log` (~62 tokens)

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

Input parameters:

- `last_n` (integer)
- `player` (string, required)
- `season` (integer)
- `season_type` (string)

### `onoff` (~110 tokens)

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.

Input parameters:

- `from_season` (integer)
- `player` (string, required)
- `season` (integer)
- `to_season` (integer)

### `wowy` (~88 tokens)

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

Input parameters:

- `limit` (integer)
- `player` (string, required)
- `season` (integer)
- `with` (string)

### `lineups` (~120 tokens)

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.

Input parameters:

- `limit` (integer)
- `min_poss` (integer)
- `player` (string)
- `season` (integer)
- `size` (integer)
- `sort` (string)
- `team` (string)

### `game_ratings` (~324 tokens)

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.

Input parameters:

- `date` (string)
- `decomposition` (boolean)
- `from` (string)
- `game_id` (string)
- `level` (string)
- `limit` (integer)
- `min_minutes` (number)
- `offset` (integer)
- `player` (string)
- `team` (string)
- `to` (string)

### `docs` (~66 tokens)

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` (~81 tokens)

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.

Input parameters:

- `id` (string, required)

### `explain` (~85 tokens)

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.

Input parameters:

- `term` (string, required)

### `read_page` (~135 tokens)

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.

Input parameters:

- `offset` (integer)
- `url` (string, required): lumahoops.org URL or path

### `sql` (~181 tokens)

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.

Input parameters:

- `limit` (integer)
- `query` (string, required)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/org-lumahoops-luma/api-mcp#diagnostics

## Score history

- 2026-11-21: 68
- 2026-11-20: 68
- 2026-11-19: 67
- 2026-11-18: 67
- 2026-11-17: 66
- 2026-11-16: 66
- 2026-11-15: 65

## Common questions

### What is the LUMA NBA Impact Metrics MCP server?

LUMA NBA Impact Metrics is an MCP server listed in the public MCP registry as org.lumahoops/luma. Free NBA impact metrics: ARC, LOKI, game ratings, on/off, lineups, box scores. SQL + player tools. This page covers its hosted endpoint (https://lumahoops.org/api/mcp).

### Is the LUMA NBA Impact Metrics MCP server safe to use?

LUMA NBA Impact Metrics scores 68 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the LUMA NBA Impact Metrics MCP server expose?

LUMA NBA Impact Metrics exposes 16 tools: start_here, describe, search_players, player, leaderboard, and 11 more. Their descriptions and schemas cost roughly 2,118 tokens of context every time the server is loaded.

### Does the LUMA NBA Impact Metrics MCP server require authentication?

No. We connected to LUMA NBA Impact Metrics without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the LUMA NBA Impact Metrics MCP server still maintained?

LUMA NBA Impact Metrics is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What did VerifyMCP test on the LUMA NBA Impact Metrics MCP server?

VerifyMCP ran 13 checks on LUMA NBA Impact Metrics, covering TLS certificate, Authorization, HTTPS, HSTS header and 9 more. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- Remote endpoint: https://lumahoops.org/api/mcp
- Authorisation metadata: https://lumahoops.org/.well-known/oauth-protected-resource/api/mcp
- Website: https://lumahoops.org/developers
- Changelog RSS feed: https://verifymcp.io/servers/org-lumahoops-luma/api-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/org-lumahoops-luma/api-mcp/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/org-lumahoops-luma/api-mcp.json
- HTML version of this page: https://verifymcp.io/servers/org-lumahoops-luma/api-mcp
