screenshot_query
List cached screenshots with metadata and filter by tag, window, or time range. Retrieve capture IDs and URIs without re-reading pixels.
Instructions
List screenshots already saved in the disk-cache WITHOUT re-reading any pixels. The screenshot tools return each capture as a cheap by-ref link (screenshot://by-ref/{captureId}); this lists what is in the cache — captureId + by-ref uri, dimensions, size in bytes, timestamp, and tag/window — so you can find and re-open a specific earlier capture, or check how much the cache holds before reclaiming space with screenshot_gc. The response also carries whole-cache totals (totalCaptures / totalBytes). Reading a capture's bytes still costs tokens, so open a by-ref link only when you actually need to inspect the pixels. Filter by tag (case-insensitive) / windowUuid / since / until; page with limit (default 50) and offset. Results are newest-first and never include a filesystem path.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | Filter to captures stored under this tag (case-insensitive). Omit to list all. | |
| limit | No | Maximum rows to return, newest first (default 50, max 500). | |
| since | No | Only captures taken at/after this time (epoch milliseconds, inclusive). | |
| until | No | Only captures taken at/before this time (epoch milliseconds, inclusive). | |
| offset | No | Rows to skip from the newest end, for paging (default 0). | |
| include | No | Optional response-shape opt-in. `['envelope']` returns the self-documenting envelope (`_version` / `data` / `as_of` / `confidence`). `['raw']` forces raw shape (overrides DESKTOP_TOUCH_ENVELOPE=1 server default). Default behaviour is raw shape (compat with existing clients). | |
| windowUuid | No | Filter to captures of a specific window (the window's stable id). |