CorefinityCorefinityDocs
Open the Control PanelControl Panel
CoreCluster · 13 of 15

corecluster_compute_family_switch

Change a CoreCluster's server type.

Scope writeAsks you to confirmRuns as a taskNo secrets returnedCoreCluster
On this page

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.

Ask for it

Prompt
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.

Inputs

applystring

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). Defaults to now.

nowwindowtonight
cluster_idintegerRequired

At least 1.

confirm_namestringRequiredConfirmation

The CoreCluster's name, typed to confirm. Up to 253 characters.

familystringRequired

general: Standard; optimised: Performance.

generaloptimised
quote_idstring

A quote from corestack_billing_quote_preview (optional): the write refuses with stale if the price moved.

Your assistant fills in a confirmation only after you agree.

Example call

tools/call
{
  "name": "corecluster_compute_family_switch",
  "arguments": {
    "cluster_id": 812,
    "family": "general",
    "confirm_name": "Staging"
  }
}

If it is refused

ReasonWhat to do
platform_clusterThis is a platform cluster, where this setting is not yours to change.
same_familyThe row already uses that server type; nothing to change.
contract_missingThe 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.)
staleThe 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_methodThe company has no payment method; the person must add one in the Control Panel.
compute_capacity_blockedThe cluster's servers have no room for this; free capacity or upgrade the cluster first.
family_change_pendingA server-type change is already pending; wait for it or cancel it.
restart_batches_offThe maintenance window queue is switched off, so nothing can be queued for tonight; apply now instead.
family_unavailableThat server type is not available here; choose another.
feature_offAn 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_mismatchA 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_forbiddenThe person has no billing role in the company; ask a company owner or billing member.
demo_keep_requiredThe 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.
invalid_argumentsThe arguments do not match the tool's input schema, or the Control Panel refused a field. Fix the fields named in the answer and call again.
tenant_mismatchThe object does not exist or the token may not see it. Check the id.
scope_requiredThe token lacks a scope this call needs. Open the link in the answer to add it, then call again.
pin_refusedThe grant is limited to chosen clusters, sites or environments, and this call is outside them. Open the link in the answer to widen it.
rate_limitedToo many calls. Wait for the number of seconds the answer names.
temporarily_unavailableThe Control Panel could not answer just now. Nothing was started; try again shortly.
internal_errorSomething went wrong on our side. Quote the trace id to support.

The same task elsewhere

Was this helpful?
Open in ClaudeOpen in ChatGPT