kingsplaybook-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| KINGSPLAYBOOK_API_KEY | Yes | Your kp_live API key | |
| KINGSPLAYBOOK_API_URL | No | Override the API base URL | https://api.kingsplaybook.org |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| kingsplaybook_get_lineupsA | Confirmed / projected starting lineups for every game on a given league + date, split into home and away rosters. Available on every KingsPlaybook plan, including Free. Args: league ('nba' | 'mlb' | 'nhl'), date ('YYYY-MM-DD'). Returns JSON: { data: [ { event_id, league, game_date, home_team, away_team, lineups: { home: [players], away: [players] }, updated_at } ], meta: { count, league, date, as_of } }. |
| kingsplaybook_get_projectionsA | Raw player stat projections — KingsPlaybook's model output, the projected number only — for every game on a league + date. Requires a Starter plan or higher. Args: league ('nba' | 'mlb' | 'nhl'), date ('YYYY-MM-DD'). Returns JSON: { data: [ { player_name, stat_type, line, direction, projection, league, event_id, game_date, updated_at } ], meta: { count, league, date, tier, as_of } }. |
| kingsplaybook_get_linesA | KingsPlaybook's canonical game-market lines — moneyline, spread, and total — aggregated across tracked sportsbooks, per game on a league + date. Requires a Pro plan or higher. Args: league ('nba' | 'mlb' | 'nhl'), date ('YYYY-MM-DD'). Returns JSON: { data: [ { event_id, home_team, away_team, markets: [ { market_type, selections: [ { selection, line, prices: [ { book, price, decimal } ] } ] } ] } ], meta }. |
| kingsplaybook_get_pick_historyA | KingsPlaybook's publicly-posted picks for a date — game-market and player-prop — each with its result and closing-line context. Use this to backtest against the actual posted record. Requires a Premium plan. Args: date ('YYYY-MM-DD'); optional type ('game' | 'prop', omit for both); optional sport (e.g. 'nba'). Returns JSON: { data: { game_picks: [...], prop_picks: [...] }, meta: { count, game_pick_count, prop_pick_count, date, ... } }. |
| kingsplaybook_get_freshnessA | Per-domain data-age signal — when the projection pipeline, lineups, and lines were each last updated. Check this to decide whether the data is fresh enough before acting on it. Works on any plan. Args: none. Returns JSON: { data: { snapshot: { latest_farmer_harvest_at, latest_crown_scored_at }, lineups: { latest_updated_at }, lines: { latest_updated_at } }, meta: { as_of } }. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Each tool targets a distinct data type: lineups, projections, lines, pick history, and freshness. The boundaries are clear and descriptions explicitly differentiate the content, so there is no ambiguity between tools.
All tools follow the exact pattern 'kingsplaybook_get_<resource>' using snake_case. The resource names are descriptive and consistent (lineups, projections, lines, pick_history, freshness), with no mixed conventions or vague verbs.
Five tools is well-scoped for a specialized sports data API. Each tool represents a core data category necessary for the server's purpose, with no redundancy or unnecessary additions.
The tool set covers all major data retrieval needs for a betting-focused sports data service: lineups, projections, lines, pick history, and freshness verification. For a read-only analytical domain, this is comprehensive and leaves no critical dead ends.