---
title: "corestack_maintenance_window_get"
url: https://docs.corefinity.com/mcp/tools/corestack_maintenance_window_get
type: tool
last_updated: 2026-11-13
feature: maintenance-windows
related:
  - https://docs.corefinity.com/api/reference/site-settings/get-site-maintenance-window.md
  - https://docs.corefinity.com/guides/sites/site-settings/maintenance-window.md
---
# corestack_maintenance_window_get

**Show a site's maintenance window.** Reads a site's maintenance window (site_id: a site or environment row): the effective 4-hour window (UK time) and its source, the next slot, what is queued, snapshot overlap, whether you can change it and the latest five history events (history_cursor pages on); or a preview of a change. Scope: read.

- Scope: `read`
- Runs as a task: no

## When to use it

Read a site's maintenance window: the 4-hour window (UK time) routine maintenance and queued changes wait for, where it comes from (the site's own, its CoreCluster's, your company's or the platform default), the next slot, what is queued for it, snapshot overlap, whether you can change it, and the latest five changes as `history`. Page older changes with `history_cursor` (start from `history_next_cursor`). Before changing a window, preview what it would move.

## Inputs

- `site_id` (integer, required): a site or environment row (an environment answers its website's window).
- `history_cursor` (integer, optional): the next page of history only (`events`, `next_cursor`).
- `preview_start_hour` (integer 0–23, optional): what saving this start hour would move, nothing saved.
- `preview_clear` (boolean, optional): what clearing the window would move, nothing saved. Give one preview argument at most.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "history_cursor": {
      "description": "next_cursor of a history page: the next page of history only.",
      "minimum": 1,
      "type": "integer"
    },
    "preview_clear": {
      "description": "true: preview what clearing would move, without saving.",
      "type": "boolean"
    },
    "preview_start_hour": {
      "description": "Preview, without saving, what starting the window at this hour would move.",
      "maximum": 23,
      "minimum": 0,
      "type": "integer"
    },
    "site_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "site_id"
  ],
  "type": "object"
}
```

## Refusals

- The refusals every tool can answer: `invalid_arguments`, `tenant_mismatch`, `scope_required`, `pin_refused`, `rate_limited`, `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).
- `window_scope_unavailable` (preview only): environments use their website's window.
- `window_locked` (preview only): Corefinity set this window.

## Example

```json
{
  "name": "corestack_maintenance_window_get",
  "arguments": {
    "site_id": 74
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_maintenance_window_get with site_id 74. (Show a site's maintenance window.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [GET /api/corestack/sites/{site}/maintenance-window](https://docs.corefinity.com/api/reference/site-settings/get-site-maintenance-window.md)
- Guide: [Maintenance window](https://docs.corefinity.com/guides/sites/site-settings/maintenance-window.md)
