The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Kingsplaybook MCP listing page.
The official MCP server for the KingsPlaybook Developer API. It gives an AI agent — one building a sports-betting bot, a model, or an analytics tool — direct access to KingsPlaybook's data as native tools:
It's a thin local (stdio) wrapper over the /v1 REST API.
Same data, second protocol.
Sign up at kingsplaybook.org/devs. The
Free tier covers lineups; paid tiers add projections, lines, and history.
Your key looks like kp_live_….
No install step — run it straight from npm with npx. Add it to your MCP
client config (Claude Desktop, Cursor, etc.):
That's it — the agent now has the KingsPlaybook tools.
| Tool | What it returns | Min. plan |
|---|---|---|
kingsplaybook_get_lineups | Confirmed lineups for a league + date | Free |
kingsplaybook_get_projections | Raw player projections for a league + date | Starter |
kingsplaybook_get_lines | Canonical game lines for a league + date | Pro |
kingsplaybook_get_pick_history | Posted picks + results for a date | Premium |
kingsplaybook_get_freshness | Per-domain data-age signal | Free |
Every tool returns JSON. Calling a tool above your plan tier returns a
clear 403 message with an upgrade link.
kingsplaybook_get_lineups({ league: "nba", date: "2026-05-21" })kingsplaybook_get_projections({ league: "mlb", date: "2026-05-21" })kingsplaybook_get_pick_history({ date: "2026-05-20", type: "prop" })| Env var | Required | Default | Purpose |
|---|---|---|---|
KINGSPLAYBOOK_API_KEY | yes | — | Your kp_live_ API key |
KINGSPLAYBOOK_API_URL | no | https://api.kingsplaybook.org | Override the API base URL |
MIT