---
title: "corestack_demo_keep"
url: https://docs.corefinity.com/mcp/tools/corestack_demo_keep
type: tool
last_updated: 2026-11-13
feature: demos
related:
  - https://docs.corefinity.com/guides/migrate/keep-a-demo.md
---
# corestack_demo_keep

**Keep a demo.** Keep a free demo so it becomes the company's, billed from the next full hour at the price shown by corestack_demo_get; optionally on a bigger package, with add-ons or Performance servers (each billed as for any customer once it applies). Scope: write. Long-running: answers with a task.

- Scope: `write`
- Confirmation: `confirm_keep`, `confirm_billing_country`
- Runs as a task: yes

## When to use it

Keep a demo: the site or cluster becomes the company's and is billed from the next full hour at `price_after`
(`corestack_demo_get`). Ask the person first and type `confirm_keep` only once they agree: it is billable. Optionally keep
it on a bigger package (`package`, one of `upgrade_options`), with Performance servers (`family`) or with add-ons
(`addons`); each change starts right after Keep and is billed as for any customer once it applies. A started change is
handed back as a task on its operation (a CoreCluster's server type: on its queued moves, as
`corecluster_compute_family_switch` does); changes waiting behind it are listed in `upgrade.next` and start one after
another. An answer that is not a task carries `progress`, and `corestack_demo_get` follows every change to its end. A
second Keep answers the kept state. The same action as `POST /api/corestack/demos/{id}/keep`.

This tool never takes card details: a step the person finishes in the browser answers with `keep_url` to open. Two-factor
is never one of them here: connecting this server already needs it.

## Inputs

- `demo_id` (integer, at least 1, required): the demo's id from `corestack_demo_list`.
- `confirm_keep` (string, required): the site's domain, or the word `cluster` for a CoreCluster demo, typed to confirm.
- `package` (string, optional): a bigger package of the same line, for example `CS8` or `CC16`.
- `family` (string, optional): `general` (Standard servers) or `optimised` (Performance servers).
- `addons` (object, optional): add-on unit totals: `cores`, `memory_gb`, `disk_gb`, `log_storage_gb`.
- `accept_privacy` (boolean, optional): only when the refusal is `privacy_required` and the person accepts the privacy notice.
- `confirm_billing_country` (string, optional): the account's two-letter billing country, for example `GB`. Needed only
  when the demo's country was set by default and nobody has confirmed it yet (the refusal is `billing_details_required`
  and its message names the country). Tell the person which country it is and type it only once they agree it is the
  right one; to change it, they change it in the Control Panel first.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "accept_privacy": {
      "description": "Only when keep.refusal asks for it: the person accepts the privacy notice.",
      "type": "boolean"
    },
    "addons": {
      "description": "Add-on unit totals to keep it with, whole numbers: cores, memory_gb, disk_gb, log_storage_gb (no other keys).",
      "type": "object"
    },
    "confirm_billing_country": {
      "description": "Only when keep.refusal asks to confirm the billing country: the account's two-letter billing country (for example GB), typed after the person agreed to that exact country.",
      "pattern": "^[A-Za-z]{2}$",
      "type": "string"
    },
    "confirm_keep": {
      "description": "The site's domain, or the word cluster for a CoreCluster, typed to confirm. Billable.",
      "maxLength": 253,
      "type": "string"
    },
    "demo_id": {
      "description": "The demo (an id from corestack_demo_list).",
      "minimum": 1,
      "type": "integer"
    },
    "family": {
      "description": "The server type: general (Standard) or optimised (Performance).",
      "enum": [
        "general",
        "optimised"
      ],
      "type": "string"
    },
    "package": {
      "description": "A bigger package to keep it on (from upgrade_options).",
      "pattern": "^([cC][sS]|[cC][cC])[0-9]{1,3}$",
      "type": "string"
    }
  },
  "required": [
    "demo_id",
    "confirm_keep"
  ],
  "type": "object"
}
```

## Refusals

- `confirm_mismatch`: `confirm_keep` is not the site's domain (or `cluster`); ask the person for the exact value.
- `confirm_mismatch` on `confirm_billing_country`: that is not the account's billing country; the message names the one it has. Nothing is confirmed or kept.
- `demo_building`: the demo is still being set up; keep it once it is ready.
- `demo_closed`: the demo ended and its week to keep it is over; the company can start an order instead.
- `already_kept`: the demo is already kept and a change was asked; change the site or cluster with its own tools.
- `forbidden_role`: only the owner or a billing role can keep it; the message names who to ask. Corefinity staff never keep a customer's demo here.
- `billing_details_required`: the billing details are incomplete (country and a billing name; the VAT number is optional, and an EU number applies the reverse charge); open `keep_url`. When the message asks to confirm the billing country (for example "Confirm your billing country (United Kingdom) to keep your site."), the demo set that country by default: once the person agrees it is right, call again with `confirm_billing_country`, or they confirm it on `keep_url`.
- `payment_method_required`: add a card or Direct Debit first; open `keep_url` (never pass card details here).
- `privacy_required`: ask the person to accept the privacy notice, then call again with `accept_privacy`.
- `package_not_offered`: the package is not one of `upgrade_options`; choose one listed there.
- `package_platform`: the package does not run this site's platform; choose a bigger one.
- `managed_elsewhere` (message: "This site is managed by another control panel"): another control panel manages the demo's site, so use that control panel for it. This is refused before anything else about the demo, as in the Control Panel and the API: it was not kept and nothing was billed.
- 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_demo_keep",
  "arguments": {
    "demo_id": 31,
    "confirm_keep": "brightwater-studio.corestack.site",
    "package": "CS8"
  }
}
```

After the person agreed that their billing country, United Kingdom, is right:

```json
{
  "name": "corestack_demo_keep",
  "arguments": {
    "demo_id": 31,
    "confirm_keep": "brightwater-studio.corestack.site",
    "confirm_billing_country": "GB"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_demo_keep with demo_id 31, package CS8. (Keep a demo.) Tell me what it returned.
```

## The same task elsewhere

- Guide: [Keep a demo](https://docs.corefinity.com/guides/migrate/keep-a-demo.md)
