Back to Browse

Kingsplaybook MCP Server

Developer ToolsModerate6.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

6.2
Moderate6.2Moderate Risk

This is a well-structured MCP server for the KingsPlaybook API with proper authentication, input validation, and error handling. The server correctly enforces API key requirements, validates all inputs via Zod schemas, and implements appropriate safeguards like character limits and request timeouts. One minor finding regarding environment variable validation does not significantly impact the security posture. Supply chain analysis found 2 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.

4 files analyzed · 4 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Your kp_live_ API key from https://kingsplaybook.org/devsRequired

Environment variable: KINGSPLAYBOOK_API_KEY

Override the API base URL (default https://api.kingsplaybook.org)Optional

Environment variable: KINGSPLAYBOOK_API_URL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-kingplaybookhqadmin1-kingsplaybook-mcp": {
      "env": {
        "KINGSPLAYBOOK_API_KEY": "your-kingsplaybook-api-key-here",
        "KINGSPLAYBOOK_API_URL": "your-kingsplaybook-api-url-here"
      },
      "args": [
        "-y",
        "kingsplaybook-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub 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.):

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

Links

License

MIT

Reviews

No reviews yet

Be the first to review this server!

Kingsplaybook MCP Server - Kings Playbook sports API for AI agents: NBA/MLB/NHL | MCP Marketplace