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

**Turn automatic upgrades on or off.** Turns automatic upgrades on or off for your company, or changes the monthly limit. While on, a CoreCluster that a new site or environment would not fit gets add-ons or the next package first, and an environment too small for a copy gets a larger size first. Each upgrade stays on the monthly bill until it is changed back; the limit caps what new upgrades add in one calendar month. Scope: write.

- Scope: `write`
- Confirmation: `confirm_spend`
- Runs as a task: no

## When to use it

Turn automatic upgrades on or off for your company, or change the monthly limit. While they are on, a new site or environment that would take a CoreCluster past 90 % of its package first gets the smallest add-on raise that makes room (more cores, RAM or disk), or the next package, bought and added to the monthly bill, and the create goes ahead. A copy into an environment (never production) that is too small for it gives that environment a larger size first, the same way. Read corestack_company_auto_upgrades_get first.

Each upgrade stays on the monthly bill until it is changed back. The limit caps only what new automatic upgrades can add to the bill in one calendar month (UTC), and it starts again on the 1st: upgrades from earlier months stay on the bill and do not count towards it, so the bill can grow by up to the limit every month. A new site or environment created by anyone who can create them in the company's CoreClusters, including Corefinity staff working for the company, can lead to an upgrade.

Turning them on, or raising the limit, charges the company without asking each time. Before you send `confirm_spend: true`, show the person this agreement, word for word, with the limit, and send it only after they agreed:

> I agree that automatic upgrades may be bought and added to our monthly bill without asking each time: CoreCluster add-ons (more cores, RAM or disk) or the next package when a new site or environment would not fit, and a larger size for a non-production environment that is too small for a copy into it. Each upgrade stays on the monthly bill until it is changed back. The limit caps what new automatic upgrades can add to the bill in one calendar month (UTC), and it starts again on the 1st. A new site or environment created by anyone who can create them in our CoreClusters, including Corefinity staff working for us, can lead to an upgrade.

Only the company's owners and billing contacts can do this. Turning them off, or lowering the limit, needs no `confirm_spend`. Takes no company: it is the token's company, so a token limited to some sites or clusters is `pin_refused`.

## Inputs

- `enabled` (boolean, required): true to turn automatic upgrades on, false to turn them off.
- `monthly_limit` (number): the most that new automatic upgrades may add to the monthly bill in one calendar month (UTC), in the company's billing currency, two decimal places at most, from 1 up to `max_monthly_limit` (never above 100,000.00). Upgrades from earlier months stay on the bill and do not count towards it. Needed to turn them on.
- `confirm_spend` (boolean): true once the person agreed to the agreement above. Needed to turn them on or raise the limit.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "confirm_spend": {
      "description": "true once the person agreed to the agreement in this tool's guide: upgrades bought and added to the monthly bill without asking each time, each staying on it until changed back. Needed to turn them on or raise the limit.",
      "type": "boolean"
    },
    "enabled": {
      "description": "true to turn automatic upgrades on, false to turn them off.",
      "type": "boolean"
    },
    "monthly_limit": {
      "description": "The most that new automatic upgrades may add to the monthly bill in one calendar month (UTC), in the company's billing currency, from 1 up to max_monthly_limit (never above 100,000.00), two decimal places at most; upgrades from earlier months stay on the bill and do not count. Needed to turn them on.",
      "type": "number"
    }
  },
  "required": [
    "enabled"
  ],
  "type": "object"
}
```

## Refusals

- `billing_forbidden`: only the company's owners and billing contacts can turn on automatic upgrades or raise the limit; anyone else without billing rights cannot change them at all. Ask an owner or billing contact.
- `auto_upgrades_unavailable`: automatic upgrades cannot be turned on now (not available yet, billing in the Control Panel is not available for the company, or it has no billing account); the message says which.
- `busy`: an automatic upgrade is being made for the company right now; try again in a moment.
- `invalid_arguments` on `enabled` (missing or not true / false), `monthly_limit` (missing when turning them on, below 1, above `max_monthly_limit` or more than two decimal places; the message gives the range, e.g. "Set a monthly limit from £1.00 to £100,000.00, in whole pence at most.") or `confirm_spend` (not true when turning them on or raising the limit); `fields` names the argument.
- 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_set",
  "arguments": {
    "enabled": true,
    "monthly_limit": 250,
    "confirm_spend": true
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_company_auto_upgrades_set with enabled true, monthly_limit 250. (Turn automatic upgrades on or off.) Tell me what it returned.
```

## The same task elsewhere

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