---
title: "corestack_capacity_check"
url: https://docs.corefinity.com/mcp/tools/corestack_capacity_check
type: tool
last_updated: 2026-11-13
feature: site-create
related:
  - https://docs.corefinity.com/api/reference/sites/check-cluster-site-capacity.md
  - https://docs.corefinity.com/guides/sites/create-and-manage/create-a-site.md
---
# corestack_capacity_check

**Check CoreStack capacity.** Check whether a new CoreStack site fits a region: the package, the server type and the staging environments, and what would block it. Nothing is reserved. Use corestack_in_corecluster_site_create when the company has a CoreCluster with space (check corecluster_capacity_check), otherwise corestack_site_create. Scope: read.

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

## When to use it

Check whether a new CoreStack site fits a region: the package, the server type and the staging environments, and what would block it. Nothing is reserved. Use corestack_in_corecluster_site_create when the company has a CoreCluster with space (check corecluster_capacity_check), otherwise corestack_site_create.

A site the region has to make room for first, for a server, for storage or for the site's disks, is not blocked: `ok` stays true and `warnings` says "Setting up your site. This can take a little longer." (`node_pending` while a server is prepared, `storage_pending` while storage room is found). The create waits and carries on by itself.

## Inputs

- `region` (string, 2–4 characters, required): uk, us, nl or aus.
- `package` (string, up to 16 characters, required): A CoreStack package key, for example CS4.
- `compute_family` (one of `general`, `optimised`, default `"general"`): general: Standard; optimised: Performance.
- `environments` (array of objects, up to 10 items): The staging environments created with the site, by size (corestack_uat_sizes_list).
  - `uat_size` (string, up to 16 characters, required)

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "compute_family": {
      "default": "general",
      "description": "general: Standard; optimised: Performance.",
      "enum": [
        "general",
        "optimised"
      ],
      "type": "string"
    },
    "environments": {
      "description": "The staging environments created with the site, by size (corestack_uat_sizes_list).",
      "items": {
        "additionalProperties": false,
        "properties": {
          "uat_size": {
            "maxLength": 16,
            "type": "string"
          }
        },
        "required": [
          "uat_size"
        ],
        "type": "object"
      },
      "maxItems": 10,
      "type": "array"
    },
    "package": {
      "description": "A CoreStack package key, for example CS4.",
      "maxLength": 16,
      "type": "string"
    },
    "region": {
      "description": "uk, us, nl or aus.",
      "maxLength": 4,
      "minLength": 2,
      "type": "string"
    }
  },
  "required": [
    "region",
    "package"
  ],
  "type": "object"
}
```

## Refusals

- `forbidden`: the Control Panel refuses this person the action and names no reason; stop.
- `no_platform_cluster`: there is no platform cluster in that region; choose another region.
- `compute_blocked`: the compute this needs is not available right now; try another size or later.
- 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_capacity_check",
  "arguments": {
    "region": "uk",
    "package": "CS4",
    "environments": [
      {
        "uat_size": "xsmall"
      }
    ]
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_capacity_check with region uk, package CS4, environments [{"uat_size":"xsmall"}]. (Check CoreStack capacity.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [POST /api/corestack/capacity/check](https://docs.corefinity.com/api/reference/sites/check-cluster-site-capacity.md)
- Guide: [Create a site](https://docs.corefinity.com/guides/sites/create-and-manage/create-a-site.md)
