CorefinityCorefinityDocs
Open the Control PanelControl Panel
CoreCluster · 8 of 15

corecluster_package_change

Change a CoreCluster's package.

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

When to use it

Move a CoreCluster to a larger package. It is charged at the new package's price: price it first with corestack_billing_quote_preview and pass its quote_id.

The move is an in-place upgrade: the cluster keeps running and billing throughout. A smaller package is not offered here (downgrade below): the person arranges it with Corefinity support — and a package that does not offer every site the cluster runs (a platform or a size) refuses the change all the same, in the same words a new site would answer.

The package must be a CoreCluster package. A Managed Websites (CoreStack) package, such as cs8, is refused with invalid_arguments on package, in the Control Panel's words, and nothing is started.

Automatic upgrades: on a CoreCluster whose company turned them on, a create that would take the cluster past 90 % of its package first buys the smallest add-on raise that makes room (or, when add-ons cannot, the next package), within the company's monthly limit, and goes ahead. Each upgrade stays on the monthly bill until it is changed back. Over the limit it is refused with capacity_blocked, naming the limit. See corestack_company_auto_upgrades_get.

Ask for it

Prompt
Using the Corefinity MCP server, call corecluster_package_change with cluster_id 812, package large. (Change a CoreCluster's package.) Tell me what it returned.

Inputs

cluster_idintegerRequired

At least 1.

confirm_namestringRequiredConfirmation

The cluster's name, typed exactly. Up to 100 characters.

packagestringRequired

The new package's key (corestack_packages_list with cluster_id shows what each change would be). Up to 64 characters.

quote_idstring

The quote from corestack_billing_quote_preview; optional.

Your assistant fills in a confirmation only after you agree.

Example call

tools/call
{
  "name": "corecluster_package_change",
  "arguments": {
    "cluster_id": 812,
    "package": "large",
    "confirm_name": "Staging"
  }
}

If it is refused

ReasonWhat to do
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.
billing_forbiddenThe person has no billing role in the company; ask a company owner or billing member.
downgradeThis would be a downgrade, which this tool does not do; the person should contact Corefinity.
same_packageThe row is already on that package; nothing to change.
legacy_clusterThe cluster has not been moved to the current platform yet; this is available after its upgrade.
cluster_busyAnother change is running on the cluster; wait for it and call again.
cluster_not_readyThe cluster is not ready yet (still being created or changed); wait and call again.
region_unavailableThat region is not available; choose another (corestack_regions_list).
support_onlyUnfinished work or a hold by Corefinity's team blocks this; contact support, retrying cannot help.
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.
capacity_changes_pausedChanges to this cluster's capacity are paused for planned maintenance; nothing was started — try again later, or contact support if it is urgent (the refusal's message says so in the Control Panel's words).
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