get_viewport_screenshot
Read-only
Capture the Blender 3D viewport as an inline image. Optionally set view direction and fit mode to frame content.
Instructions
[QUERY] Capture the Blender 3D viewport and return the image inline. Optionally aim the viewport first: view sets the direction (top/bottom/front/back/left/right = orthographic axis views, 'iso' = perspective isometric, 'camera' = scene camera) and fit frames the content ('all' or 'selected'). The render is downscaled so the longest edge fits max_size (default 800 px) and encoded as JPEG by default, keeping the response safely under MCP size limits. Scene render settings are restored afterwards; the viewport orientation persists.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fit | No | Frame content before capturing: 'all' = everything, 'selected' = current selection. Combines with view. | |
| view | No | Aim the viewport before capturing. Axis names give orthographic views; 'iso' a perspective isometric; 'camera' the scene camera. Omit to keep the current orientation. | |
| format | No | 'jpeg' (default, small) or 'png' (lossless, large). | jpeg |
| quality | No | JPEG quality. Ignored for png. | |
| max_size | No | Longest image edge in pixels. The render is only downscaled, never upscaled. Values above ~1200 with format='png' may exceed the response size cap. | |
| max_objects | No | Cap for include_objects; largest boxes are kept. | |
| include_objects | No | Also return, as text, screen-space 2D bounding boxes keyed by GlobalId for objects in frame (normalized 0-1, origin top-left). Use this for spatial reasoning when the image channel is unavailable or for grounding what the image shows. |