---
title: "corecluster_compute_family_switch"
url: https://docs.corefinity.com/mcp/tools/corecluster_compute_family_switch
type: tool
last_updated: 2026-11-13
feature: upgrades
related:
  - https://docs.corefinity.com/api/reference/sites/switch-cluster-compute-family.md
  - https://docs.corefinity.com/guides/sites/size-and-capacity/upgrade-a-package.md
---
# corecluster_compute_family_switch

**Change a CoreCluster's server type.** Move every site of a CoreCluster to the Standard or the Performance server type, now or tonight. Each site moves to the new servers in turn; if any site cannot move yet, nothing changes. Price it first with corestack_billing_quote_preview. Scope: write. Long-running: answers with a task.

- Scope: `write`
- Confirmation: `confirm_name`
- Runs as a task: yes

## When to use it

Move every site of a CoreCluster to the Standard or the Performance server type, now or tonight. Each site moves to the new servers in turn; if any site cannot move yet, nothing changes. Price it first with corestack_billing_quote_preview.

## Inputs

- `cluster_id` (integer, ≥ 1, required)
- `family` (one of `general`, `optimised`, required): general: Standard; optimised: Performance.
- `confirm_name` (string, up to 253 characters, required): The CoreCluster's name, typed to confirm.
- `apply` (one of `now`, `tonight`, default `"now"`): now (the default) or tonight, in the maintenance window, with everything else queued for the row.
- `quote_id` (string, pattern `^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$`): A quote from corestack_billing_quote_preview (optional): the write refuses with stale if the price moved.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "apply": {
      "default": "now",
      "description": "now (the default) or tonight, in the maintenance window, with everything else queued for the row. window: the row's next maintenance window (tonight is kept as its alias).",
      "enum": [
        "now",
        "window",
        "tonight"
      ],
      "type": "string"
    },
    "cluster_id": {
      "minimum": 1,
      "type": "integer"
    },
    "confirm_name": {
      "description": "The CoreCluster's name, typed to confirm.",
      "maxLength": 253,
      "type": "string"
    },
    "family": {
      "description": "general: Standard; optimised: Performance.",
      "enum": [
        "general",
        "optimised"
      ],
      "type": "string"
    },
    "quote_id": {
      "description": "A quote from corestack_billing_quote_preview (optional): the write refuses with stale if the price moved.",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
      "type": "string"
    }
  },
  "required": [
    "cluster_id",
    "family",
    "confirm_name"
  ],
  "type": "object"
}
```

## Refusals

- `platform_cluster`: this is a platform cluster, where this setting is not yours to change.
- `same_family`: the row already uses that server type; nothing to change.
- `contract_missing`: the billing contract changed while the change was being made; read the options again and call again. (A site or cluster with no billing contract is changed all the same, without a quote: it is not billed in the Control Panel.)
- `stale`: the quote no longer matches this change or has expired; preview a new one with corestack_billing_quote_preview and call again with its quote_id.
- `no_payment_method`: the company has no payment method; the person must add one in the Control Panel.
- `compute_capacity_blocked`: the cluster's servers have no room for this; free capacity or upgrade the cluster first.
- `family_change_pending`: a server-type change is already pending; wait for it or cancel it.
- `restart_batches_off`: the maintenance window queue is switched off, so nothing can be queued for tonight; apply now instead.
- `family_unavailable`: that server type is not available here; choose another.
- `feature_off`: an input needs a feature that is switched off (for example `apply: "tonight"` while the maintenance window queue is switched off); leave that input out.
- `confirm_mismatch`: a typed confirmation does not match (`confirm_domain`: the site's domain on production, the canonical host elsewhere; `confirm_name`: the cluster's or environment's name); ask the person for the exact value.
- `billing_forbidden`: the person has no billing role in the company; ask a company owner or billing member.
- `demo_keep_required`: the site or cluster is a free demo that is not kept yet, and this change costs money: it starts once the demo is kept. Ask the person to keep it (`corestack_demo_keep`, or open `keep_url`); `change` names this change and what it would cost a month once kept.
- 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": "corecluster_compute_family_switch",
  "arguments": {
    "cluster_id": 812,
    "family": "general",
    "confirm_name": "Staging"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corecluster_compute_family_switch with cluster_id 812, family general. (Change a CoreCluster's server type.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [POST /api/corestack/clusters/{cluster}/compute-family](https://docs.corefinity.com/api/reference/sites/switch-cluster-compute-family.md)
- Guide: [Upgrade package](https://docs.corefinity.com/guides/sites/size-and-capacity/upgrade-a-package.md)
