Servers Playground How we check Submit a server

BlockWerk

Working · 385 ms

tech.blockwerk/mcpv1.1.2 Domain verified

Build, run and analyse block-diagram simulations: PID, Bode, FFT, optimisation and code export.

Developer Tools

Website Registry entry

Try it

Call this server's tools from your browser. Nothing to install.

https://blockwerk-mcp-worker.blockwerk.workers.dev/

Authorization (optional)

Optional. 'Bearer <device token>' from the Connect AI panel on blockwerk.tech pairs this connection with your own open tab. Without it you get a private scratch canvas.

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

add_block

Add a new block to the canvas. Returns the new block ID.

xnumber, required

Horizontal position in canvas pixels

ynumber, required

Vertical position in canvas pixels

typestring, required

Block type from the library, e.g. "PIDController", "Gain", "Integrator"

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

BlockWerk MCP server | mcptry

Tools (42)

add_block

Add a new block to the canvas. Returns the new block ID.

Argument	Type	Description
x*	number	Horizontal position in canvas pixels
y*	number	Vertical position in canvas pixels
type*	string	Block type from the library, e.g. "PIDController", "Gain", "Integrator"

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "type",
    "x",
    "y"
  ],
  "properties": {
    "x": {
      "type": "number",
      "description": "Horizontal position in canvas pixels"
    },
    "y": {
      "type": "number",
      "description": "Vertical position in canvas pixels"
    },
    "type": {
      "type": "string",
      "description": "Block type from the library, e.g. \"PIDController\", \"Gain\", \"Integrator\""
    }
  }
}

analyze_topology

Analyzes the block diagram structure: detects feedback loops, signal paths, and system order.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

auto_tune_pid

Automatically tunes a PID controller using the Ziegler-Nichols ultimate cycle method. Finds the ultimate gain (Ku) and oscillation period (Tu) via binary search, then applies ZN formulas. No prior knowledge of the plant required.

Argument	Type	Description
maxGain	number	Upper bound for Ku search (default: 200)
minGain	number	Lower bound for Ku search (default: 0.1)
setpoint	number	Desired setpoint value (default: 1)
pidBlockId*	string	ID of the PIDController block to tune
controlType	string	Controller type to tune for (default: PID)
measureBlockId*	string	Scope or Display block showing the controlled variable

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "pidBlockId",
    "measureBlockId"
  ],
  "properties": {
    "maxGain": {
      "type": "number",
      "description": "Upper bound for Ku search (default: 200)"
    },
    "minGain": {
      "type": "number",
      "description": "Lower bound for Ku search (default: 0.1)"
    },
    "setpoint": {
      "type": "number",
      "description": "Desired setpoint value (default: 1)"
    },
    "pidBlockId": {
      "type": "string",
      "description": "ID of the PIDController block to tune"
    },
    "controlType": {
      "enum": [
        "P",
        "PI",
        "PID"
      ],
      "type": "string",
      "description": "Controller type to tune for (default: PID)"
    },
    "measureBlockId": {
      "type": "string",
      "description": "Scope or Display block showing the controlled variable"
    }
  }
}

batch_commands

Executes multiple canvas manipulation and background job commands in a single round-trip. Use "handle" strings to refer to blocks added earlier in the same batch. When adding TextNote annotations, set "anchors" to the handles/IDs of the described blocks so auto-layout keeps each note next to them.

destructive

Argument	Type	Description
commands*	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "commands"
  ],
  "properties": {
    "commands": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "type"
        ],
        "properties": {
          "x": {
            "type": "number"
          },
          "y": {
            "type": "number"
          },
          "max": {
            "type": "number"
          },
          "min": {
            "type": "number"
          },
          "type": {
            "enum": [
              "add_block",
              "move_block",
              "connect_blocks",
              "update_params",
              "delete_block",
              "tidy_layout",
              "clear_canvas",
              "start_optimization",
              "get_job_status",
              "cancel_job"
            ],
            "type": "string"
          },
          "jobId": {
            "type": "string"
          },
          "handle": {
            "type": "string"
          },
          "params": {
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {}
          },
          "anchors": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "For add_block of a TextNote: handles/IDs of the blocks the note describes. Auto-layout and drag then keep the note beside those blocks."
          },
          "blockId": {
            "type": "string"
          },
          "setpoint": {
            "type": "number"
          },
          "toPortId": {
            "type": "string"
          },
          "blockType": {
            "type": "string"
          },
          "objective": {
            "enum": [
              "iae",
              "overshoot",
              "settling_time"
            ],
            "type": "string"
          },
          "paramName": {
            "type": "string"
          },
          "toBlockId": {
            "type": "string"
          },
          "fromPortId": {
            "type": "string"
          },
          "fromBlockId": {
            "type": "string"
          },
          "maxIterations": {
            "type": "number"
          },
          "measureBlockId": {
            "type": "string"
          }
        }
      }
    }
  }
}

