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

**Change a site's server type.** Move a CoreStack site to the Standard or the Performance server type, now or tonight. The site moves to the new servers. Price it first with corestack_billing_quote_preview. Scope: write. Long-running: answers with a task.

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

## When to use it

Move a CoreStack site to the Standard or the Performance server type, now or tonight. The site moves to the new servers. Price it first with corestack_billing_quote_preview.

## Inputs

- `site_id` (integer, ≥ 1, required): The site (its production row).
- `family` (one of `general`, `optimised`, required): general: Standard; optimised: Performance.
- `confirm_domain` (string, up to 253 characters, required): The site's domain, 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"
    },
    "confirm_domain": {
      "description": "The site's domain, 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"
    },
    "site_id": {
      "description": "The site (its production row).",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "site_id",
    "family",
    "confirm_domain"
  ],
  "type": "object"
}
```

## Refusals

- `same_family`: the row already uses that server type; nothing to change.
- `cluster_site`: the site is in a CoreCluster, where this is set on the cluster; use the corecluster_ tool.
- `provisioning`: the site is still being created; wait for corestack_site_provisioning_get to finish.
- `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.
- `restart_batches_off`: the maintenance window queue was switched off as this was called, and a server type change goes through it now as well as tonight; nothing was changed.
- `change_pending`: a change is already pending for this row; apply or cancel it first (corestack_pending_changes_list).
- `family_unavailable`: that server type is not available here; choose another.
- `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.
- `forbidden`: the Control Panel refuses this person the action and names no reason; stop.
- `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.
- `managed_elsewhere` (message: "This site is managed by another control panel"): another control panel manages this site, so use that control panel for it. This is refused before anything else about the site, as in the Control Panel and the API. Nothing was done.
- 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_site_compute_family_switch",
  "arguments": {
    "site_id": 4211,
    "family": "general",
    "confirm_domain": "example.co.uk"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_site_compute_family_switch with site_id 4211, family general. (Change a site's server type.) Tell me what it returned.
```

## The same task elsewhere

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