Kingsplaybook Mcp

io.github.kingplaybookHQadmin1Published by GitHub account kingplaybookHQadmin1v0.1.0Updated Oct 24, 2026

Kings Playbook sports API for AI agents: NBA/MLB/NHL lineups, projections, and lines.

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

Local MCP server that gives an AI assistant KingsPlaybook sports data: NBA, MLB and NHL lineups, player projections, game lines and pick history.

What you can do
Retrieve confirmed lineups for a league and date (NBA, MLB, NHL). Fetch raw player projections from the projection engine. Get canonical game lines (moneyline, spread, total) aggregated across books. Look up the posted pick-history archive with results and closing lines. Check per-domain data freshness.
When to use it
Useful when building or running a sports-betting bot, model or analytics tool that needs lineups, projections, lines or historical picks for a given league and date, and you already have a KingsPlaybook API key.
Requirements
Runs locally over stdio, typically launched with npx from the npm package kingsplaybook-mcp; Node.js is needed. Requires a KingsPlaybook API key in the KINGSPLAYBOOK_API_KEY environment variable, obtained by signing up at the developer site. Network access to the KingsPlaybook API; KINGSPLAYBOOK_API_URL can override the default base URL. Plan tier determines which tools work.
Before you install
Requires a secret API key (KINGSPLAYBOOK_API_KEY) that must be kept out of shared configs. Free tier covers only lineups; projections, lines and pick history need paid tiers, and calls above your plan return a 403 with an upgrade link. Queries and the key are sent to the KingsPlaybook API. Data is read-only; no write or delete actions are described.

Installation

In SourceWeft

  1. Open Kingsplaybook Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

json
{  "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

ToolWhat it returnsMin. plan
kingsplaybook_get_lineupsConfirmed lineups for a league + dateFree
kingsplaybook_get_projectionsRaw player projections for a league + dateStarter
kingsplaybook_get_linesCanonical game lines for a league + datePro
kingsplaybook_get_pick_historyPosted picks + results for a datePremium
kingsplaybook_get_freshnessPer-domain data-age signalFree

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 varRequiredDefaultPurpose
KINGSPLAYBOOK_API_KEYyes—Your kp_live_ API key
KINGSPLAYBOOK_API_URLnohttps://api.kingsplaybook.orgOverride the API base URL

Local development

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

Links

License

MIT

Source: README.md at commit 37716c5

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts