corecluster_ addons_ set
Set a CoreCluster's add-ons.
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
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
At least 1.
0 to 512.
0 to 65536.
0 to 65536.
0 to 4096.
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
{
"name": "corecluster_addons_set",
"arguments": {
"cluster_id": 812,
"cores": 1,
"memory_gb": 1,
"disk_gb": 1,
"log_storage_gb": 1
}
}If it is refused
| Reason | What to do |
|---|---|
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. |
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.) |
platform_cluster | This is a platform cluster, where this setting is not yours to change. |
cluster_legacy | The cluster has not been moved to the current platform yet; this is available after its upgrade. |
no_payment_method | The company has no payment method; the person must add one in the Control Panel. |
cluster_busy | Another change is running on the cluster; wait for it and call again. |
cluster_not_ready | The cluster is not ready yet (still being created or changed); wait and call again. |
cluster_deleting | The cluster is being deleted. |
capacity_blocked | There is not enough capacity for this; check corecluster_capacity_check or choose another size. |
addon_bounds | The add-on amount is outside what the package allows; choose a value inside its bounds. |
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. |
invalid_arguments | The 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_mismatch | The object does not exist or the token may not see it. Check the id. |
scope_required | The token lacks a scope this call needs. Open the link in the answer to add it, then call again. |
pin_refused | The 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_limited | Too many calls. Wait for the number of seconds the answer names. |
temporarily_unavailable | The Control Panel could not answer just now. Nothing was started; try again shortly. |
internal_error | Something went wrong on our side. Quote the trace id to support. |