INDIVIDUAL MCP TOOL

deputy_add_unavailability

Record a time an employee cannot work (one-off, or recurring with an RFC 5545-style rule such as FREQ WEEKLY, INTERVAL 1, BYDAY MO).

usefulapi.ionone authenticationAvailability not checked

LIVE ENDPOINT

https://deputy.usefulapi.io/mcp

No auth detected

Connect to this endpoint to inspect the live schema for deputy_add_unavailability and invoke it with your own arguments.

{}

Inferred read-only · medium confidence · heuristic, not a guarantee.

No write-capable action terms were found; this is not proof that invocation has no side effects.

CONNECT WITH APPROVAL

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.deputy-mcp]
url = "https://deputy.usefulapi.io/mcp"
enabled = true

Claude Code

.mcp.json

{
  "mcpServers": {
    "deputy-mcp": {
      "type": "http",
      "url": "https://deputy.usefulapi.io/mcp"
    }
  }
}

Claude Desktop

Settings → Connectors → Add custom connector

Name: deputy-mcp
Remote MCP URL: https://deputy.usefulapi.io/mcp

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "deputy-mcp": {
      "url": "https://deputy.usefulapi.io/mcp"
    }
  }
}

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

{
  "servers": {
    "deputy-mcp": {
      "type": "http",
      "url": "https://deputy.usefulapi.io/mcp"
    }
  }
}

Generic MCP

Client-specific MCP configuration

{
  "name": "deputy-mcp",
  "transport": "streamable-http",
  "url": "https://deputy.usefulapi.io/mcp"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

deputy_whoami — Return the Deputy user the token belongs to — name, employee id, company and permissions.
deputy_list_locations — List the install's locations (workplaces).
deputy_list_areas — List areas (Deputy OperationalUnits — the rosterable sections of a location, e.
deputy_list_employees — Search employees by name, location or active status.
deputy_get_employee — Fetch one employee's details as a supervisor sees them — contact, locations, role and employment.
deputy_list_shifts — Search the roster (scheduled shifts) by time window, employee, area, and published/open state.
deputy_get_shift — Fetch one shift (Roster record) by id.
deputy_list_timesheets — Search timesheets (actual worked time) by time window, employee, area and approval state.