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

**Show automatic upgrades.** Reads whether your company lets its CoreClusters grow automatically when a new site or environment would not fit, and gives an environment too small for a copy a larger size: on or off, the monthly limit on new upgrades, what this month's new upgrades added and the upgrades made. Each upgrade stays on the monthly bill until it is changed back. Scope: read.

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

## When to use it

Read whether your company has turned on automatic upgrades. While they are on, a new site or environment that would take a CoreCluster past 90 % of its package does not stop: the cluster first gets the smallest add-on raise that makes room (or, when add-ons cannot, the next package), bought and added to the monthly bill within the company's monthly limit, and the create goes ahead. When the server a create needs cannot be added in the region yet, or the create needs a larger server than any its CoreCluster runs on today, or the region's servers are not taking new sites for the moment, the create is accepted and waits, and nothing is bought while it waits: the upgrade is made once it can go on, within the monthly limit as it is then. An automatic upgrade adds room on the servers the CoreCluster runs on, never a larger server. While they are off, that create is refused: `invalid_arguments` on `tier` for a site created on its own or an environment, `capacity_blocked` for a site created with its environments. While they are on, a create whose server the region cannot take at all (not merely yet) buys nothing and is refused exactly as it would be with them off: `invalid_arguments` on `tier` for a site created on its own or an environment; for a site created with its environments, the first refusal its rows meet in order (the site, then each environment), `compute_blocked` for a server the region cannot take or `capacity_blocked` for a row past the package. A copy into an environment (never production) that is too small for it gives that environment a larger size first, within the same limit. Each upgrade stays on the monthly bill until it is changed back; the limit caps only what new upgrades add in one calendar month (UTC) and starts again on the 1st. Takes no company: it is the token's company.

The answer says whether they can be used now (`available`, and `unavailable_reason` when not), whether they are on (`enabled`) and buying (`active`), the `monthly_limit` (on what new upgrades may add each month), `spent_this_month` (what this month's new upgrades added), `remaining_this_month` and `max_monthly_limit` (the highest limit the company may set now: never above 100,000.00 in its billing currency; each `{amount, currency}`), `purchases_this_month` against `max_purchases_per_month`, the UTC `month`, when they were agreed to (`consented_at`), whether this person may turn them on or raise the limit (`can_change`, the company's owners and billing contacts) or turn them off (`can_turn_off`), and this month's automatic upgrades, newest first (`recent`).

## Inputs

None.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {},
  "type": "object"
}
```

## Refusals

- 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_company_auto_upgrades_get",
  "arguments": {}
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_company_auto_upgrades_get. (Show automatic upgrades.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [GET /api/corestack/companies/{company}/auto-upgrades](https://docs.corefinity.com/api/reference/sites/get-auto-upgrades.md)
- Guide: [Upgrade package](https://docs.corefinity.com/guides/sites/size-and-capacity/upgrade-a-package.md)
