npm packages

Neptune DXP - Open Edition supports adding and importing npm packages for use in server scripts and other server-side contexts. The MCP server provides tools to list currently installed modules and to add new ones by name.

Required role: npm-modules.

If your user account does not have this role, every tool in this group fails immediately with an access denied error. Contact an administrator to request the role, or see Access control for more information on how roles are enforced.

Available tools

Parameters are shown with their type and a short description.

Tool Description Parameters

list_npm_modules

List all npm packages registered in Neptune DXP - Open Edition. Returns id, contextName (the require() name), version, description, path, and isLocal flag.

None

get_npm_module

Retrieve an npm package by its ID, including the scripts and AI agents that reference it.

id (string)

install_npm_module

Install an npm package into the Neptune DXP - Open Edition server-script module directory and register it. Runs npm install, verifies the module loads, then creates the npm_modules record so scripts can require() it.

  • name (string): npm package name; e.g. "lodash" or "@scope/pkg".

  • version (string, optional): Semver version, range, or dist-tag; e.g. "4.17.21", "^4.0.0", "latest".

  • description (string, optional): Description for the registered module.

  • installParameters (string[], optional): Additional parameters to pass to npm install.

uninstall_npm_module

Uninstall an npm package by its ID. Runs npm uninstall and removes the npm_modules record.

id

Related topics