quicklook
Return a scene's quicklook PNG as an image block.
Prefers a baked catalog preview (``preview="auto"``, the default) so a
public host can show the radar scene without proxying Umbra COGs.
**A baked preview is typically 512 px** (the published weekly sidecar).
``max_size`` applies only to a fresh ``preview="render"`` stream; when a
cached thumbnail is smaller than requested, the caption says
``max_size`` was ignored *and* includes a JSON
``{"image": {source, width, height, requested_max_size, substituted}}``
sidecar. For a higher-resolution picture (typically 1024 px), run a
local ``uvx --from 'umbra-py[mcp]' umbra-mcp`` server, or download the
GEC href from ``get_item``. ``preview="baked"`` refuses rather than
stream; ``preview="render"`` always streams (needs ``[viz]``, refused
on ``umbra serve --public``).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "quicklook"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| db | No | Decibel stretch for a fresh render. Default false. A baked preview is always decibel. | |
| url | Yes | STAC JSON URL or index item id. The public host also accepts a product filename or acquisition stem that is in the index. | |
| asset | No | Product to show. Default GEC. A baked preview is used only when its recorded product matches, or when it recorded none and this is GEC. | GEC |
| preview | No | auto (default) uses a baked preview when present, else renders. baked refuses if none. render always streams a COG and is refused on the public host. | auto |
| max_size | No | Longest side in pixels for a fresh render. Default 1024. Ignored when a smaller baked preview is returned. |