---
title: "corestack_enterprise_copy_get"
url: https://docs.corefinity.com/mcp/tools/corestack_enterprise_copy_get
type: tool
last_updated: 2026-11-13
feature: enterprise-copies
related:
  - https://docs.corefinity.com/guides/corestack-enterprise/websites-and-environments.md
---
# corestack_enterprise_copy_get

**A CoreStack Enterprise copy.** One copy of a CoreStack Enterprise environment into a CoreCluster site: where it is, what it copied and whether it can be finished. Scope: read.

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

## When to use it

Read one copy of a CoreStack Enterprise environment into a CoreCluster site: where its run is (`phase`, `state`,
`step`, and its operation on the site), what it copied (sizes, how long it took, when it was neutralised, how many
dangling links and unreadable files it met), whether the site was proven unactivated, and whether it can be finished
(`finishable`). A failed copy carries `failure_reason` and `error`, a plain sentence saying what happened and what to do
next; a re-sync names the copy it follows (`copy_of`) and the one that followed it (`superseded_by`). This is the status
tool of the create and re-sync tasks.

The public API's `GET /api/enterprise-copies/{copy}` answers the same.

## Inputs

- `copy_id` (integer, 1 to 2147483647, required)

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "copy_id": {
      "maximum": 2147483647,
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "copy_id"
  ],
  "type": "object"
}
```

## Refusals

- `tenant_mismatch`: the copy does not exist, its environment was deleted, or its environment or its site is not yours.
- `pin_refused` (`company_write`): a token limited to some sites cannot reach a CoreStack Enterprise environment.
- and the refusals every tool can answer: `scope_required`, `invalid_arguments`, `rate_limited`,
  `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).

## Example

```json
{
  "name": "corestack_enterprise_copy_get",
  "arguments": {
    "copy_id": 41
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_enterprise_copy_get with copy_id 41. (A CoreStack Enterprise copy.) Tell me what it returned.
```

## The same task elsewhere

- Guide: [Websites and environments](https://docs.corefinity.com/guides/corestack-enterprise/websites-and-environments.md)
