Skip to main content
Glama
TechBot_Blender_MCP

TechBot_Blender_MCP

by bharatnextai

fit_multiview_silhouette

Optimize a target mesh against multiple calibrated orthographic reference silhouettes, jointly improving IoU/Dice while protecting per-view fit and rolling back failed iterations.

Instructions

Simultaneously optimize a designated target mesh against multiple calibrated reference views (FRONT, SIDE, TOP) using measured silhouette comparison. Jointly optimizes aggregate IoU/Dice while enforcing per-view regression protections, avoiding directional oscillation, and providing automatic transactional rollback if objectives or regression thresholds are not met.

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": {
      "target_object": "<target_object>",
      "views": "<views>"
    },
    "name": "fit_multiview_silhouette"
  }
}

Input Schema

NameRequiredDescriptionDefault
viewsYesList of 2 to 3 distinct orthographic reference view configurations (e.g. FRONT, SIDE, TOP).
task_idNoOptional task or workflow identifier.
approvedNoDEPRECATED / UNTRUSTED: Client-supplied approval flags in tool arguments are not trusted as proof of human consent.
objectiveNoMulti-view aggregate objective function to maximize.WEIGHTED_IOU
step_sizeNoOptimization step rate factor between 0.01 and 2.0.
toleranceNoMinimum aggregate objective improvement required to accept an iteration step.
resolutionNoEvaluation image render width and height in pixels.
target_objectYesName of the target mesh object in the Blender scene to optimize.
mask_thresholdNoSensitivity threshold for foreground silhouette detection.
max_iterationsNoMaximum number of joint optimization iterations.
max_displacementNoMaximum allowed displacement cap in Blender units (meters) per iteration.
optimization_modeNoDeformation mode across all views.BOUNDED_SCALE_TRANSLATE
preserve_topologyNoStrictly preserve mesh topology (vertex, edge, and polygon counts remain invariant).
rollback_on_failureNoIf true, automatically rollback mesh state if aggregate objective does not strictly improve or regression tolerance is violated.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv1.0.0

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are supplied, so the description carries the full disclosure burden. It does add real behavioral value: joint aggregate optimization, per-view regression protection, oscillation avoidance, and automatic transactional rollback when objectives or thresholds fail. It omits important operational facts for a mesh-mutating tool with no annotation coverage: whether the scene file is permanently modified, whether an external approval/transaction flow is required (the 'approved' parameter is explicitly marked untrusted), and the cost/duration of a 20-iteration render-based run.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single front-loaded sentence plus a supporting one; the core action and its multi-view scope come first, and every clause (regression protection, oscillation, rollback) earns its place. No filler or restatement of the name.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 14-parameter, destructive mesh-optimization tool with no annotations and no output schema, the description covers the core mechanism and safety story but leaves gaps: return values (per-view IoU, iteration counts, rollback status) are never described, and prerequisite calibration state is unstated. Enough to call the tool, not enough to predict its outcome.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all 14 parameters in detail, which sets the baseline at 3. The description adds only loose conceptual mapping ('aggregate IoU/Dice' to the objective enum, 'per-view regression protections' to max_regression_tolerance) and gives no guidance on weighting, tolerance, or step-size tradeoffs.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb and resource ('optimize a designated target mesh') and scopes it precisely to 'multiple calibrated reference views (FRONT, SIDE, TOP) using measured silhouette comparison'. That implicitly separates it from single-view or comparison-only siblings, but no sibling is named explicitly, so the differentiation is left for the agent to infer.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage context is implied: this is the joint multi-view optimization path, and rollback is default-on. However, the description never states prerequisites (calibrated views must already exist, likely via calibrate_reference_views), when to prefer this over single-view optimization, or when-not to use it.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools