Shift Scheduler
v1.0.0Builds optimal 24/7 staff rosters with a real MILP solver: rest rules, skills, nights, fairness.
Endpoint health
online- Last checked
- 11/20/2026, 7:15:56 AM
- Latency
- 77 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:com.kindoflost.staff-scheduling%2Fshift-scheduler
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"com.kindoflost.staff-scheduling/shift-scheduler": {
"url": "https://staff-scheduling.kindoflost.com/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
5 shown · authentication unknown
Build an optimized shift roster
build_shift_roster
Solve a staff rostering problem to optimality with a MILP solver and return who works which shift each day, coverage, unfilled posts, hours per person and warnings. Solves take 5-60 s. Pass either `example` (to solve a built-in example as-is) or the roster input fields. If the result has status 'running', call get_shift_roster_result with its job_id. If it has status 'too_large', shorten the horizon or reduce people/shift types and retry. If it has status 'busy', wait the retry_after_seconds it gives and call again -- one call at a time, never in parallel. Safe defaults (e.g. the next 7 days when `days` is omitted) are listed in the result's `assumptions`; tell the user about them. Roster input. Minimal example: {"days": ["2026-10-05", "2026-10-06"], "shifts": [{"shift": "Day", "start": "07:00", "end": "19:00"}, {"shift": "Night", "start": "19:00", "end": "07:00", "night": "yes"}], "demands": [{"name": "RN", "penalty": 500}], "people": [{"name": "Ana", "cost": 40, "max_hw": 48}, ...], "grids": {"RN": {"2026-10-05|Day": 2, "2026-10-05|Night": 1}}, "parameters": {"MinRestHours": 11}}. Call get_shift_example for complete, realistic inputs.
Schema valid · SHA-256 012f1d41c1ad…
View input schema
{ "type": "object", "properties": { "example": { "type": "string", "enum": [ "hospital-ward", "three-shift-plant", "security-site", "fire-station", "support-desk" ], "description": "Solve this built-in example instead of passing the fields below." }, "days": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 42, "description": "OPTIONAL. Day labels in order: ISO dates ('2026-10-05') or weekday names ('Mon'). Dates or weekdays enable weekend rules. Omit it to plan the next 7 days (ISO dates starting tomorrow); the default used is reported in the result's `assumptions`." }, "shifts": { "type": "array", "minItems": 1, "maxItems": 12, "description": "Shift types. A shift may cross midnight (end < start).", "items": { "type": "object", "required": [ "shift", "start", "end" ], "properties": { "shift": { "type": "string", "description": "Shift name, e.g. 'Day'." }, "start": { "type": "string", "description": "HH:MM" }, "end": { "type": "string", "description": "HH:MM" }, "night": { "type": [ "string", "boolean" ], "description": "'yes' = counts as a night shift. Omitted = decided from NightStartsAfter." } } } }, "demands": { "type": "array", "maxItems": 12, "description": "Posts to fill (roles). Headcount per day/shift goes in grids.", "items": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string" }, "penalty": { "type": "number", "description": "Cost of leaving ONE post unfilled for one shift. Must be well above one person's pay for a shift or the solver will prefer gaps. Omitted = 10 x the highest hourly cost x the longest shift." }, "concurrent": { "type": "boolean", "description": "true = the same person may cover this and another demand at once." } } } }, "people": { "type": "array", "minItems": 1, "maxItems": 60, "items": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string" }, "cost": { "type": "number", "description": "Cost per hour (default 1)." }, "min_hd": { "type": "number", "description": "Min hours per worked day." }, "max_hd": { "type": "number", "description": "Max hours per day (default 24)." }, "min_dw": { "type": "number", "description": "Min days worked over the WHOLE roster." }, "max_dw": { "type": "number", "description": "Max days worked over the WHOLE roster." }, "min_hw": { "type": "number", "description": "Min hours over the WHOLE roster (soft)." }, "max_hw": { "type": "number", "description": "Max hours over the WHOLE roster (hard). Not per week: for a 28-day roster at 40h/week use 160." } } } }, "skills": { "type": "array", "description": "Who can cover which demand. Omitted = everyone can cover every demand.", "items": { "type": "object", "required": [ "person", "demand" ], "properties": { "person": { "type": "string" }, "demand": { "type": "string" }, "rate": { "type": "number", "description": "Posts covered per person (default 1)." } } } }, "grids": { "type": "object", "description": "Optional per-day/shift cells, keyed by a demand name or a person name, each an object keyed 'DAY|SHIFT'. Demand grid value = headcount required (demand with no grid = 1 on every shift). Person grid value: 'a' or 1 = available, 'f' = must work, 0 or missing = UNAVAILABLE (person with no grid = available everywhere).", "additionalProperties": { "type": "object" } }, "parameters": { "type": "object", "description": "Optional rules. MinRestHours (11), MaxConsecutiveDays (6), MaxConsecutiveNights (4), ForbidDayAfterNight ('yes'), NightStartsAfter ('18:00'), MinBlockDays (1), WeekendFairnessPenalty (0), EquityPenalty (0) = even out total hours, NightEquityPenalty (0) = even out total nights (try 20), NightDifferential (1.0), WeekendDifferential (1.0), TimeLimitSeconds (max 60 here), GapPercent (2)." }, "goal": { "type": "string", "maxLength": 300, "description": "One sentence, in the user's own words, of what they are trying to do (e.g. 'a 4-week nurse rota for 12 nurses on 12-hour shifts'). Optional; helps improve the tool." }, "wait_seconds": { "type": "integer", "minimum": 0, "maximum": 45, "description": "How long to wait for the solve inside this call (default 25)." } } }
Connections
streamable-http
https://staff-scheduling.kindoflost.com/mcp