# collections

> Reference for the collections tool: shelves that hold any kind of asset in your library.

Source: https://prompt-verse.io/docs/reference/collections/

A collection holds assets of any kind. Removing an item never touches the asset, and deleting a collection leaves its assets where they are.

Call it as `geenius_promptverse(tool: "collections", action: "<action>", args: {...})` through Geenius OS, or as the `collections` tool of the Prompt Verse MCP server with `action` and `args`.

## Actions

| Action | What it does |
|---|---|
| `create` | A new, empty collection. |
| `list` | Your collections with their item references. |
| `get` | One collection with its items resolved to titles. |
| `add` | Put an asset on it. |
| `remove` | Take an asset off it. The asset stays. |
| `update` | Rename it or change its line. |
| `delete` | Delete the collection. Its assets stay. |

## Arguments we have checked

### collections · create

A new, empty collection.

- `title` (required): Its name.
- `description`: An optional line.

### collections · get

One collection with its items resolved to titles.

- `id` (required): Collection id.

### collections · add

Put an asset on it.

- `id` (required): Collection id.
- `kind` (required): prompt, agent, workflow, skill or mcpTool.
- `asset_id` (required): Asset id.

### collections · remove

Take an asset off it. The asset stays.

- `id` (required): Collection id.
- `kind` (required): Asset kind.
- `asset_id` (required): Asset id.

### collections · update

Rename it or change its line.

- `id` (required): Collection id.
- `title`: New name.
- `description`: New line.

### collections · delete

Delete the collection. Its assets stay.

- `id` (required): Collection id.

> [!TIP]
> Ask for the exact arguments of any action with `action: "help", of: "create"`. The server answers from its own definitions, so that answer is always current.