---
title: "corestack_node_runtime_copy"
url: https://docs.corefinity.com/mcp/tools/corestack_node_runtime_copy
type: tool
last_updated: 2026-11-13
feature: node-runtime
related:
  - https://docs.corefinity.com/api/reference/runtime/copy-node-runtime.md
  - https://docs.corefinity.com/guides/sites/software-and-services/node-js.md
---
# corestack_node_runtime_copy

**Copy Node.js settings to other environments.** Copy a row's Node.js version, global packages and follow mode to other environments of the same site. One task follows every target's change and answers each target's outcome. Production targets need confirm_production; a target moved onto an end-of-life major needs acknowledge. Scope: write. Also needs exec when it turns on a Node package's install scripts. Long-running: answers with a task.

- Scope: `write`
- Also needs `exec` when exec
- Confirmation: `confirm_production`
- Runs as a task: yes

## When to use it

Copy a row's Node.js version, global packages and follow mode to other environments of the same site. One task follows every target's change and ends with each target's outcome (`applied`, `failed`, `refused` or `queued`, with the reason). A part a target refuses (packages while commands are off, packages whose install scripts the target's command line has too little memory for (`scripts_memory`), an end-of-life version without the acknowledgement) is named and the other parts still apply there. Production targets need `confirm_production: true`. Copying packages that turn install scripts on for a target also needs exec.

## Inputs

- `site_id` (integer, ≥ 1, required): the source row.
- `target_site_ids` (array of integers, 1 to 20, required): other environments of the same site, each once.
- `parts` (array of `version`, `packages`, `follow_repository`, required)
- `confirm_production` (boolean)
- `acknowledge` (array of `eol`)

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "acknowledge": {
      "description": "What ack_required named, once you have told the person.",
      "items": {
        "enum": [
          "eol"
        ],
        "type": "string"
      },
      "maxItems": 1,
      "type": "array"
    },
    "confirm_production": {
      "description": "Required when a target is a production environment.",
      "type": "boolean"
    },
    "parts": {
      "description": "What to copy.",
      "items": {
        "enum": [
          "version",
          "packages",
          "follow_repository"
        ],
        "type": "string"
      },
      "maxItems": 3,
      "minItems": 1,
      "type": "array"
    },
    "site_id": {
      "description": "The source row: the site or one of its environments.",
      "minimum": 1,
      "type": "integer"
    },
    "target_site_ids": {
      "description": "The rows to copy to: other environments of the same site, each once.",
      "items": {
        "minimum": 1,
        "type": "integer"
      },
      "maxItems": 20,
      "minItems": 1,
      "type": "array"
    }
  },
  "required": [
    "site_id",
    "target_site_ids",
    "parts"
  ],
  "type": "object"
}
```

## Refusals

- `copy_target_invalid`: a target is not another environment of this site.
- `confirm`: a target is production; send `confirm_production: true`.
- `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_node_runtime_copy",
  "arguments": {
    "site_id": 4211,
    "target_site_ids": [4212, 4213],
    "parts": ["version", "packages"]
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_node_runtime_copy with site_id 4211, target_site_ids [4212,4213], parts ["version","packages"]. (Copy Node.js settings to other environments.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [POST /api/corestack/sites/{site}/node-runtime/apply-to](https://docs.corefinity.com/api/reference/runtime/copy-node-runtime.md)
- Guide: [Node.js configuration](https://docs.corefinity.com/guides/sites/software-and-services/node-js.md)