calculate_metrics

Calculates step response metrics from signal data: rise time, settling time, overshoot percentage, and steady-state error.

read-only

Argument	Type	Description
blockId*	string	ID of the Scope block
setpoint	number	Target setpoint value (default: 1)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "blockId"
  ],
  "properties": {
    "blockId": {
      "type": "string",
      "description": "ID of the Scope block"
    },
    "setpoint": {
      "type": "number",
      "description": "Target setpoint value (default: 1)"
    }
  }
}

cancel_job

Cancel a running background job.

Argument	Type	Description
jobId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "jobId"
  ],
  "properties": {
    "jobId": {
      "type": "string"
    }
  }
}

clear_canvas

Remove all blocks and connections from the canvas. This is a destructive action that asks the user for approval in the BlockWerk tab.

destructive

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

connect_blocks

Connect an output port of one block to an input port of another. Automatically resolves common port aliases (e.g., "in" -> "signal" for uPlotDisplay, "in" -> "error" for PIDController, "+" / "-" for Subtraction).

Argument	Type	Description
toPortId*	string	Input port ID of the destination block, e.g. "in" (aliases like "signal" or PID "error" are supported)
toBlockId*	string	ID of the destination block
fromPortId*	string	Output port ID of the source block, e.g. "out" (aliases like "signal", "y" are supported)
fromBlockId*	string	ID of the source block

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "fromBlockId",
    "fromPortId",
    "toBlockId",
    "toPortId"
  ],
  "properties": {
    "toPortId": {
      "type": "string",
      "description": "Input port ID of the destination block, e.g. \"in\" (aliases like \"signal\" or PID \"error\" are supported)"
    },
    "toBlockId": {
      "type": "string",
      "description": "ID of the destination block"
    },
    "fromPortId": {
      "type": "string",
      "description": "Output port ID of the source block, e.g. \"out\" (aliases like \"signal\", \"y\" are supported)"
    },
    "fromBlockId": {
      "type": "string",
      "description": "ID of the source block"
    }
  }
}

delete_block

Delete a block and all its connections from the canvas. This is a destructive action that asks the user for approval in the BlockWerk tab.

destructive

Argument	Type	Description
blockId*	string	ID of the block to delete

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "blockId"
  ],
  "properties": {
    "blockId": {
      "type": "string",
      "description": "ID of the block to delete"
    }
  }
}

describe_canvas

Returns a structured description of all blocks and connections currently on the canvas. Set "compact" to true for a token-efficient summary.

read-only

Argument	Type	Description
compact	boolean	If true, returns a minimal description without full parameter details.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "compact": {
      "type": "boolean",
      "description": "If true, returns a minimal description without full parameter details."
    }
  }
}

evaluate_spec_mask

Evaluates signal data against automated design specifications and tolerance corridors (rise time, settling time, overshoot %, steady-state error, min/max limits).

read-only

Argument	Type	Description
blockId*	string	ID of the Scope or signal source block
setpoint	number	Target setpoint value (default: 1)
lowerLimit	number	Absolute lower bound corridor
upperLimit	number	Absolute upper bound corridor
maxRiseTime	number	Maximum allowable rise time (seconds)
maxSettlingTime	number	Maximum allowable settling time (seconds)
maxOvershootPercent	number	Maximum allowable overshoot %
maxSteadyStateError	number	Maximum allowable steady-state error

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "blockId"
  ],
  "properties": {
    "blockId": {
      "type": "string",
      "description": "ID of the Scope or signal source block"
    },
    "setpoint": {
      "type": "number",
      "description": "Target setpoint value (default: 1)"
    },
    "lowerLimit": {
      "type": "number",
      "description": "Absolute lower bound corridor"
    },
    "upperLimit": {
      "type": "number",
      "description": "Absolute upper bound corridor"
    },
    "maxRiseTime": {
      "type": "number",
      "description": "Maximum allowable rise time (seconds)"
    },
    "maxSettlingTime": {
      "type": "number",
      "description": "Maximum allowable settling time (seconds)"
    },
    "maxOvershootPercent": {
      "type": "number",
      "description": "Maximum allowable overshoot %"
    },
    "maxSteadyStateError": {
      "type": "number",
      "description": "Maximum allowable steady-state error"
    }
  }
}

