CorefinityCorefinityDocs
Open the Control PanelControl Panel
CoreCluster · 12 of 15

corecluster_addons_set

Set a CoreCluster's add-ons.

Scope writeNo secrets returnedCoreCluster
On this page

When to use it

Set a CoreCluster's four add-on allowances — extra cores, memory, disk and log storage — to the values given (a decrease too). It applies at once. Price it first with corestack_billing_quote_preview.

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_addons_set with cluster_id 812, cores 1, memory_gb 1, disk_gb 1, log_storage_gb 1. (Set a CoreCluster's add-ons.) Tell me what it returned.

Inputs

cluster_idintegerRequired

At least 1.

coresintegerRequired

0 to 512.

disk_gbintegerRequired

0 to 65536.

log_storage_gbintegerRequired

0 to 65536.

memory_gbintegerRequired

0 to 4096.

quote_idstring

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

MCP refuses disk_gb above 65536 during schema validation, before the service runs. REST and the domain allow up to 102400 GB (100 TB), subject to their validation rules; that higher range is unavailable through this MCP tool. Values within the MCP range must still meet the domain's steps and other checks.

Example call

tools/call
{
  "name": "corecluster_addons_set",
  "arguments": {
    "cluster_id": 812,
    "cores": 1,
    "memory_gb": 1,
    "disk_gb": 1,
    "log_storage_gb": 1
  }
}

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.
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.)
platform_clusterThis is a platform cluster, where this setting is not yours to change.
cluster_legacyThe cluster has not been moved to the current platform yet; this is available after its upgrade.
no_payment_methodThe company has no payment method; the person must add one in the Control Panel.
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.
cluster_deletingThe cluster is being deleted.
capacity_blockedThere is not enough capacity for this; check corecluster_capacity_check or choose another size.
addon_boundsThe add-on amount is outside what the package allows; choose a value inside its bounds.
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