# io.usefulapi/when-i-work (remote · when-i-work.usefulapi.io)

Check shifts, time clock entries, time-off requests, swaps and availability, and manage shifts.

- Trust score: 76/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-04

## Components

- remote · `when-i-work.usefulapi.io`: 76/100 (this document), [markdown](https://verifymcp.io/servers/io-usefulapi-when-i-work/when-i-work.md), [page](https://verifymcp.io/servers/io-usefulapi-when-i-work/when-i-work)

## Channel facts

- Endpoint: `https://when-i-work.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-10-04.

- **Endpoint Security**: 89/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
  - The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 69/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 3676 tokens (~175/item across 21 items; 21 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 13/100
  - Stability observed for 4 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 21 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 60/100
  - Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28.

## Install

### How do I install the io.usefulapi/when-i-work MCP server?

io.usefulapi/when-i-work is a hosted endpoint at https://when-i-work.usefulapi.io/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http io-usefulapi-when-i-work 'https://when-i-work.usefulapi.io/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "io-usefulapi-when-i-work": {
      "url": "https://when-i-work.usefulapi.io/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "io-usefulapi-when-i-work": {
      "type": "http",
      "url": "https://when-i-work.usefulapi.io/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.io-usefulapi-when-i-work]
url = "https://when-i-work.usefulapi.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-when-i-work": {
      "type": "remote",
      "url": "https://when-i-work.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-usefulapi-when-i-work --url 'https://when-i-work.usefulapi.io/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-usefulapi-when-i-work:
    url: "https://when-i-work.usefulapi.io/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "io-usefulapi-when-i-work": {
      "Transport": "http",
      "Url": "https://when-i-work.usefulapi.io/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add io-usefulapi-when-i-work -t streamable-http -u 'https://when-i-work.usefulapi.io/mcp'
```

### Other

```json
{
  "mcpServers": {
    "io-usefulapi-when-i-work": {
      "type": "http",
      "url": "https://when-i-work.usefulapi.io/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-03 (score 76, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-02 (score 75, 0)

- [functional] Server version: 1.3.0 → 1.5.1

### 2026-10-01 (score 75, +5)

- [security improvement] HTTPS: unverified → pass
- [functional improvement] Stability: unverified → 0.03
- [functional] Server version: 1.0.0 → 1.3.0

### 2026-09-30 (score 70, +52)

- [security improvement] Authorization: unverified → pass
- [security improvement] Injection markers: unverified → pass
- [security improvement] Transport: fail → pass
- [security] First check of Judged manipulation: pass
- [security] First check of Authorization: partial
- [functional regression] MCP protocol: unverified → fail
- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: excellent
- [functional] First check of Schema quality: fail
- [functional] First check of Destructive annotations: 100
- [functional] First check of Tool coverage: 100

### 2026-09-29 (score 18)

First indexed and scored.

## MCP tools (21)

### `wheniwork_get_account` (~60 tokens)

Get the account

Fetch the When I Work account (workplace) the token acts on — company name, plan and settings; for a parent account also its child accounts. A cheap way to confirm the credentials work. When I Work: GET /2/account.

### `wheniwork_list_users` (~159 tokens)

List users

List the employees, supervisors, managers and admins in the account, optionally limited to some schedules or searched by name/email. Role codes: 1 admin, 2 manager, 3 employee, 5 supervisor. When I Work: GET /2/users.

Input parameters:

- `location_id` (array): One or more schedule (location) ids.
- `only_deleted` (boolean): Only deleted/archived users (supervisor or above).
- `only_pending` (boolean): Only pending users.
- `search` (string): Search first name, last name or email.
- `show_deleted` (boolean): Include deleted users (supervisor or above).
- `show_pending` (boolean): Include users who have not accepted their invite (default true).

### `wheniwork_get_user` (~51 tokens)

Get one user

Fetch one user by id — name, email, role, positions, schedules, wage. When I Work: GET /2/users/{id}.

Input parameters:

- `user_id` (integer, required): The user id.

### `wheniwork_list_locations` (~64 tokens)

List schedules (locations)

List the schedules in the account. The API calls a schedule a "location"; its id is the location_id every shift belongs to. When I Work: GET /2/locations.

Input parameters:

- `only_unconfirmed` (boolean): Only schedules whose address is unconfirmed.

### `wheniwork_list_positions` (~49 tokens)

List positions

List the positions (job roles such as Cashier or Dishwasher) in the account. When I Work: GET /2/positions.

Input parameters:

- `show_deleted` (boolean): Include deleted positions.

### `wheniwork_list_shifts` (~437 tokens)

List shifts

List scheduled shifts in a time window — who works when, where and in which position — optionally including open shifts and unpublished drafts. Answers "who is on on Friday?" and "what open shifts are left?". When I Work: GET /2/shifts.

Input parameters:

- `all_locations` (boolean): Include shifts from all schedules.
- `deleted` (boolean): Also return deleted_ids: shifts deleted in the window.
- `end` (string): End of the window. Date-time, e.g. 2026-10-05T08:00:00-05:00 (When I Work's own examples also use RFC 2822, e.g. "Mon, 05 Oct 2026 08:00:00 -0500").
- `include_allopen` (boolean): Include open shifts across all schedules — manager or admin.
- `include_onlyopen` (boolean): Return only open shifts.
- `include_open` (boolean): Include open (unassigned) shifts from the user's schedules.
- `include_repeating_shifts_to` (string): Also expand repeating shift series up to this date. Date-time, e.g. 2026-10-05T08:00:00-05:00 (When I Work's own examples also use RFC 2822, e.g. "Mon, 05 Oct 2026 08:00:00 -0500").
- `include_swaps` (boolean): Include swap requests attached to the shifts.
- `limit` (integer): Maximum number of results.
- `location_id` (array): One or more schedule (location) ids.
- `start` (string): Start of the window. Date-time, e.g. 2026-10-05T08:00:00-05:00 (When I Work's own examples also use RFC 2822, e.g. "Mon, 05 Oct 2026 08:00:00 -0500").
- `unpublished` (boolean): Include unpublished (draft) shifts — supervisor or above.
- `user_id` (integer): Only this user's shifts.

### `wheniwork_get_shift` (~129 tokens)

Get one shift

Fetch one shift by id, including its breaks and publish state. When I Work: GET /2/shifts/{id}.

Input parameters:

- `include_repeating_shifts_to` (string): Also expand the shift's repeating series up to this date. Date-time, e.g. 2026-10-05T08:00:00-05:00 (When I Work's own examples also use RFC 2822, e.g. "Mon, 05 Oct 2026 08:00:00 -0500").
- `shift_id` (integer, required): The shift id.

### `wheniwork_list_eligible_users_for_shift` (~294 tokens)

List users eligible for an open shift

Find who could take an open shift — either an existing shift (shift_id) or a hypothetical one (start, end, position_id and location_id all required). When I Work: GET /2/shifts/eligible.

Input parameters:

- `end` (string): End of the potential shift (required without shift_id). Date-time, e.g. 2026-10-05T08:00:00-05:00 (When I Work's own examples also use RFC 2822, e.g. "Mon, 05 Oct 2026 08:00:00 -0500").
- `include_objects` (boolean): Include the users' schedules and positions in the output.
- `is_shared` (boolean): Whether it is a shared open shift.
- `location_id` (integer): Schedule of the potential shift (required without shift_id).
- `position_id` (integer): Position of the potential shift (required without shift_id).
- `shift_id` (integer): An existing shift's id.
- `start` (string): Start of the potential shift (required without shift_id). Date-time, e.g. 2026-10-05T08:00:00-05:00 (When I Work's own examples also use RFC 2822, e.g. "Mon, 05 Oct 2026 08:00:00 -0500").

### `wheniwork_list_times` (~300 tokens)

List clocked times (timesheets)

List clocked time entries — actual hours worked, clock-in/out times, length and approval state. Use only_open to see who is clocked in right now. When I Work: GET /2/times.

Input parameters:

- `end` (string): End of the window. Date-time, e.g. 2026-10-05T08:00:00-05:00 (When I Work's own examples also use RFC 2822, e.g. "Mon, 05 Oct 2026 08:00:00 -0500").
- `only_open` (boolean): Only times with no end yet (people currently clocked in).
- `start` (string): Start of the window. Date-time, e.g. 2026-10-05T08:00:00-05:00 (When I Work's own examples also use RFC 2822, e.g. "Mon, 05 Oct 2026 08:00:00 -0500").
- `updated_at` (string): Only times updated since this timestamp. Date-time, e.g. 2026-10-05T08:00:00-05:00 (When I Work's own examples also use RFC 2822, e.g. "Mon, 05 Oct 2026 08:00:00 -0500").
- `user_id` (array): One or more user ids.

### `wheniwork_list_time_off_requests` (~235 tokens)

List time-off requests

List time-off requests in a date range, with the requesting users. Status: 0 pending, 1 canceled, 2 accepted, 3 expired, 4 denied. When I Work: GET /2/requests.

Input parameters:

- `end` (string): End date, yyyy-mm-dd.
- `include_deleted_users` (boolean): Include requests made by deleted users.
- `limit` (integer): Maximum number of results.
- `location_id` (integer): Only requests for this schedule.
- `max_id` (integer): Only requests created before this request id.
- `page` (integer): Page of results to load (the response says whether there are `more`).
- `since_id` (integer): Only requests created after this request id.
- `sortby` (string): 'created' sorts newest first; anything else sorts by status then last update.
- `start` (string): Start date, yyyy-mm-dd.
- `status` (integer): Only requests with this status.
- `type` (integer): Only this request type.
- `user_id` (array): One or more user ids.

### `wheniwork_get_time_off_request` (~54 tokens)

Get one time-off request

Fetch one time-off request by id, with its message thread and users. When I Work: GET /2/requests/{request_id}.

Input parameters:

- `request_id` (integer, required): The time-off request id.

### `wheniwork_list_time_off_types` (~56 tokens)

List time-off types

List the time-off types (e.g. Personal, Sick, Holiday) and whether each allows paid time. Their ids are the type_id for a new request. When I Work: GET /2/requesttypes.

### `wheniwork_list_shift_swaps` (~330 tokens)

List shift swaps and drops

List shift requests: swaps, drops and alerts, with the shifts and users involved. Status: 0 pending, 1 approved, 2 declined, 3 completed, 4 canceled, 5 expired. Type: 1 swap, 2 drop, 3 alert. start and end must be given together. When I Work: GET /2/swaps.

Input parameters:

- `end` (string): End of the shift window (give with start). Date-time, e.g. 2026-10-05T08:00:00-05:00 (When I Work's own examples also use RFC 2822, e.g. "Mon, 05 Oct 2026 08:00:00 -0500").
- `limit` (integer): Maximum number of results.
- `open_only` (boolean): Only open swaps.
- `page` (integer): Page of results to load (the response says whether there are `more`).
- `shift_id` (array): One or more shift ids.
- `start` (string): Start of the shift window (give with end). Date-time, e.g. 2026-10-05T08:00:00-05:00 (When I Work's own examples also use RFC 2822, e.g. "Mon, 05 Oct 2026 08:00:00 -0500").
- `status` (array): One or more statuses.
- `type` (array): One or more types.
- `user_id` (array): One or more user ids.

### `wheniwork_list_availability` (~241 tokens)

List availability

List availability events — when people said they can or cannot work, including recurring patterns that fall in the window. Defaults to the caller, from now to two weeks out. When I Work: GET /2/availabilityevents.

Input parameters:

- `end` (string): End of the window (default two weeks from now). Date-time, e.g. 2026-10-05T08:00:00-05:00 (When I Work's own examples also use RFC 2822, e.g. "Mon, 05 Oct 2026 08:00:00 -0500").
- `include_all` (boolean): Everyone's availability, not just one user's — managers only.
- `start` (string): Start of the window (default now). Date-time, e.g. 2026-10-05T08:00:00-05:00 (When I Work's own examples also use RFC 2822, e.g. "Mon, 05 Oct 2026 08:00:00 -0500").
- `user_id` (integer): Whose availability (default the calling user).

### `wheniwork_list_annotations` (~218 tokens)

List schedule annotations

List schedule annotations — announcements, business-closed days and blackout dates when time off is not allowed. Defaults to today through one year out. When I Work: GET /2/annotations.

Input parameters:

- `end_date` (string): End of the range (default one year after start). Date-time, e.g. 2026-10-05T08:00:00-05:00 (When I Work's own examples also use RFC 2822, e.g. "Mon, 05 Oct 2026 08:00:00 -0500").
- `no_time_off` (boolean): Only annotations that block time off.
- `start_date` (string): Start of the range (default the start of today). Date-time, e.g. 2026-10-05T08:00:00-05:00 (When I Work's own examples also use RFC 2822, e.g. "Mon, 05 Oct 2026 08:00:00 -0500").

### `wheniwork_create_shift` (~263 tokens)

Create a shift

Create one shift on a schedule — assigned to a user, or open (user_id 0). Created as a draft unless published is true. Undo by editing it or unpublishing. When I Work: POST /2/shifts.

Input parameters:

- `break_time` (number): Unpaid break length in hours, e.g. 0.5.
- `color` (string): Hex colour without #, e.g. cc0000.
- `end_time` (string, required): Shift end, date-time with offset.
- `is_shared` (boolean): For an open shift: a shared open shift.
- `location_id` (integer, required): The schedule (location) the shift belongs to id.
- `notes` (string): Shift notes shown to the employee.
- `position_id` (integer): Position for the shift.
- `published` (boolean): Publish it immediately (default: draft).
- `site_id` (integer): Job site for the shift.
- `start_time` (string, required): Shift start, date-time with offset, e.g. 2026-10-05T08:00:00-05:00.
- `user_id` (integer): The user to assign. 0 (or omitted on create) makes it an open shift.

### `wheniwork_update_shift` (~294 tokens)

Update a shift

Change a shift — reassign it, move it, change position or notes. When I Work requires start_time, end_time and location_id on every update, so fetch the shift first and pass them back. This tool never sends a breaks array; When I Work documents that breaks omitted from an update's breaks list are removed, so re-check the shift's breaks afterwards. When I Work: PUT /2/shifts/{id}.

Input parameters:

- `break_time` (number): Unpaid break length in hours, e.g. 0.5.
- `color` (string): Hex colour without #, e.g. cc0000.
- `end_time` (string, required): Shift end (required by the API even if unchanged).
- `is_shared` (boolean): For an open shift: a shared open shift.
- `location_id` (integer, required): The schedule (location) id.
- `notes` (string): Shift notes shown to the employee.
- `position_id` (integer): Position for the shift.
- `published` (boolean): Publish it immediately (default: draft).
- `shift_id` (integer, required): The shift id.
- `site_id` (integer): Job site for the shift.
- `start_time` (string, required): Shift start (required by the API even if unchanged).
- `user_id` (integer): The user to assign. 0 (or omitted on create) makes it an open shift.

### `wheniwork_publish_shifts` (~62 tokens)

Publish shifts

Publish draft shifts so employees can see them. Publishing does not itself send notifications. Undo with wheniwork_unpublish_shifts. When I Work: POST /2/shifts/publish.

Input parameters:

- `ids` (array, required): The shift ids to publish.

### `wheniwork_unpublish_shifts` (~58 tokens)

Unpublish shifts

Return published shifts to draft, hiding them from employees. Undo with wheniwork_publish_shifts. When I Work: POST /2/shifts/unpublish.

Input parameters:

- `ids` (array, required): The shift ids to unpublish.

### `wheniwork_create_time_off_request` (~166 tokens)

Create a time-off request

Create a time-off request for a user (default the calling user). It starts pending; cancel it with wheniwork_update_time_off_request (status 1). Get type ids from wheniwork_list_time_off_types. When I Work: POST /2/requests.

Input parameters:

- `end_time` (string, required): End of the time off, full date-time.
- `hours` (number): Hours of paid time off to use.
- `paid` (boolean): Whether it is paid time off.
- `start_time` (string, required): Start of the time off, full date-time.
- `type_id` (integer): Time-off type id (Personal, Sick, Holiday...).
- `user_id` (integer): Who is taking time off (default the calling user).

### `wheniwork_update_time_off_request` (~156 tokens)

Approve, deny or change a time-off request

Change a time-off request: set its status (0 pending, 1 canceled, 2 accepted/approved, 3 expired, 4 denied) and/or its dates or hours. Reversible — set the status back. start_time and end_time must be given together. When I Work: PUT /2/requests/{request_id}.

Input parameters:

- `end_time` (string): New end, full date-time (give with start_time).
- `hours` (number): Hours of paid time off to use.
- `request_id` (integer, required): The time-off request id.
- `start_time` (string): New start, full date-time (give with end_time).
- `status` (integer): New status.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-usefulapi-when-i-work/when-i-work#diagnostics

## Score history

- 2026-10-04: 76
- 2026-10-03: 76
- 2026-10-02: 75
- 2026-10-01: 75
- 2026-09-30: 70
- 2026-09-29: 18

## Common questions

### What is the io.usefulapi/when-i-work MCP server?

io.usefulapi/when-i-work is an MCP server listed in the public MCP registry as io.usefulapi/when-i-work. Check shifts, time clock entries, time-off requests, swaps and availability, and manage shifts. This page covers its hosted endpoint (https://when-i-work.usefulapi.io/mcp).

### Is the io.usefulapi/when-i-work MCP server safe to use?

io.usefulapi/when-i-work scores 76 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the io.usefulapi/when-i-work MCP server expose?

io.usefulapi/when-i-work exposes 21 tools: wheniwork_get_account, wheniwork_list_users, wheniwork_get_user, wheniwork_list_locations, wheniwork_list_positions, and 16 more. Their descriptions and schemas cost roughly 3,676 tokens of context every time the server is loaded.

### Does the io.usefulapi/when-i-work MCP server require authentication?

Yes. io.usefulapi/when-i-work asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.

### Is the io.usefulapi/when-i-work MCP server still maintained?

io.usefulapi/when-i-work is still listed as active in the MCP registry. We last reached this channel on 4 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://when-i-work.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-when-i-work/when-i-work.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-when-i-work/when-i-work.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-when-i-work/when-i-work