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

**Set a site's add-ons.** Set a CoreStack site's four add-on allowances — extra cores, memory, disk and log storage — to the values given (a decrease too), now or tonight. Price it first with corestack_billing_quote_preview. Scope: write. Long-running: answers with a task.

- Scope: `write`
- Runs as a task: yes

## When to use it

Set a CoreStack site's four add-on allowances — extra cores, memory, disk and log storage — to the values given (a decrease too), now or tonight. Price it first with corestack_billing_quote_preview.

## Inputs

- `site_id` (integer, ≥ 1, required)
- `cores` (integer, 0–512, required)
- `memory_gb` (integer, 0–4096, required)
- `disk_gb` (integer, 0–65536 in MCP, required)
- `log_storage_gb` (integer, 0–65536, required)
- `apply` (one of `now`, `tonight`, default `"now"`): now (the default) or tonight, in the maintenance window, with everything else queued for the row.
- `quote_id` (string, pattern `^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$`): A quote from corestack_billing_quote_preview (optional): the write refuses with stale if the price moved.

MCP refuses `disk_gb` above 65536 during schema validation, before the service runs. REST and the domain allow up to 102400 GB (100 TB), subject to their validation rules; that higher range is unavailable through this MCP tool. Values within the MCP range must still meet the domain's steps and other checks.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "apply": {
      "default": "now",
      "description": "now (the default) or tonight, in the maintenance window, with everything else queued for the row. window: the row's next maintenance window (tonight is kept as its alias).",
      "enum": [
        "now",
        "window",
        "tonight"
      ],
      "type": "string"
    },
    "cores": {
      "maximum": 512,
      "minimum": 0,
      "type": "integer"
    },
    "disk_gb": {
      "maximum": 65536,
      "minimum": 0,
      "type": "integer"
    },
    "log_storage_gb": {
      "maximum": 65536,
      "minimum": 0,
      "type": "integer"
    },
    "memory_gb": {
      "maximum": 4096,
      "minimum": 0,
      "type": "integer"
    },
    "quote_id": {
      "description": "A quote from corestack_billing_quote_preview (optional): the write refuses with stale if the price moved.",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
      "type": "string"
    },
    "site_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "site_id",
    "cores",
    "memory_gb",
    "disk_gb",
    "log_storage_gb"
  ],
  "type": "object"
}
```

## Refusals

- `addon_bounds`: the add-on amount is outside what the package allows; choose a value inside its bounds.
- `addon_below_usage`: the add-on would be smaller than what the row already uses; choose a larger amount or free space first.
- `same_addons`: the add-ons are already set to these values; nothing to change.
- `billing_forbidden`: the person has no billing role in the company; ask a company owner or billing member.
- `forbidden`: the Control Panel refuses this person the action and names no reason; stop.
- `demo_keep_required`: the site or cluster is a free demo that is not kept yet, and this change costs money: it starts once the demo is kept. Ask the person to keep it (`corestack_demo_keep`, or open `keep_url`); `change` names this change and what it would cost a month once kept.
- `managed_elsewhere` (message: "This site is managed by another control panel"): another control panel manages this site, so use that control panel for it. This is refused before anything else about the site, as in the Control Panel and the API. Nothing was done.
- 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_site_addons_set",
  "arguments": {
    "site_id": 4211,
    "cores": 1,
    "memory_gb": 1,
    "disk_gb": 1,
    "log_storage_gb": 1
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_site_addons_set with site_id 4211, cores 1, memory_gb 1, disk_gb 1, log_storage_gb 1. (Set a site's add-ons.) Tell me what it returned.
```

## The same task elsewhere

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