explain_simulation

Analyze the last completed simulation and return a structured diagnosis: signal anomalies (NaN, divergence, oscillation), solver health (rejection rate, efficiency), algebraic loops, and optional stability margins. Returns JSON with severity-tagged findings and actionable suggestions.

read-only

Argument	Type	Description
stabilityMargins	object	Optional pre-computed stability margins from a Bode sweep. If omitted, stability analysis is skipped.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "stabilityMargins": {
      "type": "object",
      "required": [
        "gainMarginDb",
        "phaseMarginDeg",
        "stable"
      ],
      "properties": {
        "stable": {
          "type": "boolean"
        },
        "gainMarginDb": {
          "type": "number"
        },
        "phaseMarginDeg": {
          "type": "number"
        }
      },
      "description": "Optional pre-computed stability margins from a Bode sweep. If omitted, stability analysis is skipped."
    }
  }
}

export_diagram

Exports the current canvas project as a complete BlockWerk JSON string.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

generate_code

Generates standalone production code (C++, Python, Rust) from the current canvas diagram. Returns structured code files, interfaces (inputs/outputs), execution order, and diagnostics.

read-only

Argument	Type	Description
target	string	Filter code generation to a specific target language (default: "all")
modelName	string	Name of the generated model class/module (e.g., "MotorController", default: "BlockWerkModel")
sampleTime	number	Optional custom step size in seconds (default: current canvas sampleTime)
encapsulateSubsystems	boolean	Whether to generate encapsulated subsystem classes (default: false)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "target": {
      "enum": [
        "all",
        "cpp",
        "python",
        "rust"
      ],
      "type": "string",
      "description": "Filter code generation to a specific target language (default: \"all\")"
    },
    "modelName": {
      "type": "string",
      "description": "Name of the generated model class/module (e.g., \"MotorController\", default: \"BlockWerkModel\")"
    },
    "sampleTime": {
      "type": "number",
      "description": "Optional custom step size in seconds (default: current canvas sampleTime)"
    },
    "encapsulateSubsystems": {
      "type": "boolean",
      "description": "Whether to generate encapsulated subsystem classes (default: false)"
    }
  }
}

get_ai_history

Returns the list of recent canvas operations performed by the AI, showing what can be undone.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_analysis_measurements

Retrieves the currently active pinned measurements and their computed values across plotted signals in the Analysis panel.

read-only

Argument	Type	Description
blockId	string	Optional blockId or signalId filter

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "blockId": {
      "type": "string",
      "description": "Optional blockId or signalId filter"
    }
  }
}

get_architect_memory

Returns the persistent memory object of the Architect.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_available_blocks

Returns the block types in the library with their descriptions, configurable parameters, and exact input/output port IDs. Without a filter it returns a compact list of all types; with a list of type IDs it returns full details for those types. Example port IDs: Step out "out"; Sum in "in", out "out"; Gain in "in", out "out"; PIDController in "error","reset", out "out"; uPlotDisplay in "signal". Common aliases (e.g. "in" for PID error, "in" for uPlotDisplay signal, "+" / "-" for Subtraction) are resolved automatically.

read-only

Argument	Type	Description
filter	array	Optional: List of block type IDs to get full details for. If omitted, returns a compact list of all blocks.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "filter": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional: List of block type IDs to get full details for. If omitted, returns a compact list of all blocks."
    }
  }
}

get_bode_data

Computes magnitude and phase frequency response (Bode data) between two blocks. Traces path backwards from outputBlockId. Returns analytic response if the path contains only linear blocks, otherwise runs numerical sweep.

read-only

Argument	Type	Description
endFreq	number	End frequency in rad/s (default: 100)
startFreq	number	Start frequency in rad/s (default: 0.1)
inputBlockId*	string	ID of the input source block
outputBlockId*	string	ID of the output measurement block
pointsPerDecade	number	Number of points per decade (default: 10)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "inputBlockId",
    "outputBlockId"
  ],
  "properties": {
    "endFreq": {
      "type": "number",
      "description": "End frequency in rad/s (default: 100)"
    },
    "startFreq": {
      "type": "number",
      "description": "Start frequency in rad/s (default: 0.1)"
    },
    "inputBlockId": {
      "type": "string",
      "description": "ID of the input source block"
    },
    "outputBlockId": {
      "type": "string",
      "description": "ID of the output measurement block"
    },
    "pointsPerDecade": {
      "type": "number",
      "description": "Number of points per decade (default: 10)"
    }
  }
}

get_canvas_preview

Captures a visual screenshot preview of the canvas branded with the official BlockWerk watermark badge and returns the live interactive URL to view and edit the diagram online.

read-only

Argument	Type	Description
type	string	Which visual region to capture: "canvas", "scope", or "combined" (default: "combined").

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "type": {
      "enum": [
        "canvas",
        "scope",
        "combined"
      ],
      "type": "string",
      "description": "Which visual region to capture: \"canvas\", \"scope\", or \"combined\" (default: \"combined\")."
    }
  }
}

get_engine_status

Returns the simulation engine status, including supported solvers, active background jobs, and compilation/WASM capabilities.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_fft_data

Computes FFT (frequency spectrum) of a Scope signal. Returns frequencies and magnitudes.

read-only

Argument	Type	Description
blockId*	string	ID of the Scope block
channel	number	Channel index (default: 0)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "blockId"
  ],
  "properties": {
    "blockId": {
      "type": "string",
      "description": "ID of the Scope block"
    },
    "channel": {
      "type": "number",
      "description": "Channel index (default: 0)"
    }
  }
}

get_job_status

Check the status and progress of a background job.

read-only

Argument	Type	Description
jobId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "jobId"
  ],
  "properties": {
    "jobId": {
      "type": "string"
    }
  }
}

get_share_link

Returns a link that opens the current diagram on the BlockWerk canvas. The whole project travels compressed inside the URL, so it needs no account and nothing is uploaded. Opening the link in a browser shows the diagram, where the simulation can be run.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_signal_data

Returns time series data from a Scope block output for analysis.

read-only

Argument	Type	Description
blockId*	string	ID of the Scope block
channel	number	Channel index (default: 0)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "blockId"
  ],
  "properties": {
    "blockId": {
      "type": "string",
      "description": "ID of the Scope block"
    },
    "channel": {
      "type": "number",
      "description": "Channel index (default: 0)"
    }
  }
}

get_templates

Lists the built-in, verified BlockWerk diagrams: classic control systems (PID loop, cruise control, inverted pendulum), signal processing, electrical and physics models. Each entry gives an id, what the diagram does, its difficulty and the blocks it uses. Returns metadata only; load_template puts a diagram on the canvas by id.

read-only

Argument	Type	Description
category	string	Optional filter by category.
interactive	boolean	If true, only diagrams with live on-canvas controls (sliders, joystick, keyboard) meant to be driven while the simulation runs.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "category": {
      "enum": [
        "Control Systems",
        "Signal Processing",
        "Physics",
        "Electrical"
      ],
      "type": "string",
      "description": "Optional filter by category."
    },
    "interactive": {
      "type": "boolean",
      "description": "If true, only diagrams with live on-canvas controls (sliders, joystick, keyboard) meant to be driven while the simulation runs."
    }
  }
}

identify_fopdt

Analyzes a step response from a plant to identify its First-Order Plus Dead Time (FOPDT) parameters: Gain (K), Time Constant (tau), and Dead Time (theta). Requires a completed simulation with a step input connected to the plant. Returns the calculated parameters.

read-only

Argument	Type	Description
blockId*	string	Scope or Display block ID showing the plant output
stepTime	number	Time when the step input occurred (default: 0)
stepAmplitude	number	Amplitude of the step input (default: 1)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "blockId"
  ],
  "properties": {
    "blockId": {
      "type": "string",
      "description": "Scope or Display block ID showing the plant output"
    },
    "stepTime": {
      "type": "number",
      "description": "Time when the step input occurred (default: 0)"
    },
    "stepAmplitude": {
      "type": "number",
      "description": "Amplitude of the step input (default: 1)"
    }
  }
}

list_jobs

List all recent background jobs and their status.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

load_diagram

Atomically replaces the entire canvas with a complete diagram defined as a BlockWerk project JSON string. The JSON has a "blocks" array (each block needs a unique "id" and "type"; "x"/"y"/"params" are optional) and a "connections" array (each connection needs a unique "id" plus "fromBlockId", "fromPortId", "toBlockId", "toPortId"; a missing id fails validation of the whole load). Block types and port ids are listed by get_available_blocks. This is a destructive action that asks the user for approval in the BlockWerk tab.

