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

**A demo.** Read one free demo: its state and dates, what it costs once kept, whether it can be kept now (and why not), and the bigger packages it can be kept on with their prices. Scope: read.

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

## When to use it

Read one demo before keeping it: its dates, `price_after` (what it costs a month once kept, ex VAT), whether it can be
kept now and why not (`keep.refusal`), and `upgrade_options`: the bigger packages it can be kept on, each priced. The same
demo as `GET /api/corestack/demos/{id}`.

Once kept, `progress` says where each change the Keep asked for stands, those the demo starts later included:
`progress.state` is `applying` while one waits or applies, then `done`, `failed` (a change did not apply; billing stays at
the kept price for it) or `started` (nothing here to follow). Each of `progress.changes` has its `plan`, `kind`
(`package`, `family`, `addons`), `state` and `operation_id` (null for a CoreCluster's server type, followed through its
moves). Call again every 10 seconds or so until it is no longer `applying`.

## Inputs

- `demo_id` (integer, at least 1, required): the demo's id from `corestack_demo_list`.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "demo_id": {
      "description": "The demo (an id from corestack_demo_list).",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "demo_id"
  ],
  "type": "object"
}
```

## Refusals

- `tenant_mismatch`: no demo the person may see has this id. Another company's demo and an id that does not exist both answer this.
- 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_get",
  "arguments": {
    "demo_id": 31
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_demo_get with demo_id 31. (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)
