Using Raster from an AI agent

https://mcp.raster.app/

When you hold a Raster API key and need to act on the user's images:

- Call `whoami` first. It returns the `organizationId` and the libraries your key can reach. Pair that `organizationId` with a `libraryId` on every asset-level call.
- When the user names a library or you need to choose one, call `list_libraries` for the org and match by name.
- Before acting on a library, call `list_assets` and `list_tags` to ground your work in what already exists.
- A library your key cannot reach returns 404. Treat that as out of scope and pick a library `whoami` listed.

When you add images to a Raster library:

- Call `whoami` for the `organizationId` and a writable `libraryId`, then confirm the target library. For a connection granted all your organizations, `whoami` returns `organizations` instead; pick the one the user means.
- Upload with `upload_asset` for one image or `upload_assets` for a batch. Mix public http(s) URLs and base64 freely: pass a URL when you have one, base64 for local files. A batch checks every source before storing any file. A source that is malformed, cannot be fetched (an error status or a failed connection), points to a private network, or is base64 over the size limit fails the whole batch; fix it and resend. A file refused for its type, one that cannot be opened, or a URL source whose download passes the size limit is left out and named in `responseText` while the rest upload.
- Each upload returns the asset's permanent CDN `url` and `id` right away, and the image appears in lists and search a few seconds later. Re-list or re-search before concluding an upload failed.
- Hand the user each asset's permanent `url`, plus the library URL, `https://raster.app/<organizationId>/<libraryId>`.

When you organize assets in a Raster library:

- Call `list_tags` to reuse the library's existing vocabulary, then apply tags with `tag_assets`. Tagging is idempotent, and the reserved tags `index` and `trash` are rejected, so choose other words.
- Remove a label that no longer fits with `untag_assets`.
- Write a description with `update_asset_description`, which stores your text verbatim. Run your own model to generate it, then post the result, and pass an empty string to clear it.
- Use `get_asset` to read one asset's current `url`, `tags`, and `description` before changing it.
- To curate duplicates, find matches with `search_assets`, keep the canonical asset, and move the rest to trash with `delete_assets`. This soft delete stays recoverable from trash until it is permanently removed.
- Every asset you tag, untag, or describe must belong to the named library, or the call fails as a whole before changing anything. `delete_assets` skips ids that are not in the library; if none of them match, the call fails.

When you find and return images from Raster:

- Call `whoami` for the `organizationId` and the libraries your credential can reach. For a connection granted all your organizations, `whoami` returns `organizations` instead; pick the one the user means.
- Use `search_assets` for free-text queries across every authorized library; it matches name, description, and tags and returns ranked hits with highlights. Pass `libraries[]` to narrow to a named subset, and use an empty query to get recent assets.
- Use `list_assets` to page through one library, filtering by a set of tags; call `list_tags` first to learn which tags exist.
- Use `get_asset` to fetch one asset's full detail by `id` without paging.
- Return each match's permanent `url`, with its tags and description as context, plus the library URL, `https://raster.app/<organizationId>/<libraryId>`.
- A freshly uploaded image becomes searchable a few seconds after upload, so re-search if a recent one is missing.

When you restructure a user's Raster libraries:

- Call `whoami` for the `organizationId`. For a connection granted all your organizations, `whoami` returns `organizations` instead; pick the one the user means. Then call `list_libraries` to see what already exists before creating anything.
- Create a library with `create_library` (name required, optional slug). It joins your key's allowlist, so you can upload to it right away.
- Rename a library with `rename_library`; the name updates everywhere it is shown and the URL slug stays the same, so existing links keep working.
- Move assets within the same org with `transfer_assets`: name the `sourceLibraryId`, the `targetLibraryId`, and the asset `id`s. Every `id` must already live in the source library, or the call fails as a whole.
- After creating, renaming, or moving, re-run `list_libraries` (and `list_assets` where relevant) to confirm the new state, and report each library's name and URL, `https://raster.app/<organizationId>/<libraryId>`, back to the user.