io.github.kingplaybookHQadmin1/kingsplaybook-mcp
Kings Playbook sports API for AI agents: NBA/MLB/NHL lineups, projections, and lines.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
kingsplaybook-mcpclaude 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
{
"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>"
}
}
}
}
Variables d'environnement
KINGSPLAYBOOK_API_KEYobligatoire secret Your kp_live_ API key from https://kingsplaybook.org/devsKINGSPLAYBOOK_API_URLOverride the API base URL (default https://api.kingsplaybook.org)
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
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
License
MIT
Questions fréquentes
Qu'est-ce que io.github.kingplaybookHQadmin1/kingsplaybook-mcp ?
Kings Playbook sports API for AI agents: NBA/MLB/NHL lineups, projections, and lines.
Comment installer io.github.kingplaybookHQadmin1/kingsplaybook-mcp ?
Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.kingplaybookHQadmin1/kingsplaybook-mcp ?
Oui. Il attend KINGSPLAYBOOK_API_KEY, à renseigner dans sa configuration.
io.github.kingplaybookHQadmin1/kingsplaybook-mcp est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.kingplaybookHQadmin1/kingsplaybook-mcp ?
Il est publié par kingplaybookHQadmin1. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.