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

**Show a cluster's maintenance window.** Reads a CoreCluster's default maintenance window (used by its sites without their own), where it comes from, the sites that override it and whether you can change it, or a preview of a change. Scope: read.

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

## When to use it

Read a CoreCluster's default maintenance window: the window every site on it without its own uses, where it comes from, the sites that override it and whether you can change it. Preview a change before making it.

## Inputs

- `cluster_id` (integer, required): one of your CoreClusters.
- `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": {
    "cluster_id": {
      "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"
    }
  },
  "required": [
    "cluster_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_locked` (preview only): Corefinity set this cluster's window.

## Example

```json
{
  "name": "corecluster_maintenance_window_get",
  "arguments": {
    "cluster_id": 12
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corecluster_maintenance_window_get with cluster_id 12. (Show a cluster's maintenance window.) Tell me what it returned.
```

## The same task elsewhere

- Guide: [Maintenance window](https://docs.corefinity.com/guides/sites/site-settings/maintenance-window.md)
