construct_object
Build any 3D object from a natural language description by generating and executing Blender Python scripts. Supports adjustable complexity and style presets.
Instructions
PORTMANTEAU PATTERN RATIONALE: Consolidates natural language 3D construction into single agentic interface. Prevents tool explosion while enabling infinite 3D creativity through LLM-generated Blender scripts. Follows FastMCP 2.14.3 best practices.
Universal 3D object construction using natural language and LLM-generated Blender scripts.
This revolutionary tool enables creation of any 3D object through natural language descriptions by leveraging FastMCP 2.14.3 sampling to request SOTA LLM generation of Blender Python code.
Agentic Workflow:
Analysis: Parse natural language description and scene context
Sampling Request: Ask MCP client (SOTA LLM) to generate Blender Python script
Code Generation: LLM creates production-ready Blender automation code
Validation: Security and syntax validation of generated code
Execution: Safe execution in Blender with error handling
Iteration: Request refinements if needed (up to max_iterations)
Supported Complexity Levels:
simple: Basic primitives, basic transforms, simple materials
standard: Complex meshes, modifiers, materials, basic animation
complex: Advanced geometry, rigging, physics, complex materials/textures
Style Presets:
realistic: Physically accurate materials, lighting, proportions
stylized: Artistic interpretation, exaggerated features, cartoon-like
lowpoly: Minimal geometry, optimized for performance
scifi: Futuristic design, metallic materials, glowing effects
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ctx | Yes | FastMCP context for sampling and conversational responses | |
| description | No | Natural language description of object to create Examples: "a robot like Robbie from Forbidden Planet", "a medieval castle", "a sleek sports car" | a simple cube |
| name | No | Name for the created object in Blender scene. Default: "ConstructedObject" | ConstructedObject |
| complexity | No | Complexity level for script generation. One of: "simple", "standard", "complex". Default: "standard". Affects detail level and operation complexity. | standard |
| style_preset | No | Optional style guidance. One of: "realistic", "stylized", "lowpoly", "scifi". Default: None (let LLM decide based on description). | |
| reference_objects | No | Existing Blender objects to use as reference for style/consistency. Default: None. LLM will analyze these objects for consistent styling. | |
| allow_modifications | No | Whether LLM can modify existing scene objects. Default: True. Set to False for conservative construction that only adds new objects. | |
| max_iterations | No | Maximum refinement iterations if initial script fails. Default: 3. Higher values allow more complex objects but increase processing time. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||