BULC Building Designer
This server lets you drive the BULC fire & evacuation simulator from an MCP client like Claude: build and edit building geometry, configure FDS fire simulations, run evacuations, and analyze results.
Project & spatial context: get home info, levels, rooms, walls, furniture; create/modify/delete levels, rooms, walls, and furniture; undo/redo/save.
FDS setup: create/modify/delete computational meshes, auto-mesh from geometry, set simulation time, ambient conditions, and output settings.
Fire & devices: configure furniture as fire sources, heat/smoke detectors, sprinklers, HVAC vents, or thermocouples; clear FDS data.
Validation & running: preview FDS input, validate configuration, export FDS files, run/stop/monitor FDS simulations.
Results: open result viewer, list datasets, extract point data (temperature, visibility, species, velocity), and generate ASET safety reports.
Evacuation: place/clear agents, configure stairs and exits, set movement models, pre-movement times, exit assignments, and fire coupling.
Evac analysis: run/monitor/stop evacuation simulations, load/save results, view summaries and detailed trajectories, and generate RSET or combined reports.
Enables natural language building design automation for BULC fire simulation software, allowing creation and management of rooms, walls, multi-story structures, and floor levels with spatial awareness and undo/redo support.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@BULC Building Designer Create a 6m x 5m living room with a 4m x 3m kitchen next to it"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
BULC MCP Server
Overview
BULC MCP Server is a Model Context Protocol server that connects Claude (Claude Desktop, Claude Code, or any MCP client) to the BULC desktop application — Meteor Simulation's GPU-accelerated fire dynamics simulator with a 2D/3D building editor.
Describe what you want and Claude builds it in the app: rooms and walls, the computational mesh, fire sources, detectors, sprinkler piping, HVAC ducts, evacuation agents, output slices — then checks the deck and starts the run. Everything appears in the BULC window as it happens.
Related MCP server: allplan-mcp-bridge
What you can do
The server exposes the app's own tool set (200 tools as of BULC 0.79), so it covers what the installed version of BULC covers:
Area | Examples |
Geometry |
|
Shape Studio |
|
Mesh |
|
Settings |
|
Output |
|
Fire & materials |
|
Devices & systems |
|
Evacuation |
|
Run & results |
|
Run bulc_connection_status at any time to see whether the app is connected and how many tools it
is exposing.
How it works
Claude ──stdio(MCP)──▶ bulc-mcp-server ──HTTP 127.0.0.1:8787──▶ BULC desktop app
│
the app's own tool registry
(the same one its built-in
AI assistant uses)
│
live 2D/3D editor,
FDS deck, GPU solverThe server holds no model of its own. It asks the running app for its tool list and forwards calls to it, so:
the tools you get always match the BULC version you have installed — upgrade the app and new tools appear without touching this server;
argument validation, undo, and the project state all live in the app, exactly as when you use it by hand;
the bridge listens on
127.0.0.1only. Nothing is exposed to your network, and no project data leaves your machine.
If BULC is not running yet, the server still advertises a bundled snapshot of the tool list
(src/tools-snapshot.json — descriptions and schemas only), so Claude knows what is possible and
asks you to launch the app instead of claiming the feature does not exist.
Installation
Prerequisites
BULC desktop app — download from Meteor Simulation
Node.js 18 or newer
Claude Desktop (or any MCP client)
Setup
git clone https://github.com/using76/BULC_MCP.git
cd BULC_MCP
npm install
npm run buildAdd the server to your MCP client. Claude Desktop config file:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"bulc": {
"command": "node",
"args": ["<path-to-repo>/build/index.js"]
}
}
}Restart Claude Desktop, then launch BULC. That is all — the bridge is on by default.
Configuration
Variable | Default | Purpose |
|
| Bridge port. Must match the app's |
|
| Bridge host. |
| — | Full base URL; overrides host and port. |
On the app side the bridge is enabled by default; BULC_BRIDGE=0 turns it off.
Examples
"Build a 8 × 6 m room, 3 m high, with a door on the south wall."
"Use 20 cm cells, then split the mesh at x = 4 and show me the mesh deck."
"Put a 500 kW/m² fire on a 1 m² patch in the middle of the floor, polyurethane fuel."
"Ambient temperature 25 °C, 55 % humidity, end time 120 seconds."
"Add a temperature slice at y = 3 and a wall-temperature boundary output, dump every second."
"Make the ceiling a half-round vault 3 m wide and export it as voxels."
"Check the deck for problems, then run it on the GPU."
Claude will call validate_project before running and tell you about anything that would keep the
deck from running — a dangling SURF_ID, an output interval longer than the end time (which would
store only the t = 0 frame), a domain with no OPEN boundary, and so on.
Troubleshooting
"BULC 앱에 연결할 수 없습니다" / tools fail immediately
The app is not running, or it is on a different port. Launch BULC and run bulc_connection_status.
If you changed the port in the app, set BULC_BRIDGE_PORT for the server too.
Claude lists tools but says the feature is missing The tool list was taken from the bundled snapshot because BULC was not running when your client connected. Launch BULC and restart the MCP client so it fetches the live list.
A tool call is rejected with "Tool input error" That message comes from the app: it validates every argument against the tool's schema and names what is missing, mistyped, or misspelled. Claude can usually fix it on the next attempt.
Upgrading from v2.x
Versions up to 2.3 talked to the legacy Java/SweetHome3D build of BULC over a private TCP
protocol on port 19840, with their own hand-written tools (bulc_create_room, bulc_create_wall,
bulc_list_levels, …). Those tools and that protocol are gone — v3 targets the current BULC
desktop app and uses the app's own tool names (add_obstacle, add_wall, set_mesh, …). Remove
BULC_PORT from your MCP client config; it is no longer read.
Privacy
This server runs entirely on your machine and talks only to 127.0.0.1. See
PRIVACY_POLICY.md.
License
MIT — see LICENSE.
Available Tools
75 toolsbulc_auto_meshADestructive
Automatically generate FDS mesh based on building geometry. Creates optimized mesh covering all rooms and walls with specified resolution. Can create single mesh or multiple meshes for multi-level buildings.
Inputs: cellSize, padding, heightAboveRoof, multiMesh, +1 more.
bulc_clear_evac_agentsBDestructive
Clear evacuation agents from specified room or all rooms.
Inputs: room, level.
bulc_clear_evac_stairBDestructive
Remove stair configuration from a furniture item.
Inputs: furnitureId (required).
bulc_clear_fds_dataADestructive
Clear FDS configuration from a furniture item. Removes fire source, detector, sprinkler, HVAC, or thermocouple settings.
Inputs: furnitureId (required).
bulc_create_levelBDestructive
Create a new floor level. Elevation is the height from ground (Z=0) to the floor surface in centimeters.
Inputs: name (required), elevation, floorHeight.
bulc_create_meshADestructive
Create a new FDS computational mesh with specified dimensions and cell count. The mesh defines the computational domain for fire simulation.
Inputs: xMin (required), xMax (required), yMin (required), yMax (required), +7 more.
bulc_create_roomADestructive
Create a new rectangular room at the specified position. All coordinates are in centimeters (cm). Use bulc_get_spatial_context first if you need to position relative to existing rooms. Example: To create a 5m x 4m room, use width=500, depth=400.
Inputs: x (required), y (required), width (required), depth (required), +2 more.
bulc_create_room_polygonADestructive
Create a room with a custom polygon shape defined by an array of points. Use this for non-rectangular rooms like L-shaped rooms. All coordinates are in centimeters.
Inputs: points (required), name, level.
bulc_create_wallADestructive
Create a wall segment between two points. All coordinates are in centimeters. For rectangular rooms, consider using bulc_create_walls_rectangle instead.
Inputs: xStart (required), yStart (required), xEnd (required), yEnd (required), +3 more.
bulc_create_walls_rectangleADestructive
Create 4 connected walls forming a rectangular enclosure. This is the recommended way to create walls for rectangular rooms. All coordinates are in centimeters.
Inputs: x (required), y (required), width (required), depth (required), +3 more.
bulc_delete_furnitureADestructive
Delete a furniture item by its ID. Get furniture IDs from bulc_list_furniture.
Inputs: id (required).
bulc_delete_meshBDestructive
Delete an FDS mesh by its ID.
Inputs: meshId (required).
bulc_delete_roomADestructive
Delete a room by its ID. Get room IDs from bulc_list_rooms.
Inputs: id (required).
bulc_delete_wallADestructive
Delete a wall by its ID. Get wall IDs from bulc_list_walls.
Inputs: id (required).
bulc_export_fdsBDestructive
Export the FDS input file to disk. Creates the .fds file and any required supporting files.
Inputs: outputPath, filename, includeGeometry.
bulc_generate_reportBDestructive
Generate an analysis report from FDS simulation results. Supports ASET, RSET, and combined safety analysis reports.
Inputs: reportType, outputPath, language, includeGraphs, +1 more.
bulc_generate_rset_reportBDestructive
Generate RSET (Required Safe Egress Time) analysis report from evacuation simulation results.
Inputs: outputPath, language, includeAgentDetails.
bulc_get_evac_resultBRead-only
Get detailed evacuation results including per-agent trajectories, exit statistics, and flow rate analysis.
Inputs: includeTrajectories, includeFlowRates, includeBottlenecks, timeRange, +1 more.
bulc_get_evac_settingsARead-only
Get current EVAC simulation settings including model type, agent parameters, and stair configurations.
Inputs: no named parameters.
bulc_get_evac_statusBRead-only
Get current evacuation simulation status including progress, evacuated count, and estimated completion time.
Inputs: no named parameters.
bulc_get_evac_summaryARead-only
Get evacuation result summary including total time, per-agent exit times, and statistics.
Inputs: no named parameters.
bulc_get_fds_dataBRead-only
Get FDS configuration for a furniture item. Returns the FDS category (fire source, detector, sprinkler, HVAC, thermocouple) and its configuration parameters.
Inputs: furnitureId (required).
bulc_get_fds_statusARead-only
Get current FDS simulation status. Returns running state, progress, current simulation time, and estimated completion.
Inputs: no named parameters.
bulc_get_home_infoARead-only
Get general information about the current project including file path, modification status, level count, room count, wall count, and furniture count.
Inputs: no named parameters.
bulc_get_point_dataARead-only
Extract time-series data at a specific point in the simulation domain. Useful for getting temperature, visibility, or species concentration at a location.
Inputs: x (required), y (required), z (required), variable (required), +1 more.
bulc_get_simulation_settingsBRead-only
Get current FDS simulation settings including time, ambient conditions, output settings, and numerical parameters.
Inputs: no named parameters.
bulc_get_spatial_contextARead-only
Get the current spatial layout of the project including all rooms, walls, levels, and their exact coordinates. IMPORTANT: Call this first when you need to place elements relative to existing objects (e.g., 'next to the living room', 'above the kitchen'). Returns bounds, room positions, wall positions, and level information. Use this to calculate coordinates before calling create functions.
Inputs: level.
bulc_list_evac_agentsBRead-only
List all evacuation agents with their positions and properties.
Inputs: level, room.
bulc_list_evac_exitsBRead-only
List all detected evacuation exits (doors converted to exits).
Inputs: level.
bulc_list_evac_stairsBRead-only
List all configured evacuation stairs for multi-level buildings.
Inputs: no named parameters.
bulc_list_furnitureARead-only
Get a list of all placed furniture with their IDs, positions, and properties. Use the returned IDs for modify/delete operations.
Inputs: level, room, category.
bulc_list_furniture_catalogARead-only
Get a list of available furniture items from the catalog. Use category filter to narrow down results. Returns catalog IDs needed for bulc_place_furniture.
Inputs: category, search, limit.
bulc_list_levelsBRead-only
Get all floor levels with their names, elevations (height from ground), and floor heights (ceiling height).
Inputs: no named parameters.
bulc_list_meshesARead-only
Get a list of all FDS computational meshes. Returns mesh IDs, dimensions, cell sizes, and bounding coordinates.
Inputs: no named parameters.
bulc_list_result_datasetsBRead-only
List available datasets in the loaded FDS results. Returns slices, smoke3d volumes, Plot3D, devices, and other data types.
Inputs: type.
bulc_list_roomsARead-only
Get a list of all rooms with their IDs, names, positions, and dimensions. Use the returned IDs for modify/delete operations.
Inputs: level.
bulc_list_wallsARead-only
Get a list of all walls with their IDs, coordinates, thickness, and height. Use the returned IDs for modify/delete operations.
Inputs: level.
bulc_load_evac_resultB
Load evacuation results from a .evac file for visualization.
Inputs: evacPath.
bulc_modify_evac_stairADestructive
Modify an existing evacuation stair configuration. Update capacity, speed, or position properties.
Inputs: furnitureId (required), entryX, entryY, exitX, +4 more.
bulc_modify_furnitureADestructive
Modify properties of an existing furniture item. Only specified properties will be changed. Get furniture IDs from bulc_list_furniture.
Inputs: id (required), x, y, elevation, +6 more.
bulc_modify_meshBDestructive
Modify an existing FDS mesh. Change dimensions, cell counts, or other properties.
Inputs: meshId (required), xMin, xMax, yMin, +6 more.
bulc_modify_roomADestructive
Modify properties of an existing room. Only specified properties will be changed. Get room IDs from bulc_list_rooms first.
Inputs: id (required), name, x, y, +2 more.
bulc_modify_wallADestructive
Modify properties of an existing wall. Only specified properties will be changed. Get wall IDs from bulc_list_walls.
Inputs: id (required), xStart, yStart, xEnd, +3 more.
bulc_open_evac_viewerB
Open the 3D evacuation result viewer window. Displays agents on the building model with timeline playback.
Inputs: evacPath, objPath, autoPlay, playbackSpeed, +1 more.
bulc_open_result_viewerA
Open the FDS result viewer window. Loads simulation results from the specified SMV file or last simulation.
Inputs: smvPath, loadGeometry.
bulc_place_evac_agentsADestructive
Place evacuation agents in rooms or at specific positions. Can place by count (random distribution) or at exact coordinates.
Inputs: room, level, count, positions, +4 more.
bulc_place_furnitureADestructive
Place a furniture item at the specified position. Get catalog IDs from bulc_list_furniture_catalog first. All coordinates are in centimeters.
Inputs: catalogId (required), x (required), y (required), elevation, +6 more.
bulc_preview_fdsARead-only
Generate a preview of the FDS input file without saving. Returns the complete FDS input file content for review.
Inputs: includeComments.
bulc_redoADestructive
Redo the last undone operation. Returns information about what was redone.
Inputs: no named parameters.
bulc_run_aset_analysisARead-only
Run ASET (Available Safe Egress Time) analysis at a specified exit location. Evaluates safety criteria: temperature <60C, visibility >5m, CO <1400ppm, CO2 <5%, O2 >15%.
Inputs: exitX (required), exitY (required), exitZ, criteria.
bulc_run_evacADestructive
Start evacuation simulation using JuPedSim. Returns immediately; use bulc_get_evac_status to monitor progress.
Inputs: multiLevel.
bulc_run_fdsADestructive
Start FDS simulation. Runs the simulation in background and returns immediately. Use bulc_get_fds_status to monitor progress.
Inputs: mpiProcesses, openmpThreads, outputPath.
bulc_saveBDestructive
Save the current project to file.
Inputs: path.
bulc_save_evac_resultADestructive
Save current evacuation results to a .evac file.
Inputs: outputPath, filename.
bulc_set_agent_propertiesBDestructive
Set default properties for evacuation agents (radius, speed, etc.).
Inputs: agentRadius, desiredSpeed, maxSpeed, minSpacing.
bulc_set_ambientBDestructive
Set FDS ambient conditions including temperature, pressure, and species.
Inputs: temperature, pressure, humidity, o2MassFraction, +2 more.
bulc_set_current_levelA
Set which floor level is currently active for editing. New rooms/walls will be created on this level by default.
Inputs: level (required).
bulc_set_evac_modelADestructive
Set the evacuation simulation model type and parameters. Supports CollisionFreeSpeed, SocialForce, and GeneralizedCentrifugal models.
Inputs: model, simulationTime, timeStep, strengthNeighborRepulsion, +3 more.
bulc_set_evac_timeADestructive
Set evacuation simulation time parameters. Controls total simulation duration and time step resolution.
Inputs: simulationTime (required), timeStep.
bulc_set_exit_assignmentADestructive
Set the exit assignment strategy for evacuation agents. Determines how agents choose which exit to use.
Inputs: mode (required), balanceThreshold, customAssignments.
bulc_set_fds_detectorBDestructive
Configure a furniture item as an FDS detector (heat or smoke). Heat detectors use RTI and activation temperature. Smoke detectors use optical obscuration threshold.
Inputs: furnitureId (required), type, rti, activationTemperature, +4 more.
bulc_set_fds_fire_sourceADestructive
Configure a furniture item as an FDS fire source. Supports HRRPUA (Heat Release Rate Per Unit Area) mode with time-based ramping. The fire will use the furniture's surface area for HRR calculations.
Inputs: furnitureId (required), hrrpua, surfaceId, color, +2 more.
bulc_set_fds_hvacADestructive
Configure a furniture item as an FDS HVAC (supply or exhaust vent). Assigns surface properties to specific faces of the obstruction. Supply vents blow air in, exhaust vents extract air out.
Inputs: furnitureId (required), surfaces, flowType, flowValue, +2 more.
bulc_set_fds_sprinklerADestructive
Configure a furniture item as an FDS sprinkler. Uses RTI and activation temperature for thermal response, with water spray parameters for suppression simulation.
Inputs: furnitureId (required), rti, activationTemperature, flowRate, +4 more.
bulc_set_fds_thermocoupleADestructive
Configure a furniture item as an FDS thermocouple for temperature measurement. Used to record temperature at specific locations during simulation.
Inputs: furnitureId (required), beadDiameter, emissivity, deviceId.
bulc_set_fire_couplingBDestructive
Configure fire-evacuation coupling for FDS+EVAC integration. Sets visibility and temperature thresholds that affect agent behavior.
Inputs: enabled, visibilityThreshold, temperatureThreshold, coThreshold, +3 more.
bulc_set_output_settingsBDestructive
Configure FDS output settings for visualization data. Controls slice files, 3D smoke, and device output intervals.
Inputs: sliceInterval, smoke3dInterval, deviceInterval, plot3dInterval, +2 more.
bulc_set_premovement_timeADestructive
Set pre-movement time parameters for evacuation agents. Includes detection time and reaction time with statistical distributions.
Inputs: detectionTime, reactionTimeMean, reactionTimeStdDev, distribution, +4 more.
bulc_set_simulation_timeADestructive
Set FDS simulation time parameters. Controls simulation duration and time step settings.
Inputs: duration (required), dtInit, dtMax.
bulc_setup_evac_stairADestructive
Configure a furniture item as an evacuation stair connection between floors. Defines entry/exit positions, capacity, and travel speed.
Inputs: furnitureId (required), fromFloor (required), toFloor (required), entryX, +6 more.
bulc_stop_evacADestructive
Stop a running evacuation simulation.
Inputs: no named parameters.
bulc_stop_fdsADestructive
Stop a running FDS simulation. Sends stop signal and waits for graceful shutdown.
Inputs: force.
bulc_undoBDestructive
Undo the last operation. Returns information about what was undone.
Inputs: no named parameters.
bulc_validate_evacBRead-only
Validate evacuation setup for errors and warnings. Checks agents, exits, walkable areas, and stair configurations.
Inputs: no named parameters.
bulc_validate_fdsARead-only
Validate FDS configuration for errors and warnings. Checks mesh consistency, fire source setup, boundary conditions, etc.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 75 tools
Most tools have distinct purposes with clear boundaries, such as separate tools for creating, modifying, listing, and deleting different entities (rooms, walls, furniture, meshes). However, some overlap exists in evacuation-related tools (e.g., bulc_get_evac_result, bulc_get_evac_summary, bulc_load_evac_result) where the distinctions are subtle but clarified by descriptions.
All tools follow a consistent 'bulc_verb_noun' pattern with snake_case, making them predictable and readable. The naming convention is uniform across all 75 tools, with verbs like create, get, list, set, run, and modify used consistently for similar operations.
With 75 tools, the set is excessively large for a building design and fire simulation server, leading to potential overwhelm and redundancy. While the domain is complex, many tools could be consolidated (e.g., multiple evacuation result tools) or parameterized to reduce count without losing functionality.
The tool set provides comprehensive coverage for building design, fire dynamics simulation (FDS), and evacuation analysis, including full CRUD operations for rooms, walls, furniture, and meshes, plus simulation setup, execution, monitoring, and result analysis. No obvious gaps are present for the intended domain.
Related MCP Connectors
Design buildings in 3D by chat: rooms, walls, doors, windows, stairs, roofs and furniture.
Create projects, nodes, and tasks in UluP Spaces by conversation with Claude.
Deploy sims to any screen. Control your displays with Claude.
Deploy sims to any screen. Control your displays with Claude.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA companion desktop app enabling bi-directional interaction between Claude Desktop and visual UI elements, allowing Claude to display, read from, and write to interactive interfaces while processing user events and feedback.5 npm8Apache 2.0
- FlicenseBqualityBmaintenanceEnables Claude to create, query, and modify BIM elements in Allplan via natural language, with full undo history support.225-
- AlicenseBqualityDmaintenanceEnables Claude Desktop to interact with Unreal Engine 5.3 via Remote Control API, creating and manipulating 3D objects from text prompts for scene building and editor control.2147MIT
- AlicenseNot gradedqualityDmaintenanceConnects Claude AI to AutoCAD for architectural design, enabling natural language to execute 684 commands. Automates drawing creation and editing through the Model Context Protocol.43 npm9MIT