paperclip_install_plugin
Install a plugin into the Paperclip instance from an npm package or local filesystem path.
Instructions
⚠ Board-only: Install a plugin from npm into the Paperclip instance.
Args:
packageName: string — npm package name (e.g. '@paperclipai/plugin-hello-world-example') or local filesystem path when isLocalPath is true
version: string (optional) — Specific version to install (e.g. '1.2.3'); omit for latest
isLocalPath: boolean (optional) — Set true when packageName is a local filesystem path
Returns: Installation result object with pluginKey, packageName, status, and message confirming the install outcome.
Examples:
Use when: adding a new plugin capability to the Paperclip instance from the npm registry or a local build
Don't use when: the plugin is already installed — use paperclip_enable_plugin to re-activate a disabled plugin
Error Handling:
400: install failed (npm error) → verify packageName is a valid npm package that exists in the registry
401: authentication failed → check PAPERCLIP_API_KEY
403: permission denied → this tool requires a board (human-user) API key
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| packageName | Yes | npm package name to install (e.g. '@paperclipai/plugin-hello-world-example') | |
| version | No | Specific package version to install (e.g. '1.2.3'); omit for latest | |
| isLocalPath | No | Set true when packageName is a local filesystem path rather than an npm package name |