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

**List upcoming maintenance.** Lists the next 7 days of maintenance-window slots and what is queued in each, for one site (site_id), one CoreCluster (cluster_id) or every site you reach: what you asked for, maintenance outside a site's own window and routine platform maintenance inside it during the notice period. Scope: read.

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

## When to use it

List the next seven days of maintenance-window slots and what is queued in each, exactly as the Control Panel shows them: everything you asked for, maintenance outside a site's own window, and routine platform maintenance inside it during the notice period. For one site, one CoreCluster or every site you reach; a token limited to some sites sees only those.

Planned maintenance that Corefinity announced by email for a site also appears here, as a `Platform maintenance` slot on the day it starts once that day is within the seven days, whatever the site's own window. From the moment it is announced until it ends, `corestack_pending_changes_list` lists it with its summary under `platform_maintenance`, and `corestack_attention_list` carries it as a `platform_maintenance` item.

## Inputs

- `site_id` (integer, optional).
- `cluster_id` (integer, optional). Give one of them or neither, never both.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "cluster_id": {
      "minimum": 1,
      "type": "integer"
    },
    "site_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "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).

## Example

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

## Prompt

```text
Using the Corefinity MCP server, call corestack_maintenance_upcoming_list with cluster_id 12. (List upcoming maintenance.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [GET /api/maintenance-windows/upcoming](https://docs.corefinity.com/api/reference/site-settings/list-upcoming-maintenance-windows.md)
- Guide: [Maintenance window](https://docs.corefinity.com/guides/sites/site-settings/maintenance-window.md)
