Deputy Workforce Operations MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Deputy Workforce Operations MCP Show timesheet exceptions above a 15-minute tolerance."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Deputy Workforce Operations MCP
A read-only Model Context Protocol server that turns Deputy workforce records into five grounded, operational workflows for AI assistants.
What a Deputy manager can ask
“Where are the coverage gaps from 20 to 26 July, using a minimum of two people?”
“Which combined completed and rostered workloads cross our 40-hour planning threshold?”
“Show timesheet exceptions above a 15-minute tolerance.”
“Which rosters overlap recorded unavailability or approved leave?”
“Summarise staffing by location and day for this week.”
The tools answer those questions directly instead of exposing Deputy's endpoint catalogue.
Related MCP server: Slack MCP Server
Representative results
The examples below use fictional records and compact the structured response to the fields a manager can act on.
Coverage gaps
{
"period": { "start": "2026-07-20", "end": "2026-07-26", "timezone": "Europe/London" },
"findings": [{ "kind": "coverage_gap", "sources": [{ "resource": "Roster", "id": 1001 }], "rule": "active roster has fewer than 2 people" }],
"limits": []
}Overtime risk
{ "period": { "start": "2026-07-20", "end": "2026-07-26", "timezone": "Europe/London" }, "findings": [{ "worker_id": 7, "planned_hours": 43.5, "threshold_hours": 40, "sources": [{ "resource": "Timesheet", "id": 2007 }, { "resource": "Roster", "id": 1007 }], "rule": "completed plus remaining rostered hours exceeds threshold" }], "limits": [] }Timesheet exceptions
{ "period": { "start": "2026-07-20", "end": "2026-07-26", "timezone": "Europe/London" }, "findings": [{ "kind": "start_time_variance", "roster_id": 1002, "minutes": 22, "tolerance_minutes": 15, "sources": [{ "resource": "Roster", "id": 1002 }, { "resource": "Timesheet", "id": 2002 }], "rule": "timesheet start differs from roster beyond tolerance" }], "limits": [] }Availability conflicts
{ "period": { "start": "2026-07-20", "end": "2026-07-26", "timezone": "Europe/London" }, "findings": [{ "kind": "recorded_unavailability_conflict", "sources": [{ "resource": "Roster", "id": 1002 }, { "resource": "EmployeeAvailability", "id": 4001 }], "rule": "roster interval overlaps recorded unavailability" }], "limits": [] }Staffing summary
{ "period": { "start": "2026-07-20", "end": "2026-07-26", "timezone": "Europe/London" }, "findings": [{ "location": "North", "day": "2026-07-21", "rostered_hours": 16, "completed_hours": 12, "assigned": 3, "unassigned": 1, "sources": [{ "resource": "Roster", "id": 1008 }, { "resource": "Timesheet", "id": 2008 }], "rule": "group roster and timesheet hours by location and local day" }], "limits": [] }Every finding names its period, source record identifiers, and the rule or threshold that produced it. Empty data gives a confidence limit rather than a false all-clear.
Safety and data handling
Every tool is read-only, idempotent, and non-destructive.
The server never creates or changes shifts, timesheets, leave, payroll, or employee data.
Workload thresholds are operational planning signals, not payroll, employment, or legal advice.
Telemetry excludes tool arguments, employee and location IDs, dates, result content, and tokens.
Standard MCP analytics are disabled unless the deployment owner provides a PostHog project token; the privacy allowlist is documented in PRIVACY.md.
V1 is single-tenant by deployment: one Deputy installation and one MCP bearer token per instance.
Authentication, bounded HTTP transport, rate limiting, structured results, and stdio lifecycle use MCP Maker's shared
@hyperdrift-io/mcp-service-kit; Deputy keeps its provider and workflow logic.
See SECURITY.md and PRIVACY.md for the complete contracts.
Local installation
Node.js 22 or later is required; npm ships with it. The quickest safe inspection uses the public package and fictional fixture data:
DEPUTY_MODE=fixture npx -y @hyperdrift-io/deputy-workforce-mcp@latestFor a visible tool-list and tool-call proof, see the fixture demonstration. The package is also distributed through the official MCP Registry and as a one-file MCP Bundle on Smithery. Maintainers can reproduce the local bundle with:
npm run mcpb:packTo work from source:
git clone https://github.com/hyperdrift-io/deputy-workforce-mcp.git
cd deputy-workforce-mcp
npm install
npm run build
DEPUTY_MODE=fixture node dist/stdio.jsFixture mode contains fictional Worker 01-style records and is safe for evaluation. To connect a
Deputy installation, copy .env.example to .env.local, choose DEPUTY_MODE=live, and provide a
customer-owned base URL and OAuth access token. Live resource shapes still require the first
sandbox verification recorded in docs/DEPUTY_API.md.
Example client configuration:
{
"mcpServers": {
"deputy-workforce": {
"command": "node",
"args": ["/absolute/path/to/deputy-workforce-mcp/dist/stdio.js"],
"env": { "DEPUTY_MODE": "fixture" }
}
}
}Remote deployment
The same five tools can run over authenticated streamable HTTP. Remote mode requires an MCP bearer token of at least 32 bytes, authenticates before parsing requests, limits bodies to 1 MiB, and uses bounded in-memory rate protection.
DEPUTY_MODE=fixture \
MCP_BEARER_TOKEN="replace-with-at-least-32-random-bytes" \
PORT=3013 \
npm startHealth:
GET /healthMCP: authenticated
POST /mcp
See docs/DEPLOYMENT.md before operating a remote instance.
Tool reference
The server registers exactly five tools:
find_coverage_gapsflag_overtime_risklist_timesheet_exceptionsfind_availability_conflictssummarise_staffing
Inputs, rules, and output limits are documented in docs/TOOLS.md.
Status
Fixture mode, stdio, and authenticated streamable HTTP are operational. Live Deputy mode remains explicitly pending a customer-owned sandbox token and field-shape verification. The public API is still in prototype discovery and may evolve from real workflow feedback.
Built as MCP Maker delivery 001
Deputy Workforce Operations MCP is the flagship public implementation from MCP Maker: Hyperdrift turns established SaaS APIs into secure, production-ready AI integrations.
The open-source core remains useful on its own. MCP Maker offers managed deployment, security hardening, custom workflows, and operational support for organisations that want a production integration tailored to their environment.
Available Tools
5 toolsfind_availability_conflictsFind availability conflictsBRead-onlyIdempotent
Find rosters overlapping recorded unavailability or approved leave.
Inputs: end_date (required), timezone (required), start_date (required), location_ids.
find_coverage_gapsFind coverage gapsBRead-onlyIdempotent
Find open shifts and optional minimum-staffing shortfalls without changing Deputy data.
Inputs: end_date (required), timezone (required), start_date (required), location_ids, +1 more.
flag_overtime_riskFlag workload thresholdARead-onlyIdempotent
Compare completed and remaining rostered hours with a configured operational threshold.
Inputs: end_date (required), timezone (required), start_date (required), location_ids, +1 more.
list_timesheet_exceptionsList timesheet exceptionsBRead-onlyIdempotent
Find missing or materially different timesheets using an explicit tolerance.
Inputs: end_date (required), timezone (required), start_date (required), location_ids, +1 more.
summarise_staffingSummarise staffingARead-onlyIdempotent
Summarise rostered and completed staffing by location and local day.
Inputs: end_date (required), timezone (required), start_date (required), location_ids.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct operational concern: coverage gaps, overtime risk, timesheet exceptions, staffing summary, and availability conflicts. No overlap or ambiguity.
All tool names follow a consistent verb_noun pattern in snake_case (find_, flag_, list_, summarise_, find_), making them predictable and clear.
5 tools is well-scoped for a read-only workforce analysis server, covering key monitoring areas without bloat or deficiency.
The set covers main operational needs (gaps, overtime, exceptions, summary, conflicts). A minor gap is the absence of a tool to list all shifts or employees directly, but the summary and gap tools partially address this.
Maintenance
Related MCP Connectors
MCP server exposing klokin time-tracking operations (employees, time entries, stores) to AI clients.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
One governed MCP endpoint for 40+ business systems. Read-only, source-cited answers.
Related MCP Servers
- AlicenseAqualityDmaintenanceA read-only MCP server that connects AI assistants to the OfficeRnD coworking and flex-space management platform. It enables natural language queries for community members, space bookings, billing records, and office resources.51MIT
- AlicenseNot gradedqualityDmaintenanceA read-only MCP server that enables AI assistants to access Slack workspace data, including channels, messages, threads, and user information.3MIT
- FlicenseNot gradedqualityDmaintenanceRead-only MCP server that proxies deepHR's API to MCP clients, enabling interaction with deepHR modules such as payroll and employees through natural language.-
- FlicenseAqualityDmaintenanceAn MCP server that exposes governed CXone WFM Intraday tools to an AI assistant, enabling real-time analyst workflows like risk assessment and SLA recovery using synthetic data.10-