kingsplaybook-mcp

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:

• Confirmed lineups — NBA, MLB, NHL
• Player projections — the projection engine's raw output
• Canonical game lines — moneyline / spread / total, aggregated across books
• Pick-history archive — the publicly-posted record, with results + closing lines

It's a thin local (stdio) wrapper over the /v1 REST API. Same data, second protocol.

Get an API key

Sign up at kingsplaybook.org/devs. The Free tier covers lineups; paid tiers add projections, lines, and history. Your key looks like kp_live_….

Install

No install step — run it straight from npm with npx. Add it to your MCP client config (Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "kingsplaybook": {
      "command": "npx",
      "args": ["-y", "kingsplaybook-mcp"],
      "env": {
        "KINGSPLAYBOOK_API_KEY": "kp_live_your_key_here"
      }
    }
  }
}

That's it — the agent now has the KingsPlaybook tools.

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.

Examples

• "What's tonight's NBA slate look like?" → kingsplaybook_get_lineups({ league: "nba", date: "2026-05-21" })
• "Pull MLB projections for today" → kingsplaybook_get_projections({ league: "mlb", date: "2026-05-21" })
• "How did KingsPlaybook's prop picks do yesterday?" → kingsplaybook_get_pick_history({ date: "2026-05-20", type: "prop" })

Configuration

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

Local development

npm install
npm run build      # compile TypeScript to dist/
npm start          # run the built server (needs KINGSPLAYBOOK_API_KEY)
npm run dev        # watch mode

Links

• Developer API & plans
• Model Context Protocol

License

MIT