Skip to main content
Glama

stage_add_object

Add 3D objects like boxes, spheres, or meshes to a scene with position, rotation, scale, and material properties for physics animation integration.

Instructions

Add a 3D object to the scene.

Adds primitives (box, sphere, cylinder, etc.) or placeholders for meshes. Objects can be bound to physics bodies later for animation. Args: scene_id: Scene identifier object_id: Unique object name (e.g., "ground", "ball", "car") object_type: Object type - "box", "sphere", "cylinder", "capsule", "plane", "mesh" position_x, position_y, position_z: Position in 3D space rotation_x, rotation_y, rotation_z, rotation_w: Rotation quaternion scale_x, scale_y, scale_z: Scale factors size_x, size_y, size_z: Size for box (width, height, depth) radius: Radius for sphere/cylinder/capsule height: Height for cylinder/capsule material_preset: Material preset - "metal-dark", "glass-blue", "plastic-white", etc. color_r, color_g, color_b: RGB color (0.0-1.0) Returns: AddObjectResponse with object_id confirmation Tips for LLMs: - For ground: object_type="plane", large size, static - For dynamic objects: smaller primitives that match physics bodies - Quaternion: [0,0,0,1] is identity (no rotation) - Common materials: "metal-dark", "glass-blue", "plastic-white", "rubber-black" Example: # Add ground plane await stage_add_object( scene_id=scene_id, object_id="ground", object_type="plane", size_x=20.0, size_y=20.0, material_preset="metal-dark" ) # Add falling sphere await stage_add_object( scene_id=scene_id, object_id="ball", object_type="sphere", radius=1.0, position_y=5.0, material_preset="glass-blue", color_r=0.3, color_g=0.5, color_b=1.0 )

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
scene_idYes
object_idYes
object_typeYes
position_xNo
position_yNo
position_zNo
rotation_xNo
rotation_yNo
rotation_zNo
rotation_wNo
scale_xNo
scale_yNo
scale_zNo
size_xNo
size_yNo
size_zNo
radiusNo
heightNo
material_presetNoplastic-white
color_rNo
color_gNo
color_bNo

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/chrishayuk/chuk-mcp-stage'

If you have feedback or need assistance with the MCP directory API, please join our Discord server