CorefinityCorefinityDocs
Open the Control PanelControl Panel
Billing · 2 of 17

corestack_billing_quote_preview

Price a change.

Scope readNo secrets returned
On this page

When to use it

Price up to ten changes before making them: a package, the four add-on allowances, a staging size or the server type of a site or CoreCluster, or a new site or CoreCluster. Answers the monthly before and after, the pro-rata amount and tax, and a quote id a change can take within 15 minutes. Nothing is changed.

Through the REST API (/api/corestack/billing/…) the account is account, as on the Billing pages; account_id, this tool's name, is accepted there too as its alias.

Ask for it

Prompt
Using the Corefinity MCP server, call corestack_billing_quote_preview with changes [{"type":"package","subject":{"type":"site","id":4211},"package":"cs4"}]. (Price a change.) Tell me what it returned.

Inputs

account_idinteger

One of your company's billing accounts (corestack_billing_account_get gives its id); omitted, the company's default account. At least 1.

changesarray of objectsRequired

package: subject, package · addons: subject, cores, memory_gb, disk_gb, log_storage_gb · uat_size: subject, uat_size · compute_family: subject, family · new_site / new_cluster: package, family, region (new_site also environments and addons, new_cluster addons). Up to 10 items.

Fields of each item
addonsobject
Fields
coresinteger

0 to 512.

disk_gbinteger

0 to 65536.

memory_gbinteger

0 to 4096.

coresinteger

0 to 512.

disk_gbinteger

0 to 65536.

environmentsarray of objects

Up to 10 items.

Fields of each item
uat_sizestringRequired

Up to 16 characters.

familystring

general: Standard; optimised: Performance.

generaloptimised
log_storage_gbinteger

0 to 65536.

memory_gbinteger

0 to 4096.

packagestring

Up to 16 characters.

regionstring

Up to 16 characters.

subjectobject

package, addons, compute_family: a cluster or site; uat_size: an environment.

Fields
idintegerRequired

At least 1.

typestringRequired
clustersiteenvironment
typestringRequired
packageaddonsuat_sizecompute_familynew_sitenew_cluster
uat_sizestring

Up to 16 characters.

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": "corestack_billing_quote_preview",
  "arguments": {
    "changes": [
      {
        "type": "package",
        "subject": {
          "type": "site",
          "id": 4211
        },
        "package": "cs4"
      }
    ]
  }
}

If it is refused

ReasonWhat to do
billing_forbiddenThe person has no billing role in the company; ask a company owner or billing member.
contract_missingThe site or cluster has no billing contract in the Control Panel, so there is nothing to price; make the change without a quote_id (it is not billed in the Control Panel).
same_packageThe row is already on that package; nothing to change.
downgradeThis would be a downgrade, which this tool does not do; the person should contact Corefinity.
same_familyThe row already uses that server type; nothing to change.
family_unavailableThat server type is not available here; choose another.
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