{
  "markdown": "# kingsplaybook-mcp\n\nThe official [MCP](https://modelcontextprotocol.io) server for the\n**KingsPlaybook Developer API**. It gives an AI agent — one building a\nsports-betting bot, a model, or an analytics tool — direct access to\nKingsPlaybook's data as native tools:\n\n- **Confirmed lineups** — NBA, MLB, NHL\n- **Player projections** — the projection engine's raw output\n- **Canonical game lines** — moneyline / spread / total, aggregated across books\n- **Pick-history archive** — the publicly-posted record, with results + closing lines\n\nIt's a thin local (stdio) wrapper over the [`/v1` REST API](https://kingsplaybook.org/devs).\nSame data, second protocol.\n\n## Get an API key\n\nSign up at **[kingsplaybook.org/devs](https://kingsplaybook.org/devs)**. The\nFree tier covers lineups; paid tiers add projections, lines, and history.\nYour key looks like `kp_live_…`.\n\n## Install\n\nNo install step — run it straight from npm with `npx`. Add it to your MCP\nclient config (Claude Desktop, Cursor, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"kingsplaybook\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"kingsplaybook-mcp\"],\n      \"env\": {\n        \"KINGSPLAYBOOK_API_KEY\": \"kp_live_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nThat's it — the agent now has the KingsPlaybook tools.\n\n## Tools\n\n| Tool | What it returns | Min. plan |\n|------|-----------------|-----------|\n| `kingsplaybook_get_lineups` | Confirmed lineups for a league + date | Free |\n| `kingsplaybook_get_projections` | Raw player projections for a league + date | Starter |\n| `kingsplaybook_get_lines` | Canonical game lines for a league + date | Pro |\n| `kingsplaybook_get_pick_history` | Posted picks + results for a date | Premium |\n| `kingsplaybook_get_freshness` | Per-domain data-age signal | Free |\n\nEvery tool returns JSON. Calling a tool above your plan tier returns a\nclear `403` message with an upgrade link.\n\n### Examples\n\n- *\"What's tonight's NBA slate look like?\"* → `kingsplaybook_get_lineups({ league: \"nba\", date: \"2026-05-21\" })`\n- *\"Pull MLB projections for today\"* → `kingsplaybook_get_projections({ league: \"mlb\", date: \"2026-05-21\" })`\n- *\"How did KingsPlaybook's prop picks do yesterday?\"* → `kingsplaybook_get_pick_history({ date: \"2026-05-20\", type: \"prop\" })`\n\n## Configuration\n\n| Env var | Required | Default | Purpose |\n|---------|----------|---------|---------|\n| `KINGSPLAYBOOK_API_KEY` | yes | — | Your `kp_live_` API key |\n| `KINGSPLAYBOOK_API_URL` | no | `https://api.kingsplaybook.org` | Override the API base URL |\n\n## Local development\n\n```bash\nnpm install\nnpm run build      # compile TypeScript to dist/\nnpm start          # run the built server (needs KINGSPLAYBOOK_API_KEY)\nnpm run dev        # watch mode\n```\n\n## Links\n\n- [Developer API & plans](https://kingsplaybook.org/devs)\n- [Model Context Protocol](https://modelcontextprotocol.io)\n\n## License\n\nMIT\n",
  "bytes": 2847,
  "sha": "3adb2125f4c83457edaef287807c463076b6d4db642e94eb609c5041132ccb60",
  "repo_slug": "kingplaybookhqadmin1/kingsplaybook-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_kingplaybookhqadmin1_kingsplay_d7888d4e/readme"
}