codex3d
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| blender_pingA | Check the authenticated localhost Blender bridge and report connector/backend versions. Takes no arguments. |
| blender_inspect_sceneA | Inspect Blender with a compact collection-oriented summary by default. Filter by collection, UUID, semantic group, or scene. Use full mode only when all object transforms are genuinely needed. Returns the current fingerprint and accepted snapshot metadata. |
| blender_create_primitiveA | Create one allowlisted Blender primitive. Location and dimensions are meters; rotation is Euler radians. For meshes, dimensions define final physical size and take precedence over scale. light is valid only for point_light. |
| blender_transform_objectA | Update only supplied transform fields. Prefer stable target_uuid; target_name is a readable fallback. Location/dimensions are meters, rotation is Euler radians, scale is unitless. |
| blender_rename_objectA | Rename an existing Blender object. The old name stops resolving after success. |
| blender_delete_objectA | Delete exactly one existing Blender object by name. Does not clear unrelated scene objects. |
| blender_assign_materialA | Create or reuse a basic Principled BSDF material and assign it to an existing mesh. Colors use linear RGBA in [0,1]. |
| blender_set_point_lightA | Update color and/or energy on an existing point-light object. Color is linear RGB [0,1]; energy is non-negative Blender watts. |
| blender_create_curveA | Create a general 3D polyline or Bezier curve. Points and bevel depth are meters. Cyclic curves form closed loops; this is a general curve tool, not a logo generator. |
| blender_create_cameraA | Create and activate a camera. Location is meters, focal_length is millimeters, and look_at accepts a target point or object name. |
| blender_set_lightB | Update color, energy, and optional area size on an existing Point or Area light. |
| blender_set_parentA | Parent one existing object to another while preserving its world transform by default. |
| blender_configure_worldA | Set the Blender World background color and strength using linear RGB values. |
| blender_configure_sceneB | Configure a bounded Eevee render scene: square or rectangular resolution, samples, transparency, FPS, and timeline range. |
| blender_keyframe_objectC | Insert transform and/or Principled emission-strength keyframes. Animation is evaluated by Blender Timeline; cycle adds a cycles modifier when supported. |
| blender_renderA | Render a still PNG or an animation MP4 under CODEX3D_ARTIFACT_ROOT. Returns only validated relative paths and render statistics; still PNG may also be returned as MCP image content. |
| blender_save_checkpointB | Create a new, versioned .blend delivery under CODEX3D_ARTIFACT_ROOT. The tool never overwrites an existing file and verifies that saving did not change the live scene. |
| blender_create_snapshotC | Create a restorable .blend snapshot under CODEX3D_ARTIFACT_ROOT with a canonical scene fingerprint and stable object UUID inventory. |
| blender_list_snapshotsA | List snapshots stored inside the configured artifact root. Takes no arguments. |
| blender_restore_snapshotA | Reversibly restore a snapshot registered by the current session. Requires the live and target fingerprints, creates a non-overwriting pre-restore safety snapshot first, then returns inspection and scene diff. |
| blender_delete_snapshotA | Delete one snapshot .blend and metadata record from the configured artifact root. |
| blender_reconcile_object_idsA | Assign stable codex3d_uuid properties to legacy objects with an explicit name prefix. Does not rename or modify geometry. |
| blender_execute_batchA | Execute an ordered, fail-fast batch of allowlisted Codex3D Action objects, then inspect the final scene. Supports creation, transform, material, parenting, scene/world configuration, keyframes, render, and checkpoint actions. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 23 tools
Most tools are clearly targeted, but blender_set_point_light substantially overlaps with blender_set_light, which also handles point lights. blender_create_snapshot and blender_save_checkpoint also have very similar save-a-.blend behavior, so an agent could easily pick the wrong one without careful reading.
All tools share the blender_ prefix and mostly follow a verb_noun snake_case pattern. Minor deviations like blender_ping and blender_render lacking an object noun, plus the confusing set_point_light vs set_light pair, keep it from being perfectly consistent.
At 23 tools, this is in the heavy range for a single server. The Blender domain is broad enough to justify many operations, but some tools could be consolidated, especially the light-update and snapshot/checkpoint-saving pairs.
Core workflows are covered: scene inspection, object creation/editing, materials, animation, rendering, and snapshot restore. Notable gaps remain, though: area lights can be updated but not created, materials cannot be modified after assignment, and checkpoints have no list/restore counterpart.