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

**Price catalogue.** Read the prices: CoreStack and CoreCluster packages, add-on units, staging sizes and the Performance server type, for a currency and region, with your VAT. Use it before a change or corestack_billing_quote_preview. Scope: read.

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

## When to use it

Read the prices: CoreStack and CoreCluster packages, add-on units, staging sizes and the Performance server type, for a currency and region, with your VAT. Use it before a change or corestack_billing_quote_preview.

Only packages on sale are listed: a package Corefinity has taken off sale is not in the answer, and a running cluster on one keeps its price and can still upgrade (corecluster_upgrade_options_get).

Each package carries `trial_days`: the free trial a new order of that package gets, in days (`0`: no free trial). A company has one free trial at most, and trials already running keep their dates.

Each package also names `platforms_allowed` (the platforms it hosts) and, on the CoreCluster line, `tiers` (the site sizes it offers: `S`, `M`, `L`), so a package offered only to some platforms or sizes says so here, as the order page does.

Each package also carries `money_back_days`: the money-back guarantee window a new order of it is offered, in days (`0`: none). The package's figure is its policy; whether a particular company is covered is the order's answer, and a contract keeps the window it was opened with.

`compute_optimised` answers the Performance server type: `available`, its `reason` (the order's sentence when it is not offered), and `product_lines` (`cc`, `cs`), each with its own `available` and `reason` — a region can offer Performance for one line and not the other.

Each add-on row carries `monthly` (its unit rounded to pennies, for display) and `unit_prices`: per line (`cs`, `cc`) the `general` and `optimised` unit as a six-place string, `optimised` null where Performance is not offered. Price an upgrade line as that unit × the quantity, rounded half to even to pennies, as `corestack_billing_quote_preview` does — never `monthly` × the quantity, which is off by the rounding.

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

- `currency` (string, 3–3 characters): GBP, EUR, USD or AUD; omitted, your billing account's currency (GBP without one).
- `region` (string, up to 16 characters): uk, us, nl or aus; omitted, uk.
- `product_line` (one of `cs`, `cc`): cs: CoreStack; cc: CoreCluster; omitted, both.
- `platform` (one of `wordpress`, `laravel`, `magento2`, `shopware`): Moves the packages this platform cannot use to hidden.
- `account_id` (integer, ≥ 1): The billing account whose currency and VAT apply; omitted, the company's default.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "account_id": {
      "description": "The billing account whose currency and VAT apply; omitted, the company's default.",
      "minimum": 1,
      "type": "integer"
    },
    "currency": {
      "description": "GBP, EUR, USD or AUD; omitted, your billing account's currency (GBP without one).",
      "maxLength": 3,
      "minLength": 3,
      "type": "string"
    },
    "platform": {
      "description": "Moves the packages this platform cannot use to hidden.",
      "enum": [
        "wordpress",
        "laravel",
        "magento2",
        "shopware5"
      ],
      "type": "string"
    },
    "product_line": {
      "description": "cs: CoreStack; cc: CoreCluster; omitted, both.",
      "enum": [
        "cs",
        "cc"
      ],
      "type": "string"
    },
    "region": {
      "description": "uk, us, nl or aus; omitted, uk.",
      "maxLength": 16,
      "type": "string"
    }
  },
  "type": "object"
}
```

## Refusals

- `zone_unknown`: that zone is not known; use one corestack_regions_list answers.
- `currency_unpublished`: prices are not published in that currency; use the company's currency.
- `package_platform`: the package does not support this platform; choose another package or platform.
- 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_catalogue_get",
  "arguments": {}
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_billing_catalogue_get. (Price catalogue.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [GET /api/corestack/billing/catalogue](https://docs.corefinity.com/api/reference/billing/get-billing-catalogue.md)
- Guide: [Billing](https://docs.corefinity.com/guides/billing/billing-overview.md)
