create_camera
Creates a new camera in the active Blender scene with configurable lens, clipping planes, sensor, and transform, and can set it as the active camera.
Instructions
Create a new camera in the active Blender scene with configurable focal length (lens), clipping planes, sensor width, and world transform. Can automatically set the new camera as active.
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": {
"name": "<name>"
},
"name": "create_camera"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dof | No | Depth of field settings. | |
| lens | No | Focal length in millimeters (1.0 to 5000.0). | |
| name | Yes | Unique name for the new camera object. | |
| type | No | Alias for camera projection type: 'PERSP', 'ORTHO', or 'PANO'. | |
| shift_x | No | Horizontal camera shift (-10.0 to 10.0). | |
| shift_y | No | Vertical camera shift (-10.0 to 10.0). | |
| task_id | No | Optional task or workflow identifier. | |
| use_dof | No | Enable depth of field. | |
| approved | No | DEPRECATED / UNTRUSTED: Client-supplied approval flags in tool arguments are not trusted as proof of human consent. | |
| clip_end | No | Far clipping distance in Blender units. | |
| location | No | 3D world coordinates [x, y, z] for camera placement. | |
| clip_start | No | Near clipping distance in Blender units (> 0.0001). | |
| sensor_fit | No | Sensor fit mode: 'AUTO', 'HORIZONTAL', or 'VERTICAL'. | AUTO |
| set_active | No | Whether to assign this camera as the active scene camera. | |
| camera_type | No | Camera projection type: 'PERSP' (Perspective), 'ORTHO' (Orthographic), or 'PANO' (Panoramic). | PERSP |
| ortho_scale | No | Orthographic scale factor for ORTHO cameras (> 0.001 to 10000.0). | |
| focal_length | No | Focal length in millimeters (alias for lens). | |
| focus_object | No | Target object name for dynamic depth-of-field focus point. Pass null or empty string to disable focus target. | |
| sensor_width | No | Camera sensor width in millimeters (1.0 to 200.0). | |
| sensor_height | No | Camera sensor height in millimeters (1.0 to 200.0). | |
| aperture_fstop | No | Aperture f-stop number. | |
| focus_distance | No | Focus distance in meters. | |
| rotation_euler | No | Euler rotation angles in radians [rx, ry, rz]. | |
| track_to_object | No | Target object name for camera to track using a TRACK_TO constraint. Pass null or empty string to disable tracking. | |
| show_composition_thirds | No | Display rule-of-thirds composition guide grid in the camera viewport. |