editor_screenshot
Capture screenshots of Godot editor viewports or running games. Supports 3D/2D viewports, cinematic cameras, and game output with configurable resolution and camera controls.
Instructions
Capture a screenshot of the Godot editor viewport or running game.
Picking a source: the default "viewport" captures the editor's 3D
viewport, which is empty if the edited scene has no Node3D anywhere in
the tree (or no scene is open). Those cases return EDITOR_NOT_READY
with error.data = {editor_state: "viewport_not_3d", scene_root_type}
and an actionable error.message — switch to "cinematic" if the
scene has a Camera3D, or open a scene with 3D content.
Sources:
"viewport" (default): editor 3D viewport. Requires Node3D content in the edited scene (root or any descendant); see above for the no-3D-content / no-scene error shape.
"viewport_2d": editor 2D viewport. Use for 2D scenes. Not compatible with view_target/coverage/elevation/azimuth/fov.
"cinematic": render edited scene through its active Camera3D (no editor gizmos). Prefers a Camera3D marked
current; falls back to the first Camera3D found in a depth-first walk. NODE_NOT_FOUND only when the scene contains no Camera3D at all."game": running game's framebuffer (only when project is running).
include_image=True (default) returns an MCP ImageContent block.
view_target (comma-separated Node3D paths) reframes editor camera;
AABB metadata always returned. coverage=True with view_target
captures perspective + orthographic top-down references.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fov | No | Camera FOV in degrees. Tight 20-30 = zoom; 60-75 = context. | |
| source | No | "viewport" | "viewport_2d" | "cinematic" | "game". Default "viewport". | viewport |
| azimuth | No | Camera azimuth in degrees (0=front, 90=right). | |
| coverage | No | With view_target, capture two reference shots + AABB. | |
| elevation | No | Camera elevation in degrees (0=level, 90=overhead). | |
| session_id | No | Optional Godot session to target. Empty = active session. | |
| view_target | No | Node3D scene path(s) to frame, comma-separated. | |
| include_image | No | Return image data. Default True. | |
| max_resolution | No | Longest-edge resolution. Default 640. 0 = full res. |