get_pass_window
One dated access window of a project's pass plans by UUID — when it runs, whether it is still on sale and how many holders bought it.
Read one window back before acting on it. The row is the same shape
list_pass_windows returns: the instant it opens and closes, the
local range in the plan's own timezone, its lifecycle status, whether it is sellable right now,
and how many holders bought it.
`sellable` and `status` answer different questions
status is the lifecycle — scheduled, open, closed, canceled.
sellable is whether a customer can buy the window at this moment, after the
plan's sales cutoff. A scheduled window can already be closed to sales, and
a plan anchored to the window's end keeps selling while it is open. Check
sellable before pointing a customer at a window, and holders before
cancelling one.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same action as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Annotations
It reads and never changes anything.
Arguments
project_id*stringUUID of the project whose pass plans own the window.
window_id*stringUUID of the window to fetch.
What it returns
{ "data": { "id": "3d5a8c72-b016-4e94-8fa7-61c209d4e738", "plan_id": "9b7c2e15-4d63-4f80-a2b1-7e5d0c9f3a46", "plan_name": "Saturday session", "starts_at": "2026-10-03T09:00:00+00:00", "ends_at": "2026-10-03T11:00:00+00:00", "timezone": "Europe/London", "local_range": "Sat 3 Oct, 10:00–12:00 BST", "duration_minutes": 120, "status": "scheduled", "sellable": true, "holders": 12 }}starts_at and ends_at are UTC instants; local_range is the same span rendered in timezone,
which is the plan's pass timezone, so it is what a creator or a member would say out loud.
How it fails
RESOURCE_NOT_FOUNDunknown project_id or window_id, a window that belongs to another project, or a project outside the token's scope.
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks pass-window:view.
How is this guide?
Last updated on