corestack_ billing_ quote_ preview
Price a change.
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
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
One of your company's billing accounts (corestack_billing_account_get gives its id); omitted, the company's default account. At least 1.
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
Fields
0 to 512.
0 to 65536.
0 to 4096.
0 to 512.
0 to 65536.
Up to 10 items.
Fields of each item
Up to 16 characters.
general: Standard; optimised: Performance.
generaloptimised0 to 65536.
0 to 4096.
Up to 16 characters.
Up to 16 characters.
package, addons, compute_family: a cluster or site; uat_size: an environment.
Fields
At least 1.
clustersiteenvironmentpackageaddonsuat_sizecompute_familynew_sitenew_clusterUp 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
{
"name": "corestack_billing_quote_preview",
"arguments": {
"changes": [
{
"type": "package",
"subject": {
"type": "site",
"id": 4211
},
"package": "cs4"
}
]
}
}If it is refused
| Reason | What to do |
|---|---|
billing_forbidden | The person has no billing role in the company; ask a company owner or billing member. |
contract_missing | The 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_package | The row is already on that package; nothing to change. |
downgrade | This would be a downgrade, which this tool does not do; the person should contact Corefinity. |
same_family | The row already uses that server type; nothing to change. |
family_unavailable | That server type is not available here; choose another. |
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. |