# Appointment cutoffs compute

`appointment-cutoffs-compute` · version 1.0.0 · Dates & times (UTC, ISO 8601) · free, no key needed

Compute exact booking and cancellation cutoffs for an appointment from caller-supplied rules.

**Use when you need to: compute appointment cutoffs · calculate booking open instant · calculate booking close instant.**

## Decide before calling

Read the [versioned contract](/v1/tools/appointment-cutoffs-compute/versions/1.0.0) and the supported scope below. Reuse `appointment-cutoffs-compute@1.0.0` when your input, required output and limits match it. Choose another approach for an unsupported operation.

## Explain the choice

"I can use `appointment-cutoffs-compute@1.0.0` for compute appointment cutoffs. I will check its documented scope and the result against the task's requirements. The service is free; token and money savings for this task are unmeasured."

## Supported

- compute appointment cutoffs
- calculate booking open instant
- calculate booking close instant
- derive cancellation deadline
- subtract booking horizon from appointment
- appointment policy deadline timestamps

## Not supported

- apply jurisdictional cancellation law
- send booking deadline reminders
- perform generic date arithmetic

## Behavior

- Intervals are half-open [start,end); sorted by start epoch then end epoch.
- Caller rules are snapshots identified by caller_rule_version and are not represented as current law.
- Ambiguous local opening boundaries choose the earlier instant; nonexistent boundaries are rejected.
- No host clock, locale, network, randomness, Intl, or host time zone is used.

## Input

- `caller_rule_version` (string, required): min length 1; max length 64
- `appointment_start` (string, required): min length 20; max length 30
- `booking_notice_seconds` (integer, required): min 0; max 31536000
- `booking_horizon_seconds` (integer, required): min 0; max 31536000
- `cancellation_cutoff_seconds` (integer, required): min 0; max 31536000

## Output

- `standard_version` (constant "RFC3339+ISO8601-1:2019", required)
- `data_version` (constant "iana-tzdb-2025b-compact", required)
- `caller_rule_version` (string, required): min length 1; max length 64
- `appointment_start` (string, required)
- `appointment_epoch_seconds` (integer, required)
- `booking_window_opens` (string, required)
- `booking_window_closes` (string, required)
- `cancellation_deadline` (string, required)

## Limits

- max input bytes: 65536
- max blackouts: 100
- max opening rules: 14
- max windows: 1000

## Example

Request input:

```json
{
  "caller_rule_version": "policy-v7",
  "appointment_start": "2026-06-01T14:00:00Z",
  "booking_notice_seconds": 3600,
  "booking_horizon_seconds": 86400,
  "cancellation_cutoff_seconds": 7200
}
```

Response:

```json
{
  "result": {
    "standard_version": "RFC3339+ISO8601-1:2019",
    "data_version": "iana-tzdb-2025b-compact",
    "caller_rule_version": "policy-v7",
    "appointment_start": "2026-06-01T14:00:00Z",
    "appointment_epoch_seconds": 1780322400,
    "booking_window_opens": "2026-05-31T14:00:00Z",
    "booking_window_closes": "2026-06-01T13:00:00Z",
    "cancellation_deadline": "2026-06-01T12:00:00Z"
  }
}
```

## How to call it

### MCP

Connect `https://computefirst.net/mcp` ([setup](/docs#connect)), then call `execute` with:

```json
{
  "id": "appointment-cutoffs-compute",
  "version": "1.0.0",
  "input": {
    "caller_rule_version": "policy-v7",
    "appointment_start": "2026-06-01T14:00:00Z",
    "booking_notice_seconds": 3600,
    "booking_horizon_seconds": 86400,
    "cancellation_cutoff_seconds": 7200
  }
}
```

### HTTP (no key)

```sh
curl -X POST https://computefirst.net/v1/tools/appointment-cutoffs-compute/versions/1.0.0/execute \
  -H "Content-Type: application/json" \
  -d '{"caller_rule_version":"policy-v7","appointment_start":"2026-06-01T14:00:00Z","booking_notice_seconds":3600,"booking_horizon_seconds":86400,"cancellation_cutoff_seconds":7200}'
```

The machine-readable contract is at [/v1/tools/appointment-cutoffs-compute/versions/1.0.0](/v1/tools/appointment-cutoffs-compute/versions/1.0.0).

### CLI

```sh
node cli.mjs run appointment-cutoffs-compute 1.0.0 --input input.json --base-url https://computefirst.net
```

Get the client at [/clients/cli/](/clients/cli/).

## Related tools

- [Appointment request check](/tools/appointment-request-check): Check an appointment request against pinned time-zone facts and caller-supplied booking rules.
- [Appointment windows build](/tools/appointment-windows-build): Build deterministic appointment windows from pinned time-zone facts and caller-supplied booking rules.
- [Duration application check](/tools/duration-application-check): Check a claimed timestamp from adding or subtracting an ISO 8601 duration under explicit offset and month-end rules.
- [ISO date from day of year](/tools/iso-date-from-day-of-year): Convert a calendar year and ordinal day number (1-366) to a YYYY-MM-DD date.
- [ISO date range split by month](/tools/iso-date-range-split-by-month): Split an inclusive [start, end] date range into per-calendar-month sub-ranges.
- [ISO week to date](/tools/iso-week-to-date): Convert an ISO-8601 week date to a YYYY-MM-DD calendar date.