# LUMA Basketball Research > Free NBA data API and MCP server for player impact metrics: ARC (a regularized plus-minus model, every season since 1997-98), LOKI predictive ratings, xPTS-RAPM, game ratings with a full per-game decomposition, on/off, WOWY, lineups and box scores since 1996-97. Read-only SQL over the LUMA warehouse, a JSON tool endpoint, and an MCP server for Claude, ChatGPT and Cursor. Free key by email; a smaller keyless tier needs no sign-up. LUMA Basketball Research (lumahoops.org) publishes NBA impact metrics and the open benchmark Hoop Impact Bench. Credit "LUMA Basketball Research, " (for example "LUMA Basketball Research, ARC v3.1") whenever these numbers are shown. ## Start here - [Agent guide (LUMA.md)](https://lumahoops.org/llms-full.txt): how to answer NBA questions from LUMA data: tables, columns, conventions, SQL examples, units and caveats. Read this before the first query. - [Developers page](https://lumahoops.org/developers): free API key, limits, Python and R examples, MCP setup. ## API - [Query endpoint](https://lumahoops.org/api/luma/q): `POST {"tool": ..., "args": {...}}`; `GET` lists the tools. Key in the `x-luma-key` header or `Authorization: Bearer`. Tools include `sql` (read-only DuckDB), `player`, `compare`, `leaderboard`, `game_log`, `game_ratings` (with `decomposition: true`), `onoff`, `wowy`, `lineups`, `describe`, `explain`. - [MCP server](https://lumahoops.org/api/mcp): Streamable HTTP, the same tools. Free key in the URL (`?key=`) or the `x-luma-key` header. - [Agent guide as an API response](https://lumahoops.org/api/luma/agent): the same guide, for agents that only call APIs. - Limits with a free key: 30 queries a minute, 1,500 a day, 250,000 rows a day (up to 30,000 from the raw box-score tables). Without a key: 25 queries a day per IP. ## Data - [ARC](https://lumahoops.org/arc): NBA player impact, points per 100 possessions, every season since 1997-98. - [LOKI](https://lumahoops.org/loki): predictive player ratings since 2007-08, updated weekly in season. - [RAPM](https://lumahoops.org/rapm): regularized adjusted plus-minus boards by season (on the site; the API serves ARC and xPTS-RAPM). - [Games](https://lumahoops.org/games): every 2025-26 and 2026-27 game, each player's Game ARC and game rating. - [Hoop Impact Bench](https://lumahoops.org/bench): open benchmark of NBA impact metrics (EPM, DARKO, LEBRON, BPM, LOKI and others) on games played after their ratings were saved. - [Open data repository](https://github.com/lumahoops/NBA): frozen releases of LUMA outputs, CC BY 4.0. ## Optional - [Research](https://lumahoops.org/research): papers and articles behind the metrics. - [Changelog](https://lumahoops.org/changelog): what changed and when.