destructive

Argument	Type	Description
json*	string	Full BlockWerk project JSON, e.g. {"blocks":[{"id":"b1","type":"Step","x":100,"y":100,"params":{}},{"id":"b2","type":"Integrator","x":300,"y":100,"params":{}}],"connections":[{"id":"c1","fromBlockId":"b1","fromPortId":"out","toBlockId":"b2","toPortId":"in"}]}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "json"
  ],
  "properties": {
    "json": {
      "type": "string",
      "description": "Full BlockWerk project JSON, e.g. {\"blocks\":[{\"id\":\"b1\",\"type\":\"Step\",\"x\":100,\"y\":100,\"params\":{}},{\"id\":\"b2\",\"type\":\"Integrator\",\"x\":300,\"y\":100,\"params\":{}}],\"connections\":[{\"id\":\"c1\",\"fromBlockId\":\"b1\",\"fromPortId\":\"out\",\"toBlockId\":\"b2\",\"toPortId\":\"in\"}]}"
    }
  }
}

load_template

Replaces the entire canvas with one of the built-in verified diagrams, by id from get_templates. The template carries its topology, parameters and simulation settings. Returns the block and connection counts, the verified simulation settings, and the attribution when the model is based on third-party material. This is a destructive action that asks the user for approval in the BlockWerk tab.

destructive

Argument	Type	Description
templateId*	string	Template id from get_templates, e.g. "inverted_pendulum" or "pid_loop".

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "templateId"
  ],
  "properties": {
    "templateId": {
      "type": "string",
      "description": "Template id from get_templates, e.g. \"inverted_pendulum\" or \"pid_loop\"."
    }
  }
}

optimize_multi_parameter

Optimizes 2–6 parameters simultaneously using Nelder-Mead simplex search, for example Kp, Ki and Kd of a PID controller at once.

Argument	Type	Description
targets*	array	Parameters to optimize simultaneously
setpoint	number	Target steady-state value (default: 1)
objective	string	Metric to minimize (default: iae)
maxIterations	number	Max simulations to run, 5–60 (default: 30)
measureBlockId*	string	Scope or Display block to read the controlled signal from

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "targets",
    "measureBlockId"
  ],
  "properties": {
    "targets": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "blockId",
          "paramName",
          "min",
          "max"
        ],
        "properties": {
          "max": {
            "type": "number"
          },
          "min": {
            "type": "number"
          },
          "blockId": {
            "type": "string"
          },
          "paramName": {
            "type": "string"
          }
        }
      },
      "description": "Parameters to optimize simultaneously"
    },
    "setpoint": {
      "type": "number",
      "description": "Target steady-state value (default: 1)"
    },
    "objective": {
      "enum": [
        "iae",
        "overshoot",
        "settling_time"
      ],
      "type": "string",
      "description": "Metric to minimize (default: iae)"
    },
    "maxIterations": {
      "type": "number",
      "description": "Max simulations to run, 5–60 (default: 30)"
    },
    "measureBlockId": {
      "type": "string",
      "description": "Scope or Display block to read the controlled signal from"
    }
  }
}

optimize_parameters

Finds the optimal value for a single parameter using golden-section search. Minimizes IAE (integral absolute error), overshoot, or settling_time within a [min, max] range. Converges in about 10 simulations.

Argument	Type	Description
max*	number	Upper bound of the search range
min*	number	Lower bound of the search range
blockId*	string	ID of the block containing the parameter to tune
setpoint	number	Target steady-state value (default: 1)
objective	string	Metric to minimize (default: iae)
paramName*	string	Parameter key to optimize (e.g., "Kp", "gain")
maxIterations	number	Maximum simulations to run, 3–20 (default: 10)
measureBlockId*	string	Scope or Display block ID to read the controlled signal from

Input schema (JSON)

redo_last_ai_action

Redoes the last undone canvas modification.

destructive

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

run_simulation

Triggers a new simulation run with the current canvas state and settings, refreshing the signal data.

Argument	Type	Description
reason	string	User-facing explanation of why settings were changed (e.g., Nyquist constraint)
duration	number	Duration in seconds
sampleTime	number	Optional custom step size (dt) for high frequency or stiff systems (e.g., 0.001)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "reason": {
      "type": "string",
      "description": "User-facing explanation of why settings were changed (e.g., Nyquist constraint)"
    },
    "duration": {
      "type": "number",
      "description": "Duration in seconds"
    },
    "sampleTime": {
      "type": "number",
      "description": "Optional custom step size (dt) for high frequency or stiff systems (e.g., 0.001)"
    }
  }
}

