---
title: "corestack_order_link_preview"
url: https://docs.corefinity.com/mcp/tools/corestack_order_link_preview
type: tool
last_updated: 2026-11-13
feature: order
related:
  - https://docs.corefinity.com/guides/billing/orders.md
---
# corestack_order_link_preview

**Preview an order link.** Check a package, upgrades, region, currency, server type and billing period, price them as the order does, and return the order page link that opens with them chosen. Needs the read scope. Scope: read.

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

## When to use it

Check a package, upgrades, region, currency, server type and billing period, price them as the order does, and return the order page link that opens with them chosen. Use it before sending somebody to `/order`, so the link opens with exactly what you priced.

Nothing is created, saved or charged. Every price is the catalogue's, worked out on the server: the link carries no price, and a `price` or `total` in it would be ignored.

## Inputs

- `package` (string, up to 16 characters, required): A package code the order sells, for example `CS4` or `CC8`.
- `region` (one of `uk`, `us`, `nl`, `aus`, required): The region the order page opens on. It must be a region the package's product line can be ordered in.
- `currency` (one of `GBP`, `USD`, `EUR`, required): The currency the order page shows. A currency one product line has no price in is refused.
- `compute_family` (one of `general`, `optimised`): `general`: Standard; `optimised`: Performance. Default `general`. Performance is refused with the order's own sentence where the region does not offer it: `Performance servers are not available in the <region> region right now`.
- `addons` (object): Extra resources on top of the package, within the package's steps and ceilings (the answer's `addon_steps`).
  - `cores` (integer, ≥ 0): Extra CPU cores.
  - `memory_gb` (integer, ≥ 0): Extra memory in GB.
  - `disk_gb` (integer, ≥ 0): Extra disk in GB.
- `platform` (string, up to 32 characters): A CoreStack platform key, for example `wordpress` or `magento2`; required for a CoreStack package, refused for a CoreCluster one.
- `billing` (one of `monthly`, `annual`): `monthly` or `annual`; default `monthly`. What annual means, and when it is honoured, is decided by the order page.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "addons": {
      "additionalProperties": false,
      "description": "Extra resources on top of the package; the package's steps and ceilings apply.",
      "properties": {
        "cores": {
          "description": "Extra CPU cores.",
          "minimum": 0,
          "type": "integer"
        },
        "disk_gb": {
          "description": "Extra disk in GB.",
          "minimum": 0,
          "type": "integer"
        },
        "memory_gb": {
          "description": "Extra memory in GB.",
          "minimum": 0,
          "type": "integer"
        }
      },
      "type": "object"
    },
    "billing": {
      "description": "monthly or annual; default monthly.",
      "enum": [
        "monthly",
        "annual"
      ],
      "type": "string"
    },
    "compute_family": {
      "description": "general: Standard; optimised: Performance. Default general.",
      "enum": [
        "general",
        "optimised"
      ],
      "type": "string"
    },
    "currency": {
      "description": "GBP, USD or EUR.",
      "enum": [
        "GBP",
        "USD",
        "EUR"
      ],
      "type": "string"
    },
    "package": {
      "description": "A package code the order sells, for example CS4 or CC8.",
      "maxLength": 16,
      "type": "string"
    },
    "platform": {
      "description": "A CoreStack platform key, for example wordpress or magento2; required for CoreStack.",
      "maxLength": 32,
      "type": "string"
    },
    "region": {
      "description": "uk, us, nl or aus.",
      "enum": [
        "uk",
        "us",
        "nl",
        "aus"
      ],
      "type": "string"
    }
  },
  "required": [
    "package",
    "region",
    "currency"
  ],
  "type": "object"
}
```

## Refusals

- `invalid_arguments`: one of the values is not one the order would take; the `errors` name the field in the order page's own words ("Add up to 16 extra cores", "Prices in EUR are not available right now", "Choose a package", …). Correct it and try again.
- The refusals every tool can answer: `invalid_arguments`, `scope_required`, `rate_limited`, `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).

## Example

```json
{
  "name": "corestack_order_link_preview",
  "arguments": {
    "package": "CC8",
    "region": "nl",
    "currency": "EUR",
    "compute_family": "optimised",
    "addons": { "cores": 2, "memory_gb": 8, "disk_gb": 50 }
  }
}
```

The answer's `url` is the order page link (`https://manage.corefinity.com/order?package=CC8&region=nl&currency=EUR&optimised=1&addon_cores=2&addon_memory_gb=8&addon_disk_gb=50`); `quote.subtotal_monthly` is what the page's own rail shows before anything is saved.

## Prompt

```text
Using the Corefinity MCP server, call corestack_order_link_preview with package CC8, region nl, currency EUR, compute_family optimised, addons {"cores":2,"memory_gb":8,"disk_gb":50}. (Preview an order link.) Tell me what it returned.
```

## The same task elsewhere

- Guide: [Orders](https://docs.corefinity.com/guides/billing/orders.md)
