---
title: "corestack_billing_quote_preview"
url: https://docs.corefinity.com/mcp/tools/corestack_billing_quote_preview
type: tool
last_updated: 2026-11-13
feature: billing
related:
  - https://docs.corefinity.com/api/reference/billing/preview-billing-quote.md
  - https://docs.corefinity.com/guides/billing/billing-overview.md
---
# corestack_billing_quote_preview

**Price a change.** 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. Scope: read.

- Scope: `read`
- Runs as a task: no

## 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.

## Inputs

- `account_id` (integer, ≥ 1): One of your company's billing accounts (corestack_billing_account_get gives its id); omitted, the company's default account.
- `changes` (array of objects, 1–10 items, required): 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).
  - `type` (one of `package`, `addons`, `uat_size`, `compute_family`, `new_site`, `new_cluster`, required)
  - `subject` (object): package, addons, compute_family: a cluster or site; uat_size: an environment.
    - `type` (one of `cluster`, `site`, `environment`, required)
    - `id` (integer, ≥ 1, required)
  - `package` (string, up to 16 characters)
  - `cores` (integer, 0–512)
  - `memory_gb` (integer, 0–4096)
  - `disk_gb` (integer, 0–65536 in MCP)
  - `log_storage_gb` (integer, 0–65536)
  - `uat_size` (string, up to 16 characters)
  - `family` (one of `general`, `optimised`): general: Standard; optimised: Performance.
  - `region` (string, up to 16 characters)
  - `environments` (array of objects, up to 10 items)
    - `uat_size` (string, up to 16 characters, required)
  - `addons` (object)
    - `cores` (integer, 0–512)
    - `memory_gb` (integer, 0–4096)
    - `disk_gb` (integer, 0–65536 in MCP)

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.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "account_id": {
      "description": "One of your company's billing accounts (corestack_billing_account_get gives its id); omitted, the company's default account.",
      "minimum": 1,
      "type": "integer"
    },
    "changes": {
      "description": "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).",
      "items": {
        "additionalProperties": false,
        "properties": {
          "addons": {
            "additionalProperties": false,
            "properties": {
              "cores": {
                "maximum": 512,
                "minimum": 0,
                "type": "integer"
              },
              "disk_gb": {
                "maximum": 65536,
                "minimum": 0,
                "type": "integer"
              },
              "memory_gb": {
                "maximum": 4096,
                "minimum": 0,
                "type": "integer"
              }
            },
            "type": "object"
          },
          "cores": {
            "maximum": 512,
            "minimum": 0,
            "type": "integer"
          },
          "disk_gb": {
            "maximum": 65536,
            "minimum": 0,
            "type": "integer"
          },
          "environments": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "uat_size": {
                  "maxLength": 16,
                  "type": "string"
                }
              },
              "required": [
                "uat_size"
              ],
              "type": "object"
            },
            "maxItems": 10,
            "type": "array"
          },
          "family": {
            "description": "general: Standard; optimised: Performance.",
            "enum": [
              "general",
              "optimised"
            ],
            "type": "string"
          },
          "log_storage_gb": {
            "maximum": 65536,
            "minimum": 0,
            "type": "integer"
          },
          "memory_gb": {
            "maximum": 4096,
            "minimum": 0,
            "type": "integer"
          },
          "package": {
            "maxLength": 16,
            "type": "string"
          },
          "region": {
            "maxLength": 16,
            "type": "string"
          },
          "subject": {
            "additionalProperties": false,
            "description": "package, addons, compute_family: a cluster or site; uat_size: an environment.",
            "properties": {
              "id": {
                "minimum": 1,
                "type": "integer"
              },
              "type": {
                "enum": [
                  "cluster",
                  "site",
                  "environment"
                ],
                "type": "string"
              }
            },
            "required": [
              "type",
              "id"
            ],
            "type": "object"
          },
          "type": {
            "enum": [
              "package",
              "addons",
              "uat_size",
              "compute_family",
              "new_site",
              "new_cluster"
            ],
            "type": "string"
          },
          "uat_size": {
            "maxLength": 16,
            "type": "string"
          }
        },
        "required": [
          "type"
        ],
        "type": "object"
      },
      "maxItems": 10,
      "minItems": 1,
      "type": "array"
    }
  },
  "required": [
    "changes"
  ],
  "type": "object"
}
```

## Refusals

- `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.
- The refusals every tool can answer: `invalid_arguments`, `tenant_mismatch`, `scope_required`, `pin_refused`, `rate_limited`, `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).

## Example

```json
{
  "name": "corestack_billing_quote_preview",
  "arguments": {
    "changes": [
      {
        "type": "package",
        "subject": {
          "type": "site",
          "id": 4211
        },
        "package": "cs4"
      }
    ]
  }
}
```

## Prompt

```text
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.
```

## The same task elsewhere

- Endpoint: [POST /api/corestack/billing/quote](https://docs.corefinity.com/api/reference/billing/preview-billing-quote.md)
- Guide: [Billing](https://docs.corefinity.com/guides/billing/billing-overview.md)
