stac_download_composite
Create a multi-band composite from a satellite scene by specifying bands in RGB order. Optionally crop, set format, or apply cloud masking.
Instructions
Download a multi-band composite from a scene.
Creates a composite from any combination of bands. Band order determines RGB channel mapping (first=R, second=G, third=B).
Args: scene_id: Scene identifier from a previous stac_search call bands: Band names for the composite (order = R,G,B channels). Common recipes: - ["nir", "red", "green"] — false colour infrared (vegetation=red) - ["swir16", "nir", "red"] — agriculture (crops=bright green) - ["swir16", "swir22", "red"] — geology/minerals composite_name: Label for the composite (e.g., "false_color_ir") bbox: Optional crop bbox in EPSG:4326 [west, south, east, north] output_format: "geotiff" (default, lossless) or "png" (8-bit preview) cloud_mask: Apply SCL-based cloud masking (Sentinel-2 only) output_mode: Response format - "json" (default) or "text"
Returns: JSON with artifact_ref for the composite
Tips for LLMs: - Use stac_describe_collection to see pre-defined composite recipes - Band order matters: first band → Red, second → Green, third → Blue - For true-colour RGB, use stac_download_rgb instead (simpler) - For single-value analysis, use stac_compute_index (e.g., NDVI)
Example: false_color = await stac_download_composite( scene_id="S2B_...", bands=["nir", "red", "green"], composite_name="false_color_ir" )
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": {
"scene_id": "<scene_id>",
"bands": "<bands>"
},
"name": "stac_download_composite"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bbox | No | ||
| bands | Yes | ||
| scene_id | Yes | ||
| cloud_mask | No | ||
| output_mode | No | json | |
| output_format | No | geotiff | |
| composite_name | No | custom |