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

**Look up an npm package.** Before adding a global package: whether it exists on the public npm registry, the exact version a selector resolves to, its description and licence, whether it has an install script, whether it is deprecated, and its latest version. Scope: read.

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

## When to use it

Before adding a global package: whether it exists on the public npm registry, the exact version a selector resolves to, its description and licence, whether it has an install script, whether it is deprecated and its latest version. `exists: null` means the registry could not be asked; say so and let the person decide. No row is needed.

## Inputs

- `name` (string, required): the npm package name, e.g. `sass` or `@angular/cli`.
- `selector` (string): a version, range or dist-tag (default `latest`).

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "name": {
      "description": "The npm package name, e.g. sass or @angular/cli.",
      "maxLength": 214,
      "minLength": 1,
      "type": "string"
    },
    "selector": {
      "description": "A version, range or dist-tag (default latest).",
      "maxLength": 255,
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}
```

## Refusals

- `package_spec_invalid`: a URL, git, file, alias or `user/repo` spec; only public registry packages can be installed.
- 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_package_lookup",
  "arguments": {
    "name": "sharp",
    "selector": "0.34"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_node_package_lookup with name sharp, selector 0.34. (Look up an npm package.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [GET /api/corestack/node/packages/lookup](https://docs.corefinity.com/api/reference/runtime/get-node-package.md)
- Guide: [Node.js configuration](https://docs.corefinity.com/guides/sites/software-and-services/node-js.md)
