picsio-asset-searchlisted
Install: claude install-skill TopTechPhoto/picsio-mcp-plugin
# Searching a Pics.io library
Pics.io is a digital asset management (DAM) system. The library is a tree of
**collections** (folders) holding **assets** (files). The MCP tools are
**read-only** — you can find and describe assets, never change them.
## Tools
| Tool | What it returns |
| --- | --- |
| `picsio_search_collections` | Collections by name/path/description, or the children of one collection. Gives `id`, `name`, `description`, `path`, `has_child`, `archived`. |
| `picsio_search_assets` | Assets matching text plus filters. Gives `id`, `name`, file type, collections and a preview URL. |
| `picsio_get_asset` | Full metadata for one asset id — keywords, description, collections, dimensions, preview URL. |
| `picsio_get_asset_preview` | A safe preview URL for one asset id. Rejects oversized and unsupported files with an explanation. |
## The one rule that matters: collections first
Free-text search over a large library is noisy. A collection id is a precise
filter. So for anything that names a **topic, campaign, client, brand, event,
product line or team**, do this:
1. `picsio_search_collections` with that name → pick the matching collection(s).
2. `picsio_search_assets` with `collection_ids: [...]` plus any other filters.
Skip step 1 only when the user names a specific file, or when the query is
genuinely library-wide ("every video uploaded last week").
```
User: "Find the hero shots from the autumn campaign."
picsio_search_collections { query: "autumn campaign" }