Build, run and analyse block-diagram simulations: PID, Bode, FFT, optimisation and code export.
Connect Remote server
claude mcp add --transport http mcp https://blockwerk-mcp-worker.blockwerk.workers.dev/ --header "Authorization: Bearer <YOUR_API_KEY>"
{
"mcpServers": {
"mcp": {
"url": "https://blockwerk-mcp-worker.blockwerk.workers.dev/",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}
{
"servers": {
"mcp": {
"type": "http",
"url": "https://blockwerk-mcp-worker.blockwerk.workers.dev/",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}
Settings > Connectors > Add custom connector
URL: https://blockwerk-mcp-worker.blockwerk.workers.dev/
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools 43 found in our last check
record_view_resultsStores the result of a diagram run in the BlockWerk chat view.
describe_canvasReturns a structured description of all blocks and connections currently on the canvas. Set "compact" to true for a token-efficient summary.
get_available_blocksReturns 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"; S…
add_blockAdd a new block to the canvas. Returns the new block ID.
connect_blocksConnect 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).
update_paramsUpdate one or more parameters of an existing block.
delete_blockDelete a block and all its connections from the canvas. This is a destructive action that asks the user for approval in the BlockWerk tab.
load_diagramAtomically 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…
export_diagramExports the current canvas project as a complete BlockWerk JSON string.
get_share_linkReturns 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.
clear_canvasRemove all blocks and connections from the canvas. This is a destructive action that asks the user for approval in the BlockWerk tab.
tidy_layoutAutomatically rearrange all blocks on the canvas into a clean, left-to-right flow.
batch_commandsExecutes 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…
analyze_topologyAnalyzes the block diagram structure: detects feedback loops, signal paths, and system order.
get_signal_dataReturns time series data from a Scope block output for analysis.
calculate_metricsCalculates step response metrics from signal data: rise time, settling time, overshoot percentage, and steady-state error.
get_analysis_measurementsRetrieves the currently active pinned measurements and their computed values across plotted signals in the Analysis panel.
evaluate_spec_maskEvaluates signal data against automated design specifications and tolerance corridors (rise time, settling time, overshoot %, steady-state error, min/max limits).
get_architect_memoryReturns the persistent memory object of the Architect.
update_architect_memoryUpdates the persistent memory of the Architect. Provide a JSON object with keys to update/merge.
validate_engineering_unitsChecks the consistency of engineering units across the diagram. Detects incompatible connections and missing units.
validate_canvasPerforms 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.
get_canvas_previewCaptures 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.
get_templatesLists 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_templateReplaces 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 i…
run_simulationTriggers a new simulation run with the current canvas state and settings, refreshing the signal data.
sweep_parameterRuns 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.
optimize_parametersFinds 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.
optimize_multi_parameterOptimizes 2–6 parameters simultaneously using Nelder-Mead simplex search, for example Kp, Ki and Kd of a PID controller at once.
auto_tune_pidAutomatically 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.
identify_fopdtAnalyzes 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.
start_optimizationStart a parameter optimization job in the background.
get_job_statusCheck the status and progress of a background job.
cancel_jobCancel a running background job.
list_jobsList all recent background jobs and their status.
explain_simulationAnalyze 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 sugges…
get_bode_dataComputes 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.
get_fft_dataComputes FFT (frequency spectrum) of a Scope signal. Returns frequencies and magnitudes.
get_engine_statusReturns the simulation engine status, including supported solvers, active background jobs, and compilation/WASM capabilities.
generate_codeGenerates standalone production code (C++, Python, Rust) from the current canvas diagram. Returns structured code files, interfaces (inputs/outputs), execution order, and diagnostics.
undo_last_ai_actionUndoes the last canvas modification made by the AI (add block, connect, delete, update parameter).
redo_last_ai_actionRedoes the last undone canvas modification.
get_ai_historyReturns the list of recent canvas operations performed by the AI, showing what can be undone.
Headers
| Name | Description |
|---|---|
AuthorizationOptional, secret | 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. |
Details
| Endpoint | https://blockwerk-mcp-worker.blockwerk.workers.dev/ (Streamable HTTP) |
| First published | 5 Oct 2026 |
| Last updated | 5 Oct 2026 |
| Registry name | tech.blockwerk/mcp |
More developer tools servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
