{"data":{"name":"com.kindoflost.staff-scheduling/shift-scheduler","title":"Shift Scheduler","description":"Builds optimal 24/7 staff rosters with a real MILP solver: rest rules, skills, nights, fairness.","version":"1.0.0","websiteUrl":"https://staff-scheduling.kindoflost.com/mcp-server","repositoryUrl":null,"remotes":[{"url":"https://staff-scheduling.kindoflost.com/mcp","type":"streamable-http"}],"packages":[],"status":"active","isLatest":true,"publishedAt":"2026-09-26T19:34:17.527Z","updatedAt":"2026-09-26T19:34:17.527Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"stars":null,"title":"Shift Scheduler","source":"official-registry","sourceId":"com.kindoflost.staff-scheduling/shift-scheduler","updatedAt":"2026-09-26T19:34:17.527Z","confidence":100,"websiteUrl":"https://staff-scheduling.kindoflost.com/mcp-server","description":"Builds optimal 24/7 staff rosters with a real MILP solver: rest rules, skills, nights, fairness.","verification":"official","repositoryUrl":null}],"toolIndex":{"tools":[{"serverName":"com.kindoflost.staff-scheduling/shift-scheduler","endpointFingerprint":"a7210ebd75f8008a8f02d0c1b998316d701ae3101f936231d63565057f5109ce","name":"build_shift_roster","title":"Build an optimized shift roster","description":"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.","inputSchema":{"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)."}}},"annotations":{"title":"Build an optimized shift roster","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"012f1d41c1ad57cb4736b42f6f0cdb2ff4afe23cff25eee7bb8f12cff62c94f7","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T23:46:58.183Z","metadataTrust":"untrusted"},{"serverName":"com.kindoflost.staff-scheduling/shift-scheduler","endpointFingerprint":"a7210ebd75f8008a8f02d0c1b998316d701ae3101f936231d63565057f5109ce","name":"check_request","title":"Check whether a request fits","description":"Describe what the user wants in plain words and get back whether this server can do it, which limits it would hit, and the closest thing it CAN do. Instant, no solve. Use it when unsure the tool fits (shift swaps, payroll, time clocks, very large teams or long horizons).","inputSchema":{"type":"object","properties":{"description":{"type":"string","maxLength":2000,"description":"The user's request in their own words, e.g. 'rota for 80 nurses over 3 months with shift swaps'."}},"required":["description"],"additionalProperties":false},"annotations":{"title":"Check whether a request fits","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"8c954b9b22eacd0e639730e120e68f06d24079370ef3db9036bc4aa7b1a85574","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T23:46:58.183Z","metadataTrust":"untrusted"},{"serverName":"com.kindoflost.staff-scheduling/shift-scheduler","endpointFingerprint":"a7210ebd75f8008a8f02d0c1b998316d701ae3101f936231d63565057f5109ce","name":"get_shift_example","title":"Get an example roster input","description":"Return the full input JSON of one example, in exactly the shape build_shift_roster accepts. Edit it (names, days, headcounts, rules) to match the user's situation.","inputSchema":{"type":"object","properties":{"name":{"type":"string","enum":["hospital-ward","three-shift-plant","security-site","fire-station","support-desk"]},"lang":{"type":"string","enum":["en","es"],"description":"es = Spanish shift and post names."}},"required":["name"],"additionalProperties":false},"annotations":{"title":"Get an example roster input","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"definitionHash":"29557a2917a61f82e0fd19e4e58ddfb28cbc050c6dcd80ebd5d089c72dd15199","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T23:46:58.183Z","metadataTrust":"untrusted"},{"serverName":"com.kindoflost.staff-scheduling/shift-scheduler","endpointFingerprint":"a7210ebd75f8008a8f02d0c1b998316d701ae3101f936231d63565057f5109ce","name":"get_shift_roster_result","title":"Get a roster result","description":"Fetch the result of a build_shift_roster job that returned status 'running'. Waits up to wait_seconds; call again while status is 'running'. Jobs expire 15 minutes after they finish.","inputSchema":{"type":"object","properties":{"job_id":{"type":"string"},"wait_seconds":{"type":"integer","minimum":0,"maximum":45}},"required":["job_id"],"additionalProperties":false},"annotations":{"title":"Get a roster result","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"definitionHash":"1ea37a62a574c21b46c250c74d2b89b903c820469a6a40c4bfe1129b9a954fd8","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T23:46:58.183Z","metadataTrust":"untrusted"},{"serverName":"com.kindoflost.staff-scheduling/shift-scheduler","endpointFingerprint":"a7210ebd75f8008a8f02d0c1b998316d701ae3101f936231d63565057f5109ce","name":"list_shift_examples","title":"List example rosters","description":"List the built-in example rostering problems (hospital ward, 3-shift plant, security post, fire station, 24/7 help desk). Use one as a starting point for the user's own roster.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"title":"List example rosters","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"definitionHash":"e9ec4e12d3e24f0b014e111067be556f234f7387d2d3d61cc5284506e383f179","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T23:46:58.183Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"a7210ebd75f8008a8f02d0c1b998316d701ae3101f936231d63565057f5109ce","protocol":"streamable-http","status":"indexed","toolCount":5,"observedAt":"2026-11-15T23:46:58.183Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"com.kindoflost.staff-scheduling/shift-scheduler":{"url":"https://staff-scheduling.kindoflost.com/mcp"}}},"Cursor":{"mcpServers":{"com.kindoflost.staff-scheduling/shift-scheduler":{"url":"https://staff-scheduling.kindoflost.com/mcp"}}},"VS Code":{"servers":{"com.kindoflost.staff-scheduling/shift-scheduler":{"type":"http","url":"https://staff-scheduling.kindoflost.com/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://staff-scheduling.kindoflost.com/mcp"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:com.kindoflost.staff-scheduling%2Fshift-scheduler","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/com.kindoflost.staff-scheduling%2Fshift-scheduler","name":"com.kindoflost.staff-scheduling/shift-scheduler","description":"Builds optimal 24/7 staff rosters with a real MILP solver: rest rules, skills, nights, fairness.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://staff-scheduling.kindoflost.com/mcp"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":"https://staff-scheduling.kindoflost.com/mcp-server","repositoryUrl":null,"version":"1.0.0"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"com.kindoflost.staff-scheduling/shift-scheduler","status":"online","lastCheckedAt":"2026-11-20T07:15:56.999Z","lastSuccessfulCheck":"2026-11-20T07:15:56.999Z","latencyMs":77,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T07:15:56.999Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T07:15:56.999Z"},"security":null,"timestamps":{"createdAt":"2026-09-26T19:34:17.527Z","updatedAt":"2026-09-26T19:34:17.527Z","observedAt":"2026-11-20T07:15:56.999Z"},"compatibility":{"serverVersion":"1.0.0","protocolVersions":[{"protocol":"mcp","version":null}]}}}}