MBEstudio

Build 3D model

build_3d_model

Idempotent

Compile a saved systems model into placed 3D envelopes and existing authored procedural geometry. Returns a studio link and supported geometry formats. Paid. Call it directly: it charges what the job uses, never more than its estimated maximum or the max_spend_credits you set. request_id is optional; set one to make a retry safe. Returns job_id immediately. Poll get_job_status for later progress.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "build_3d_model"
  }
}

Input Schema

Name	Required	Description	Default
`rows`	No	Only for cost_mode "agent_authored" on generate_safety_analysis: {conditions:[{target,description,severity,...}],modes:[{target,mode,severity,occurrence,detection,...}]}; with analysis "stpa": {losses:[{id,description}],hazards:[{id,description,losses}],controllers:[{target,processModel}],controlActions:[{from,to,name,ucas:[{id,type,context,contextVariables,hazards,constraint}\|{type,notApplicable,rationale}]}],feedback:[{from,to,name,updates}],constraints:[{id,name,text}]}.
`model`	No
`study`	No
`events`	No
`format`	No
`prompt`	No
`stop_s`	No
`analysis`	No	For generate_safety_analysis: fha, fmea, both (default) or stpa. stpa needs no standard.
`fidelity`	No
`model_id`	No	A model from a generation job (model_ id) or a saved studio model (m_ id); a saved model is read at the head of main.
`provider`	No
`standard`	No
`cost_mode`	No		managed
`max_depth`	No	Only for run_agent_swarm: levels of division, 1 to 3 (default 2). At 2 and 3, a subsystem the orchestrator judges too large for one agent is divided again inside its frozen boundary.
`subsystem`	No	For reprompt_agent: qualified name of the subsystem, e.g. "Rover::DriveUnit". For run_agent_swarm on a saved model: the subsystem to decompose one level further (its parts get the agents); leave it out to work on the whole system's subsystems.
`request_id`	No
`scenario_id`	No
`simulations`	No
`specification`	No	Only for cost_mode "agent_authored" on generate_system_model and build_full_system; see those tools for its schema.
`simulation_type`	No
`max_spend_credits`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed3 schema fields changedNov 4, 2026

addedInput schema / properties / analysis / description

Added value: +"For generate_safety_analysis: fha, fmea, both (default) or stpa. stpa needs no standard."

changedInput schema / properties / analysis / enum

Previous value: -[
-  "fha",
-  "fmea",
-  "both"
-]New value: +[
+  "fha",
+  "fmea",
+  "both",
+  "stpa"
+]

changedInput schema / properties / rows / description

Previous value: -"Only for cost_mode \"agent_authored\" on generate_safety_analysis: {conditions:[{target,description,severity,...}],modes:[{target,mode,severity,occurrence,detection,...}]}."New value: +"Only for cost_mode \"agent_authored\" on generate_safety_analysis: {conditions:[{target,description,severity,...}],modes:[{target,mode,severity,occurrence,detection,...}]}; with analysis \"stpa\": {losses:[{id,description}],hazards:[{id,description,losses}],controllers:[{target,processModel}],controlActions:[{from,to,name,ucas:[{id,type,context,contextVariables,hazards,constraint}|{type,notApplicable,rationale}]}],feedback:[{from,to,name,updates}],constraints:[{id,name,text}]}."

First observedNov 3, 2026

TDQS

A3.8/5.0

Behavior5/5

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

Adds substantial behavior beyond the annotations: it is a paid job whose actual charge is capped by the estimate and by max_spend_credits, it returns job_id immediately and is asynchronous, and request_id makes retries safe. This cost, async, and idempotency mechanism detail is exactly what an agent needs before invoking a non-read-only, billed operation.

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

Conciseness4/5

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

Short sentences, purpose front-loaded, no wasted clauses; the async polling instruction and cost cap are placed before the optional request_id note. Slightly boilerplate in the pricing sentence, but nothing is filler.

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?

The lack of an output schema is offset by describing outputs (studio link, supported formats, job_id) and the polling path. However, for a 21-parameter tool with zero required fields, the description omits which inputs are actually needed to identify the model and what fidelity/format do, leaving real ambiguity.

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

Parameters2/5

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

Only 29% of schema fields are described, and the description explains just two of 21 parameters (request_id and max_spend_credits). It never clarifies how to identify the model (model vs model_id), what fidelity or format select, or that borrowed fields such as rows, analysis, standard, subsystem, and simulations belong to other tools. With this coverage gap the description needed to compensate and does not.

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?

States a specific verb and resource: compile a saved systems model into placed 3D envelopes plus authored procedural geometry, and returns a studio link. It is clearly distinct from export_model or build_full_system by naming the 3D envelope output. It does not explicitly contrast itself with a sibling, so not a 5.

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

Usage Guidelines4/5

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

Gives clear operational routing: call it directly, then poll get_job_status for progress, and set request_id if retries are needed. Missing any statement of when to prefer this over export_model or build_full_system, or which input identifies the model.

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

All MBEstudio tools Inspect

Try in Browser

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?