blender_lighting
Create, adjust, and manage lighting in Blender, including sun, point, spot, area lights, three-point rigs, and HDRI setups.
Instructions
PORTMANTEAU PATTERN RATIONALE: Consolidates 7 related lighting operations into single interface. Prevents tool explosion while maintaining full lighting workflow from basic lights to professional HDRI setups. Follows FastMCP 2.14.3 best practices.
Professional lighting system for Blender supporting all light types, HDRI environments, and lighting rigs.
Light Creation (4 operations):
create_sun: Generate directional sunlight with shadow control for outdoor scenes
create_point: Create omnidirectional point light for general illumination
create_spot: Generate focused spotlight with beam angle and softness control
create_area: Create rectangular area light for soft, realistic shadows
Lighting Setups (2 operations):
setup_three_point: Create professional three-point lighting rig (key, fill, rim lights)
setup_hdri: Configure HDRI environment lighting with world background
Light Management (1 operation):
adjust_light: Modify properties of existing lights (energy, color, position, etc.)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| operation | No | The lighting operation to perform. Must be one of: "create_sun", "create_point", "create_spot", "create_area", "setup_three_point", "setup_hdri", "adjust_light". - Light creation: "create_*" operations (use: light_name, location, rotation, energy, color + type-specific params) - Lighting setups: "setup_*" operations (use: minimal parameters, auto-position lights) - Light adjustment: "adjust_light" (use: light_name + properties to modify) | create_sun |
| light_name | No | Name for the new light object. Default: "Light". Must be unique in scene. Required for: all "create_*" and "adjust_light" operations. | Light |
| light_type | No | Type of light for creation operations. One of: "SUN", "POINT", "SPOT", "AREA". Default: "SUN". Auto-detected from operation when possible. | SUN |
| location | No | 3D position coordinates (x, y, z) in world space. Default: (5, 5, 5). Used for: all "create_*" operations. | |
| rotation | No | Rotation angles in degrees (x, y, z) around each axis. Default: (0, 0, 0). Primarily affects: "create_spot" for beam direction. | |
| energy | No | Light intensity/energy multiplier. Default: 1.0. Range: 0.0 to 100.0. Higher values = brighter light. Used for: all light creation and adjustment. | |
| color | No | Light color as RGB values. Default: (1, 1, 1) (white). Range: 0.0 to 1.0 per channel. Used for: all light creation and adjustment. | |
| shadow_soft_size | No | Shadow softness for sun lights. Default: 0.1. Range: 0.0 to 10.0. Higher values = softer shadows. Only used for: "create_sun". | |
| size | No | Physical size of area lights. Default: 1.0. Range: 0.01 to 100.0. Larger sizes = softer, more realistic shadows. Only used for: "create_area". | |
| spot_size | No | Beam angle in degrees for spot lights. Default: 45.0. Range: 1.0 to 180.0. Smaller angles = more focused beam. Only used for: "create_spot". | |
| spot_blend | No | Edge softness for spot lights. Default: 0.15. Range: 0.0 to 1.0. Higher values = softer beam edges. Only used for: "create_spot". |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |