English Français العربية

io.github.kingplaybookHQadmin1/kingsplaybook-mcp

Official registry Archived Games, sports and entertainment

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package kingsplaybook-mcp
Claude Code 
claude mcp add kingsplaybook-mcp -e 'KINGSPLAYBOOK_API_KEY=<your kingsplaybook_api_key>' -e 'KINGSPLAYBOOK_API_URL=<KINGSPLAYBOOK_API_URL>' -- npx -y kingsplaybook-mcp@0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "kingsplaybook-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "kingsplaybook-mcp@0.1.0"
            ],
            "env": {
                "KINGSPLAYBOOK_API_KEY": "<your kingsplaybook_api_key>",
                "KINGSPLAYBOOK_API_URL": "<KINGSPLAYBOOK_API_URL>"
            }
        }
    }
}

Environment variables

  • KINGSPLAYBOOK_API_KEY required secret Your kp_live_ API key from https://kingsplaybook.org/devs
  • KINGSPLAYBOOK_API_URL Override the API base URL (default https://api.kingsplaybook.org)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. kingsplaybook-mcp
  2. Get an API key
  3. Install
  4. Tools
  5. Configuration
  6. Local development
  7. Links
  8. License

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

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

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

License

MIT

Frequently asked questions

What is io.github.kingplaybookHQadmin1/kingsplaybook-mcp?

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

How do I install io.github.kingplaybookHQadmin1/kingsplaybook-mcp?

It runs on your machine. In Claude Code: claude mcp add kingsplaybook-mcp -e 'KINGSPLAYBOOK_API_KEY=<your kingsplaybook_api_key>' -e 'KINGSPLAYBOOK_API_URL=<KINGSPLAYBOOK_API_URL>' -- npx -y kingsplaybook-mcp@0.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.kingplaybookHQadmin1/kingsplaybook-mcp need an API key?

Yes. It expects KINGSPLAYBOOK_API_KEY, which you set in its configuration.

Is io.github.kingplaybookHQadmin1/kingsplaybook-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.kingplaybookHQadmin1/kingsplaybook-mcp?

It is published by kingplaybookHQadmin1. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.