---
title: "corestack_packages_list"
url: https://docs.corefinity.com/mcp/tools/corestack_packages_list
type: tool
last_updated: 2026-11-13
feature: upgrades
related:
  - https://docs.corefinity.com/api/reference/sites/list-packages.md
  - https://docs.corefinity.com/guides/sites/size-and-capacity/upgrade-a-package.md
---
# corestack_packages_list

**Packages.** The packages on offer — the CoreCluster ladder (product_line cc, the default) or the CoreStack site ladder (cs) — with the platforms each can host; a package is named by its key wherever a tool takes `package`. No prices: corestack_billing_catalogue_get has them. Scope: read.

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

## When to use it

The packages on offer — the CoreCluster ladder (product_line cc, the default) or the CoreStack site ladder (cs) — with the platforms each can host; a package is named by its key wherever a tool takes `package`. No prices: corestack_billing_catalogue_get has them.

Only packages on sale are listed: the first CoreCluster row is the smallest one on sale, and a package Corefinity has taken off sale is not in the answer (a running cluster on one keeps working and keeps its price).

`platforms[]` (the CoreStack wizard's create lists): `php_wait` (`{message}`) is on a platform only while no PHP version of its create list is open to new sites: a create that names none then waits for the platform's default instead of being refused, and `message` says so ("PHP 8.3 isn't available for new sites yet. Your site will be set up as soon as it is."). `php_versions` lists only the PHP versions a new site can be created on, each with its status, and `default` marks the one a create that names none takes, as corestack_site_provisioning_options lists them; while none is open it is empty and `php_wait` names the version a create waits for.

## Inputs

- `cluster_id` (integer, ≥ 1): Your CoreCluster: marks its current package and what a change to each would be (cc only).
- `region` (string, up to 16 characters): Only the packages offered in this region: uk, us, nl or aus.
- `product_line` (one of `cs`, `cc`): cc (CoreCluster packages, the default) or cs (CoreStack site packages).
- `platform` (one of `wordpress`, `laravel`, `magento2`, `shopware`): Only the packages that can host this platform.
- `family` (one of `general`, `optimised`): Accepted; every package is offered in both families.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "cluster_id": {
      "description": "Your CoreCluster: marks its current package and what a change to each would be (cc only).",
      "minimum": 1,
      "type": "integer"
    },
    "family": {
      "description": "Accepted; every package is offered in both families.",
      "enum": [
        "general",
        "optimised"
      ],
      "type": "string"
    },
    "platform": {
      "description": "Only the packages that can host this platform.",
      "enum": [
        "wordpress",
        "laravel",
        "magento2",
        "shopware5"
      ],
      "type": "string"
    },
    "product_line": {
      "description": "cc (CoreCluster packages, the default) or cs (CoreStack site packages).",
      "enum": [
        "cs",
        "cc"
      ],
      "type": "string"
    },
    "region": {
      "description": "Only the packages offered in this region: uk, us, nl or aus.",
      "maxLength": 16,
      "type": "string"
    }
  },
  "type": "object"
}
```

## Refusals

- `feature_off`: an input needs a feature that is switched off (for example `apply: "tonight"` while the maintenance window queue is switched off); leave that input out.
- 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_packages_list",
  "arguments": {}
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_packages_list. (Packages.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [GET /api/corestack/packages](https://docs.corefinity.com/api/reference/sites/list-packages.md)
- Guide: [Upgrade package](https://docs.corefinity.com/guides/sites/size-and-capacity/upgrade-a-package.md)