start_optimization

Start a parameter optimization job in the background.

Argument	Type	Description
max*	number
min*	number
blockId*	string
setpoint	number
objective	string
paramName*	string
maxIterations	number
measureBlockId*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "blockId",
    "paramName",
    "min",
    "max",
    "measureBlockId"
  ],
  "properties": {
    "max": {
      "type": "number"
    },
    "min": {
      "type": "number"
    },
    "blockId": {
      "type": "string"
    },
    "setpoint": {
      "type": "number"
    },
    "objective": {
      "enum": [
        "iae",
        "overshoot",
        "settling_time"
      ],
      "type": "string"
    },
    "paramName": {
      "type": "string"
    },
    "maxIterations": {
      "type": "number"
    },
    "measureBlockId": {
      "type": "string"
    }
  }
}

sweep_parameter

Runs simulations across a list of values for one parameter, returning control quality metrics (IAE, overshoot, settling_time, steady_state_error) per value. Requires measureBlockId and setpoint.

Argument	Type	Description
values*	array	List of values to test
blockId*	string	ID of the block to tune
setpoint	number	Expected final value for error calculation (default: 1)
paramName*	string	Parameter key to vary (e.g., "gain", "Kp")
measureBlockId	string	Scope or Display block ID to read the controlled signal from

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "blockId",
    "paramName",
    "values"
  ],
  "properties": {
    "values": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "List of values to test"
    },
    "blockId": {
      "type": "string",
      "description": "ID of the block to tune"
    },
    "setpoint": {
      "type": "number",
      "description": "Expected final value for error calculation (default: 1)"
    },
    "paramName": {
      "type": "string",
      "description": "Parameter key to vary (e.g., \"gain\", \"Kp\")"
    },
    "measureBlockId": {
      "type": "string",
      "description": "Scope or Display block ID to read the controlled signal from"
    }
  }
}

tidy_layout

Automatically rearrange all blocks on the canvas into a clean, left-to-right flow.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

undo_last_ai_action

Undoes the last canvas modification made by the AI (add block, connect, delete, update parameter).

destructive

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

update_architect_memory

Updates the persistent memory of the Architect. Provide a JSON object with keys to update/merge.

Argument	Type	Description
updates*	object	Keys and values to store

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "updates"
  ],
  "properties": {
    "updates": {
      "type": "object",
      "description": "Keys and values to store",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  }
}

update_params

Update one or more parameters of an existing block.

Argument	Type	Description
params*	object	Key-value pairs of parameter names and their new values
blockId*	string	ID of the block to update

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "blockId",
    "params"
  ],
  "properties": {
    "params": {
      "type": "object",
      "description": "Key-value pairs of parameter names and their new values",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "blockId": {
      "type": "string",
      "description": "ID of the block to update"
    }
  }
}

validate_canvas

Performs pre-flight topological and numerical integrity checks on the canvas. Detects unconnected required input ports, isolated blocks, parameter domain anomalies, and direct algebraic feedthrough loops.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

validate_engineering_units

Checks the consistency of engineering units across the diagram. Detects incompatible connections and missing units.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "blockId",
    "paramName",
    "min",
    "max",
    "measureBlockId"
  ],
  "properties": {
    "max": {
      "type": "number",
      "description": "Upper bound of the search range"
    },
    "min": {
      "type": "number",
      "description": "Lower bound of the search range"
    },
    "blockId": {
      "type": "string",
      "description": "ID of the block containing the parameter to tune"
    },
    "setpoint": {
      "type": "number",
      "description": "Target steady-state value (default: 1)"
    },
    "objective": {
      "enum": [
        "iae",
        "overshoot",
        "settling_time"
      ],
      "type": "string",
      "description": "Metric to minimize (default: iae)"
    },
    "paramName": {
      "type": "string",
      "description": "Parameter key to optimize (e.g., \"Kp\", \"gain\")"
    },
    "maxIterations": {
      "type": "number",
      "description": "Maximum simulations to run, 3–20 (default: 10)"
    },
    "measureBlockId": {
      "type": "string",
      "description": "Scope or Display block ID to read the controlled signal from"
    }
  }
}