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

**Check Node.js packages.** Check a row's global npm packages: which have a newer version within their selector or beyond it, and the security advisories npm audit reports for the installed set. Changes nothing installed. Scope: read.

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

## When to use it

Check a row's global packages: which have a newer version within their selector (`wanted`) or beyond it (`latest`), and the security advisories `npm audit` reports for the installed set (`audit: audit_unavailable` when the installed set has no lockfile). Nothing installed changes.

## Inputs

- `site_id` (integer, ≥ 1, required)

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "site_id": {
      "description": "The row: the site or one of its environments.",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "site_id"
  ],
  "type": "object"
}
```

## Refusals

- `switched_off`: commands are switched off.
- `not_running`, `busy`: the site is not running, or another command is.
- `upstream_unavailable`: the site's check answered something the Control Panel cannot read; try again later.
- `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_packages_check",
  "arguments": {
    "site_id": 4211
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_node_packages_check with site_id 4211. (Check Node.js packages.) Tell me what it returned.
```

## The same task elsewhere

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