Builds MLB, NFL, NHL and NBA DFS lineups with a real optimizer: cap, stacks, exposure. Free.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Build up to 20 lineups for a Classic contest. Pass `example` (a sample slate) or `players` (the site's salary CSV text, or a list of player objects for DraftKings). Returns each lineup with its players, slots, salary and projected points, player exposure, notes about what defaults were applied, and `upload_csv`: a DraftKings/FanDuel/Yahoo upload-ready CSV string. Takes 2-60 s; if the result has status 'running', call get_lineup_result with the job_id. Lineups are optimal for the PROJECTIONS used, not predictions of results.
Contest site (default dk). 'players' as a list works for dk only; fd and yahoo need the site's raw CSV text.
Sport-specific rules, using the web app's option names. Each is tagged with the sports it applies to; a rule for another sport is an error. get_lineup_example(sport) lists the ones for that sport.
Use a bundled sample slate instead of players (names from list_lineup_examples, or just the sport). Live lookups are skipped.
EITHER the raw salary CSV text exactly as exported from the contest site (DraftKings 'Download players' / FanDuel players list / Yahoo export; a Classic contest), OR a list of player objects (site dk only).
Lineups to build (default 10, max 20: diversity cuts make each extra lineup slower and the free server is small).
Lineups must spend at least this much.
Your own projections as {player name or id: points}; overrides the file's AvgPointsPerGame for those players. Names are matched case-insensitively.
NHL line combos / starting goalies and MLB batting orders / probable pitchers from the public sites the web page uses (default false: skipped; sample slates always skip). Can fail or be slow; a failure is reported, the solve still runs.
Players (name or id) that must be in every lineup.
How long to wait inside this call (default 25).
Players (name or id) to leave out.
Any one player may appear in at most this % of the lineups (100 = no cap).
Drop players the file marks OUT/IL (default true, as the web page does).
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http dfs-lineup-optimizer https://nhl-lineup-optimizer.kindoflost.com/mcp
Build up to 20 lineups for a Classic contest. Pass `example` (a sample slate) or `players` (the site's salary CSV text, or a list of player objects for DraftKings). Returns each lineup with its players, slots, salary and projected points, player exposure, notes about what defaults were applied, and `upload_csv`: a DraftKings/FanDuel/Yahoo upload-ready CSV string. Takes 2-60 s; if the result has status 'running', call get_lineup_result with the job_id. Lineups are optimal for the PROJECTIONS used, not predictions of results.
| Argument | Type | Description |
|---|---|---|
| site | string | Contest site (default dk). 'players' as a list works for dk only; fd and yahoo need the site's raw CSV text. |
| rules | object | Sport-specific rules, using the web app's option names. Each is tagged with the sports it applies to; a rule for another sport is an error. get_lineup_example(sport) lists the ones for that sport. |
| sport* | string | |
| example | string | Use a bundled sample slate instead of players (names from list_lineup_examples, or just the sport). Live lookups are skipped. |
| players | any | EITHER the raw salary CSV text exactly as exported from the contest site (DraftKings 'Download players' / FanDuel players list / Yahoo export; a Classic contest), OR a list of player objects (site dk only). |
| n_lineups | integer | Lineups to build (default 10, max 20: diversity cuts make each extra lineup slower and the free server is small). |
| min_salary | integer | Lineups must spend at least this much. |
| projections | object | Your own projections as {player name or id: points}; overrides the file's AvgPointsPerGame for those players. Names are matched case-insensitively. |
| live_lookups | boolean | NHL line combos / starting goalies and MLB batting orders / probable pitchers from the public sites the web page uses (default false: skipped; sample slates always skip). Can fail or be slow; a failure is reported, the solve still runs. |
| lock_players | array | Players (name or id) that must be in every lineup. |
| wait_seconds | integer | How long to wait inside this call (default 25). |
| exclude_players | array | Players (name or id) to leave out. |
| max_exposure_pct | integer | Any one player may appear in at most this % of the lineups (100 = no cap). |
| exclude_out_players | boolean | Drop players the file marks OUT/IL (default true, as the web page does). |
{
"type": "object",
"required": [
"sport"
],
"properties": {
"site": {
"enum": [
"dk",
"fd",
"yahoo"
],
"type": "string",
"description": "Contest site (default dk). 'players' as a list works for dk only; fd and yahoo need the site's raw CSV text."
},
"rules": {
"type": "object",
"properties": {
"preset": {
"enum": [
"gpp",
"cash"
],
"type": "string",
"description": "[NHL/NFL] Rule preset (default gpp)."
},
"stacks": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "integer"
},
"maxItems": 2,
"minItems": 2
},
"description": "[NHL] Stack classes as [[n_units, players_each], ...], e.g. [[2,3]] = two 3-man line stacks."
},
"stack_pp": {
"type": "boolean",
"description": "[NHL] Power-play units count as stack units (default false; much slower)."
},
"min_teams": {
"type": "integer",
"maximum": 9,
"minimum": 0,
"description": "[NFL/NBA] Min distinct teams."
},
"util_no_d": {
"type": "boolean",
"description": "[NHL] DraftKings: UTIL may not be a defenseman."
},
"bring_back": {
"type": "integer",
"maximum": 2,
"minimum": 0,
"description": "[NFL] Players from the QB's opponent."
},
"cool_top_k": {
"type": "integer",
"maximum": 3,
"minimum": 0,
"description": "[NHL/NFL/NBA/MLB] Rest the K most-used players in each lineup (0 = off)."
},
"d_pp1_only": {
"type": "boolean",
"description": "[NHL] Defensemen only from the first power-play unit."
},
"strategies": {
"type": "array",
"items": {
"type": "object"
},
"description": "[NHL] Pattern mix [{name, share}]; names: lineD_lineG_D, lineD_lineD_G, lineD_lineD_SAMEGAME_G, line_lineG_DD_different_games."
},
"overlap_cap": {
"type": [
"integer",
"null"
],
"description": "[NHL/NFL/NBA/MLB] Max players a new lineup may share with ANY earlier lineup."
},
"qb_stack_rb": {
"type": "integer",
"maximum": 1,
"minimum": 0,
"description": "[NFL] RBs from the QB's team."
},
"qb_stack_te": {
"type": "integer",
"maximum": 1,
"minimum": 0,
"description": "[NFL] TEs from the QB's team."
},
"qb_stack_wr": {
"type": "integer",
"maximum": 3,
"minimum": 0,
"description": "[NFL] WRs from the QB's team."
},
"stack_lines": {
"type": "boolean",
"description": "[NHL] Forward lines / D pairings count as stack units (default true)."
},
"qb_stack_any": {
"type": "integer",
"maximum": 4,
"minimum": 0,
"description": "[NFL] Pass-catchers (WR/TE) from the QB's team in the lineup."
},
"enforce_stack": {
"type": "boolean",
"description": "[NHL/NFL/MLB] Require the stacks."
},
"primary_stack": {
"type": "integer",
"maximum": 6,
"minimum": 0,
"description": "[MLB] Hitters from the primary stack team (default 4)."
},
"starters_only": {
"type": "boolean",
"description": "[MLB] Only probable starting pitchers when the file marks them (default true)."
},
"pitcher_rotate": {
"type": "boolean",
"description": "[MLB] Rotate pitchers across lineups (default true)."
},
"skill_core_cap": {
"type": [
"integer",
"null"
],
"description": "[NFL] Max shared skill players with any earlier lineup."
},
"user_max_games": {
"type": "integer",
"maximum": 8,
"minimum": 0,
"description": "[NBA] Max distinct games (0 = off)."
},
"user_max_teams": {
"type": "integer",
"maximum": 8,
"minimum": 0,
"description": "[NBA] Max distinct teams (0 = off)."
},
"user_min_games": {
"type": "integer",
"maximum": 8,
"minimum": 0,
"description": "[NBA] Min distinct games (0 = off)."
},
"user_min_teams": {
"type": [
"integer",
"null"
],
"description": "[MLB] Min distinct teams."
},
"cooldown_window": {
"type": "integer",
"maximum": 10,
"minimum": 0,
"description": "[NHL/NFL/NBA/MLB] Players used in the last K lineups sit out the next lineup."
},
"max_rb_per_team": {
"type": [
"integer",
"null"
],
"description": "[NFL] Max RBs from one team."
},
"max_wr_per_team": {
"type": [
"integer",
"null"
],
"description": "[NFL] Max WRs from one team."
},
"secondary_stack": {
"type": "integer",
"maximum": 6,
"minimum": 0,
"description": "[MLB] Hitters from a second stack team (default 0 = none)."
},
"build_around_qbs": {
"type": "array",
"items": {
"type": "string"
},
"description": "[NFL] QB names/ids; the batch is split evenly between them, each locked in."
},
"forward_core_cap": {
"type": [
"integer",
"null"
],
"description": "[NHL] Max shared forwards with any earlier lineup."
},
"min_skater_teams": {
"type": "integer",
"maximum": 9,
"minimum": 0,
"description": "[NHL] Min distinct skater teams."
},
"passing_core_cap": {
"type": [
"integer",
"null"
],
"description": "[NFL] Max shared QB + pass-catchers with any earlier lineup."
},
"qb_rotate_window": {
"type": "integer",
"maximum": 10,
"minimum": 0,
"description": "[NFL] Do not reuse a QB within the last K lineups."
},
"unit_overlap_cap": {
"type": [
"integer",
"null"
],
"description": "[NHL] Max stack units shared with any earlier lineup (default 1)."
},
"dst_vs_qb_exclude": {
"type": "boolean",
"description": "[NFL] No defense facing your QB."
},
"goalie_overlap_cap": {
"type": [
"integer",
"null"
],
"description": "[NHL] Max goalie-side overlap with any earlier lineup."
},
"min_unique_players": {
"type": "integer",
"maximum": 3,
"minimum": 1,
"description": "[NHL/NFL/NBA/MLB] Each lineup needs at least this many players not in any earlier lineup."
},
"min_unique_skaters": {
"type": "integer",
"maximum": 8,
"minimum": 0,
"description": "[NHL] Skaters in each lineup that no earlier lineup used."
},
"consecutive_primary": {
"type": "boolean",
"description": "[MLB] Primary stack must be consecutive in the batting order (needs orders)."
},
"build_around_goalies": {
"type": "array",
"items": {
"type": "string"
},
"description": "[NHL] Goalie names/ids; the batch is split evenly between them, each locked in."
},
"max_players_per_team": {
"type": "integer",
"maximum": 9,
"minimum": 1,
"description": "[NHL/NFL/NBA] Max players from one team."
},
"no_skaters_vs_goalie": {
"type": "boolean",
"description": "[NHL] No skater facing your goalie (the goalie-vs-skater rule)."
},
"pitcher_oppo_exclude": {
"type": "boolean",
"description": "[MLB] No hitters facing your pitcher (default true)."
},
"stack_teams_distinct": {
"type": "boolean",
"description": "[NHL] Each stack from a different team."
},
"build_around_pitchers": {
"type": "array",
"items": {
"type": "string"
},
"description": "[MLB] Pitcher names/ids; the batch is split evenly between them, each locked in."
},
"consecutive_secondary": {
"type": "boolean",
"description": "[MLB] Same for the secondary stack."
},
"declared_batters_only": {
"type": "boolean",
"description": "[MLB] Only hitters with a confirmed batting order (needs orders; default false)."
},
"declared_skaters_only": {
"type": "boolean",
"description": "[NHL] Only skaters on a line or power play."
},
"max_forwards_per_team": {
"type": [
"integer",
"null"
],
"description": "[NHL] Max forwards from one team."
},
"stack_cooldown_window": {
"type": "integer",
"maximum": 10,
"minimum": 0,
"description": "[NHL/NFL/MLB] Teams stacked in the last K lineups are not stacked again."
},
"goalie_needs_own_stack": {
"type": "boolean",
"description": "[NHL] Your goalie's team must supply a stack."
},
"max_stack_exposure_pct": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "[NHL/NFL/MLB] Max % of lineups any one team may be the stack team (100 = no cap)."
},
"confirmed_starters_only": {
"type": "boolean",
"description": "[NHL] Only goalies marked as the starter (Line=1 / Starting)."
},
"dst_vs_attacker_exclude": {
"type": "boolean",
"description": "[NFL] No skill player facing your defense."
},
"user_max_players_per_team": {
"type": [
"integer",
"null"
],
"description": "[MLB] Max players from one team."
}
},
"description": "Sport-specific rules, using the web app's option names. Each is tagged with the sports it applies to; a rule for another sport is an error. get_lineup_example(sport) lists the ones for that sport.",
"additionalProperties": false
},
"sport": {
"enum": [
"nhl",
"nfl",
"nba",
"mlb"
],
"type": "string"
},
"example": {
"type": "string",
"description": "Use a bundled sample slate instead of players (names from list_lineup_examples, or just the sport). Live lookups are skipped."
},
"players": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"position",
"team",
"salary"
],
"properties": {
"id": {
"type": "string",
"description": "Site player id (the number in 'Name (id)'). Default: name."
},
"pp": {
"type": "integer",
"description": "NHL only: power-play unit 1-2."
},
"line": {
"type": "integer",
"description": "NHL only: forward line 1-4 / D pair 1-3; on a goalie, 1 = confirmed starter."
},
"name": {
"type": "string"
},
"team": {
"type": "string",
"description": "Team abbreviation."
},
"salary": {
"type": "integer"
},
"status": {
"type": "string",
"description": "Injury status code as the site shows it (Q, O, IL...). 'O'/'OUT'/'IL' players are excluded."
},
"opponent": {
"type": "string",
"description": "Opponent team abbreviation. Needed for rules that look at the opponent (goalie-vs-skater, bring-back, pitcher-vs-hitters, game counts)."
},
"position": {
"type": "string",
"description": "Site position, e.g. 'C', 'LW', 'SP', '1B/OF', 'PG/SG', 'RB', 'DST'."
},
"projection": {
"type": "number",
"description": "Your projected fantasy points. A player list has no site AvgPointsPerGame to fall back on, so every player needs this unless the top-level `projections` map covers them."
}
}
}
}
],
"description": "EITHER the raw salary CSV text exactly as exported from the contest site (DraftKings 'Download players' / FanDuel players list / Yahoo export; a Classic contest), OR a list of player objects (site dk only)."
},
"n_lineups": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Lineups to build (default 10, max 20: diversity cuts make each extra lineup slower and the free server is small)."
},
"min_salary": {
"type": "integer",
"minimum": 0,
"description": "Lineups must spend at least this much."
},
"projections": {
"type": "object",
"description": "Your own projections as {player name or id: points}; overrides the file's AvgPointsPerGame for those players. Names are matched case-insensitively.",
"additionalProperties": {
"type": "number"
}
},
"live_lookups": {
"type": "boolean",
"description": "NHL line combos / starting goalies and MLB batting orders / probable pitchers from the public sites the web page uses (default false: skipped; sample slates always skip). Can fail or be slow; a failure is reported, the solve still runs."
},
"lock_players": {
"type": "array",
"items": {
"type": "string"
},
"description": "Players (name or id) that must be in every lineup."
},
"wait_seconds": {
"type": "integer",
"maximum": 45,
"minimum": 0,
"description": "How long to wait inside this call (default 25)."
},
"exclude_players": {
"type": "array",
"items": {
"type": "string"
},
"description": "Players (name or id) to leave out."
},
"max_exposure_pct": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Any one player may appear in at most this % of the lineups (100 = no cap)."
},
"exclude_out_players": {
"type": "boolean",
"description": "Drop players the file marks OUT/IL (default true, as the web page does)."
}
}
}Validate a build_lineups request WITHOUT solving: arguments, rule names and ranges, that the players parse, that locks/exclusions/projection names match real players, and that every roster slot has enough eligible players. Takes the same arguments as build_lineups. Fast.
| Argument | Type | Description |
|---|---|---|
| site | string | Contest site (default dk). 'players' as a list works for dk only; fd and yahoo need the site's raw CSV text. |
| rules | object | Sport-specific rules, using the web app's option names. Each is tagged with the sports it applies to; a rule for another sport is an error. get_lineup_example(sport) lists the ones for that sport. |
| sport* | string | |
| example | string | Use a bundled sample slate instead of players (names from list_lineup_examples, or just the sport). Live lookups are skipped. |
| players | any | EITHER the raw salary CSV text exactly as exported from the contest site (DraftKings 'Download players' / FanDuel players list / Yahoo export; a Classic contest), OR a list of player objects (site dk only). |
| n_lineups | integer | Lineups to build (default 10, max 20: diversity cuts make each extra lineup slower and the free server is small). |
| min_salary |
Return a ready-to-run build_lineups request for a sport using its bundled sample slate, a short preview of the slate, the player-list format, and the rules available for that sport.
| Argument | Type | Description |
|---|---|---|
| sport* | string |
{
"type": "object",
"required": [
"sport"
],
"properties": {
"sport": {
"enum": [
"nhl",
"nfl",
"nba",
"mlb"
],
"type": "string"
}
},
"additionalProperties": false
}Fetch the result of a build_lineups job that returned status 'running'. Waits up to wait_seconds; call again while status is 'running'. Jobs expire 15 minutes after they finish.
| Argument | Type | Description |
|---|---|---|
| job_id* | string | |
| wait_seconds | integer |
{
"type": "object",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string"
},
"wait_seconds": {
"type": "integer",
"maximum": 45,
"minimum": 0
}
},
"additionalProperties": false
}List the bundled sample slates, one per sport (real past DraftKings Classic slates). Each can be built as-is with build_lineups(example=...).
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 17, 2026.
| integer |
| Lineups must spend at least this much. |
| projections | object | Your own projections as {player name or id: points}; overrides the file's AvgPointsPerGame for those players. Names are matched case-insensitively. |
| live_lookups | boolean | NHL line combos / starting goalies and MLB batting orders / probable pitchers from the public sites the web page uses (default false: skipped; sample slates always skip). Can fail or be slow; a failure is reported, the solve still runs. |
| lock_players | array | Players (name or id) that must be in every lineup. |
| exclude_players | array | Players (name or id) to leave out. |
| max_exposure_pct | integer | Any one player may appear in at most this % of the lineups (100 = no cap). |
| exclude_out_players | boolean | Drop players the file marks OUT/IL (default true, as the web page does). |
{
"type": "object",
"required": [
"sport"
],
"properties": {
"site": {
"enum": [
"dk",
"fd",
"yahoo"
],
"type": "string",
"description": "Contest site (default dk). 'players' as a list works for dk only; fd and yahoo need the site's raw CSV text."
},
"rules": {
"type": "object",
"properties": {
"preset": {
"enum": [
"gpp",
"cash"
],
"type": "string",
"description": "[NHL/NFL] Rule preset (default gpp)."
},
"stacks": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "integer"
},
"maxItems": 2,
"minItems": 2
},
"description": "[NHL] Stack classes as [[n_units, players_each], ...], e.g. [[2,3]] = two 3-man line stacks."
},
"stack_pp": {
"type": "boolean",
"description": "[NHL] Power-play units count as stack units (default false; much slower)."
},
"min_teams": {
"type": "integer",
"maximum": 9,
"minimum": 0,
"description": "[NFL/NBA] Min distinct teams."
},
"util_no_d": {
"type": "boolean",
"description": "[NHL] DraftKings: UTIL may not be a defenseman."
},
"bring_back": {
"type": "integer",
"maximum": 2,
"minimum": 0,
"description": "[NFL] Players from the QB's opponent."
},
"cool_top_k": {
"type": "integer",
"maximum": 3,
"minimum": 0,
"description": "[NHL/NFL/NBA/MLB] Rest the K most-used players in each lineup (0 = off)."
},
"d_pp1_only": {
"type": "boolean",
"description": "[NHL] Defensemen only from the first power-play unit."
},
"strategies": {
"type": "array",
"items": {
"type": "object"
},
"description": "[NHL] Pattern mix [{name, share}]; names: lineD_lineG_D, lineD_lineD_G, lineD_lineD_SAMEGAME_G, line_lineG_DD_different_games."
},
"overlap_cap": {
"type": [
"integer",
"null"
],
"description": "[NHL/NFL/NBA/MLB] Max players a new lineup may share with ANY earlier lineup."
},
"qb_stack_rb": {
"type": "integer",
"maximum": 1,
"minimum": 0,
"description": "[NFL] RBs from the QB's team."
},
"qb_stack_te": {
"type": "integer",
"maximum": 1,
"minimum": 0,
"description": "[NFL] TEs from the QB's team."
},
"qb_stack_wr": {
"type": "integer",
"maximum": 3,
"minimum": 0,
"description": "[NFL] WRs from the QB's team."
},
"stack_lines": {
"type": "boolean",
"description": "[NHL] Forward lines / D pairings count as stack units (default true)."
},
"qb_stack_any": {
"type": "integer",
"maximum": 4,
"minimum": 0,
"description": "[NFL] Pass-catchers (WR/TE) from the QB's team in the lineup."
},
"enforce_stack": {
"type": "boolean",
"description": "[NHL/NFL/MLB] Require the stacks."
},
"primary_stack": {
"type": "integer",
"maximum": 6,
"minimum": 0,
"description": "[MLB] Hitters from the primary stack team (default 4)."
},
"starters_only": {
"type": "boolean",
"description": "[MLB] Only probable starting pitchers when the file marks them (default true)."
},
"pitcher_rotate": {
"type": "boolean",
"description": "[MLB] Rotate pitchers across lineups (default true)."
},
"skill_core_cap": {
"type": [
"integer",
"null"
],
"description": "[NFL] Max shared skill players with any earlier lineup."
},
"user_max_games": {
"type": "integer",
"maximum": 8,
"minimum": 0,
"description": "[NBA] Max distinct games (0 = off)."
},
"user_max_teams": {
"type": "integer",
"maximum": 8,
"minimum": 0,
"description": "[NBA] Max distinct teams (0 = off)."
},
"user_min_games": {
"type": "integer",
"maximum": 8,
"minimum": 0,
"description": "[NBA] Min distinct games (0 = off)."
},
"user_min_teams": {
"type": [
"integer",
"null"
],
"description": "[MLB] Min distinct teams."
},
"cooldown_window": {
"type": "integer",
"maximum": 10,
"minimum": 0,
"description": "[NHL/NFL/NBA/MLB] Players used in the last K lineups sit out the next lineup."
},
"max_rb_per_team": {
"type": [
"integer",
"null"
],
"description": "[NFL] Max RBs from one team."
},
"max_wr_per_team": {
"type": [
"integer",
"null"
],
"description": "[NFL] Max WRs from one team."
},
"secondary_stack": {
"type": "integer",
"maximum": 6,
"minimum": 0,
"description": "[MLB] Hitters from a second stack team (default 0 = none)."
},
"build_around_qbs": {
"type": "array",
"items": {
"type": "string"
},
"description": "[NFL] QB names/ids; the batch is split evenly between them, each locked in."
},
"forward_core_cap": {
"type": [
"integer",
"null"
],
"description": "[NHL] Max shared forwards with any earlier lineup."
},
"min_skater_teams": {
"type": "integer",
"maximum": 9,
"minimum": 0,
"description": "[NHL] Min distinct skater teams."
},
"passing_core_cap": {
"type": [
"integer",
"null"
],
"description": "[NFL] Max shared QB + pass-catchers with any earlier lineup."
},
"qb_rotate_window": {
"type": "integer",
"maximum": 10,
"minimum": 0,
"description": "[NFL] Do not reuse a QB within the last K lineups."
},
"unit_overlap_cap": {
"type": [
"integer",
"null"
],
"description": "[NHL] Max stack units shared with any earlier lineup (default 1)."
},
"dst_vs_qb_exclude": {
"type": "boolean",
"description": "[NFL] No defense facing your QB."
},
"goalie_overlap_cap": {
"type": [
"integer",
"null"
],
"description": "[NHL] Max goalie-side overlap with any earlier lineup."
},
"min_unique_players": {
"type": "integer",
"maximum": 3,
"minimum": 1,
"description": "[NHL/NFL/NBA/MLB] Each lineup needs at least this many players not in any earlier lineup."
},
"min_unique_skaters": {
"type": "integer",
"maximum": 8,
"minimum": 0,
"description": "[NHL] Skaters in each lineup that no earlier lineup used."
},
"consecutive_primary": {
"type": "boolean",
"description": "[MLB] Primary stack must be consecutive in the batting order (needs orders)."
},
"build_around_goalies": {
"type": "array",
"items": {
"type": "string"
},
"description": "[NHL] Goalie names/ids; the batch is split evenly between them, each locked in."
},
"max_players_per_team": {
"type": "integer",
"maximum": 9,
"minimum": 1,
"description": "[NHL/NFL/NBA] Max players from one team."
},
"no_skaters_vs_goalie": {
"type": "boolean",
"description": "[NHL] No skater facing your goalie (the goalie-vs-skater rule)."
},
"pitcher_oppo_exclude": {
"type": "boolean",
"description": "[MLB] No hitters facing your pitcher (default true)."
},
"stack_teams_distinct": {
"type": "boolean",
"description": "[NHL] Each stack from a different team."
},
"build_around_pitchers": {
"type": "array",
"items": {
"type": "string"
},
"description": "[MLB] Pitcher names/ids; the batch is split evenly between them, each locked in."
},
"consecutive_secondary": {
"type": "boolean",
"description": "[MLB] Same for the secondary stack."
},
"declared_batters_only": {
"type": "boolean",
"description": "[MLB] Only hitters with a confirmed batting order (needs orders; default false)."
},
"declared_skaters_only": {
"type": "boolean",
"description": "[NHL] Only skaters on a line or power play."
},
"max_forwards_per_team": {
"type": [
"integer",
"null"
],
"description": "[NHL] Max forwards from one team."
},
"stack_cooldown_window": {
"type": "integer",
"maximum": 10,
"minimum": 0,
"description": "[NHL/NFL/MLB] Teams stacked in the last K lineups are not stacked again."
},
"goalie_needs_own_stack": {
"type": "boolean",
"description": "[NHL] Your goalie's team must supply a stack."
},
"max_stack_exposure_pct": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "[NHL/NFL/MLB] Max % of lineups any one team may be the stack team (100 = no cap)."
},
"confirmed_starters_only": {
"type": "boolean",
"description": "[NHL] Only goalies marked as the starter (Line=1 / Starting)."
},
"dst_vs_attacker_exclude": {
"type": "boolean",
"description": "[NFL] No skill player facing your defense."
},
"user_max_players_per_team": {
"type": [
"integer",
"null"
],
"description": "[MLB] Max players from one team."
}
},
"description": "Sport-specific rules, using the web app's option names. Each is tagged with the sports it applies to; a rule for another sport is an error. get_lineup_example(sport) lists the ones for that sport.",
"additionalProperties": false
},
"sport": {
"enum": [
"nhl",
"nfl",
"nba",
"mlb"
],
"type": "string"
},
"example": {
"type": "string",
"description": "Use a bundled sample slate instead of players (names from list_lineup_examples, or just the sport). Live lookups are skipped."
},
"players": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"position",
"team",
"salary"
],
"properties": {
"id": {
"type": "string",
"description": "Site player id (the number in 'Name (id)'). Default: name."
},
"pp": {
"type": "integer",
"description": "NHL only: power-play unit 1-2."
},
"line": {
"type": "integer",
"description": "NHL only: forward line 1-4 / D pair 1-3; on a goalie, 1 = confirmed starter."
},
"name": {
"type": "string"
},
"team": {
"type": "string",
"description": "Team abbreviation."
},
"salary": {
"type": "integer"
},
"status": {
"type": "string",
"description": "Injury status code as the site shows it (Q, O, IL...). 'O'/'OUT'/'IL' players are excluded."
},
"opponent": {
"type": "string",
"description": "Opponent team abbreviation. Needed for rules that look at the opponent (goalie-vs-skater, bring-back, pitcher-vs-hitters, game counts)."
},
"position": {
"type": "string",
"description": "Site position, e.g. 'C', 'LW', 'SP', '1B/OF', 'PG/SG', 'RB', 'DST'."
},
"projection": {
"type": "number",
"description": "Your projected fantasy points. A player list has no site AvgPointsPerGame to fall back on, so every player needs this unless the top-level `projections` map covers them."
}
}
}
}
],
"description": "EITHER the raw salary CSV text exactly as exported from the contest site (DraftKings 'Download players' / FanDuel players list / Yahoo export; a Classic contest), OR a list of player objects (site dk only)."
},
"n_lineups": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Lineups to build (default 10, max 20: diversity cuts make each extra lineup slower and the free server is small)."
},
"min_salary": {
"type": "integer",
"minimum": 0,
"description": "Lineups must spend at least this much."
},
"projections": {
"type": "object",
"description": "Your own projections as {player name or id: points}; overrides the file's AvgPointsPerGame for those players. Names are matched case-insensitively.",
"additionalProperties": {
"type": "number"
}
},
"live_lookups": {
"type": "boolean",
"description": "NHL line combos / starting goalies and MLB batting orders / probable pitchers from the public sites the web page uses (default false: skipped; sample slates always skip). Can fail or be slow; a failure is reported, the solve still runs."
},
"lock_players": {
"type": "array",
"items": {
"type": "string"
},
"description": "Players (name or id) that must be in every lineup."
},
"exclude_players": {
"type": "array",
"items": {
"type": "string"
},
"description": "Players (name or id) to leave out."
},
"max_exposure_pct": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Any one player may appear in at most this % of the lineups (100 = no cap)."
},
"exclude_out_players": {
"type": "boolean",
"description": "Drop players the file marks OUT/IL (default true, as the web page does)."
}
}
}