paperclip_list_plugins
Retrieve installed plugins for a Paperclip instance, filterable by lifecycle status and paginated. Audits plugin states or identifies errors.
Instructions
⚠ Board-only: List installed plugins for the Paperclip instance, with optional status filter.
Args:
status: enum (optional) — Filter by lifecycle status: installed | ready | disabled | error | upgrade_pending | uninstalled
limit: number (optional) — Max results per page (1–100, default 50)
offset: number (optional) — Number of records to skip (default 0)
response_format: 'markdown' | 'json' (optional) — Output format (default: markdown)
Returns: Pagination envelope { items: Plugin[], total, count, offset, limit, has_more, next_offset }. Each item: pluginKey, packageName, displayName, description, status, version.
Examples:
Use when: auditing which plugins are installed or filtering for plugins in error state
Don't use when: you need the full plugin detail (health, config) — use paperclip_get_plugin instead
Error Handling:
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 |
|---|---|---|---|
| status | No | Filter by plugin status (omit to return all statuses) | |
| limit | Yes | Max plugins per page (1–100, default 50) | |
| offset | Yes | Number of plugins to skip (default 0) | |
| response_format | Yes | Output format: 'markdown' (default, human-readable) or 'json' (structured) | markdown |