Skip to main content
Glama
BULC Building Designer
by using76

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

add_obstacle, add_wall, add_floor, add_door, add_window, add_hole, transform_obstacle (move/scale/rotate), place_furniture, list_obstacles

Shape Studio

shape_add_box/cylinder/sphere/cone/torus/wedge/polygon_prism/revolve/arch, shape_boolean, shape_array, shape_mirror, shape_export_obst, shape_export_geom, shape_export_stl/obj

Mesh

set_mesh, set_mesh_cell_size, auto_fit_mesh, list_meshes, set_meshes, slice_mesh, merge_meshes, auto_multimesh, auto_cutcell_mesh

Settings

set_time, set_simulation_mode, set_turbulence_model, set_numerics (CFL/VN/flux limiter), set_ambient (temperature, humidity, CO₂), get_simulation_settings, add_raw_namelist

Output

set_chid, add_slcf/update_slcf/list_slcf, add_bndf/list_bndf, set_plot3d_outputs, update_dump_config, preview_fds (see the deck without saving)

Fire & materials

add_fire, update_reaction, add_species, add_material, add_surface, assign_surface, material/surface libraries

Devices & systems

add_heat_detector, add_smoke_detector, add_thermocouple, add_sprinkler, add_control, spr_* (sprinkler piping & hydraulics), hvac_* (ducts, diffusers, air handlers)

Evacuation

evac_add_agent, evac_add_agents_batch, evac_add_stair, evac_add_waypoint, evac_add_journey, evac_update_setup

Run & results

validate_project (pre-flight check), run_simulation, result_set_time, result_set_colormap, result_set_legend_range, result_set_particles

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 solver

The 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.1 only. 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

  1. BULC desktop app — download from Meteor Simulation

  2. Node.js 18 or newer

  3. Claude Desktop (or any MCP client)

Setup

git clone https://github.com/using76/BULC_MCP.git
cd BULC_MCP
npm install
npm run build

Add the server to your MCP client. Claude Desktop config file:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • macOS: ~/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

BULC_BRIDGE_PORT

8787

Bridge port. Must match the app's BULC_BRIDGE_PORT.

BULC_BRIDGE_HOST

127.0.0.1

Bridge host.

BULC_BRIDGE_URL

—

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 tools
bulc_auto_meshA
Destructive

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_agentsB
Destructive

Clear evacuation agents from specified room or all rooms.

Inputs: room, level.

bulc_clear_evac_stairB
Destructive

Remove stair configuration from a furniture item.

Inputs: furnitureId (required).

bulc_clear_fds_dataA
Destructive

Clear FDS configuration from a furniture item. Removes fire source, detector, sprinkler, HVAC, or thermocouple settings.

Inputs: furnitureId (required).

bulc_create_levelB
Destructive

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_meshA
Destructive

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_roomA
Destructive

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_polygonA
Destructive

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_wallA
Destructive

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_rectangleA
Destructive

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_furnitureA
Destructive

Delete a furniture item by its ID. Get furniture IDs from bulc_list_furniture.

Inputs: id (required).

bulc_delete_meshB
Destructive

Delete an FDS mesh by its ID.

Inputs: meshId (required).

bulc_delete_roomA
Destructive

Delete a room by its ID. Get room IDs from bulc_list_rooms.

Inputs: id (required).

bulc_delete_wallA
Destructive

Delete a wall by its ID. Get wall IDs from bulc_list_walls.

Inputs: id (required).

bulc_export_fdsB
Destructive

Export the FDS input file to disk. Creates the .fds file and any required supporting files.

Inputs: outputPath, filename, includeGeometry.

bulc_generate_reportB
Destructive

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_reportB
Destructive

Generate RSET (Required Safe Egress Time) analysis report from evacuation simulation results.

Inputs: outputPath, language, includeAgentDetails.

bulc_get_evac_resultB
Read-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_settingsA
Read-only

Get current EVAC simulation settings including model type, agent parameters, and stair configurations.

Inputs: no named parameters.

bulc_get_evac_statusB
Read-only

Get current evacuation simulation status including progress, evacuated count, and estimated completion time.

Inputs: no named parameters.

bulc_get_evac_summaryA
Read-only

Get evacuation result summary including total time, per-agent exit times, and statistics.

Inputs: no named parameters.

bulc_get_fds_dataB
Read-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_statusA
Read-only

Get current FDS simulation status. Returns running state, progress, current simulation time, and estimated completion.

Inputs: no named parameters.

bulc_get_home_infoA
Read-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_dataA
Read-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_settingsB
Read-only

Get current FDS simulation settings including time, ambient conditions, output settings, and numerical parameters.

Inputs: no named parameters.

bulc_get_spatial_contextA
Read-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_agentsB
Read-only

List all evacuation agents with their positions and properties.

Inputs: level, room.

bulc_list_evac_exitsB
Read-only

List all detected evacuation exits (doors converted to exits).

Inputs: level.

bulc_list_evac_stairsB
Read-only

List all configured evacuation stairs for multi-level buildings.

Inputs: no named parameters.

bulc_list_furnitureA
Read-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_catalogA
Read-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_levelsB
Read-only

Get all floor levels with their names, elevations (height from ground), and floor heights (ceiling height).

Inputs: no named parameters.

bulc_list_meshesA
Read-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_datasetsB
Read-only

List available datasets in the loaded FDS results. Returns slices, smoke3d volumes, Plot3D, devices, and other data types.

Inputs: type.

bulc_list_roomsA
Read-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_wallsA
Read-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_stairA
Destructive

Modify an existing evacuation stair configuration. Update capacity, speed, or position properties.

Inputs: furnitureId (required), entryX, entryY, exitX, +4 more.

bulc_modify_furnitureA
Destructive

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_meshB
Destructive

Modify an existing FDS mesh. Change dimensions, cell counts, or other properties.

Inputs: meshId (required), xMin, xMax, yMin, +6 more.

bulc_modify_roomA
Destructive

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_wallA
Destructive

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_agentsA
Destructive

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_furnitureA
Destructive

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_fdsA
Read-only

Generate a preview of the FDS input file without saving. Returns the complete FDS input file content for review.

Inputs: includeComments.

bulc_redoA
Destructive

Redo the last undone operation. Returns information about what was redone.

Inputs: no named parameters.

bulc_run_aset_analysisA
Read-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_evacA
Destructive

Start evacuation simulation using JuPedSim. Returns immediately; use bulc_get_evac_status to monitor progress.

Inputs: multiLevel.

bulc_run_fdsA
Destructive

Start FDS simulation. Runs the simulation in background and returns immediately. Use bulc_get_fds_status to monitor progress.

Inputs: mpiProcesses, openmpThreads, outputPath.

bulc_saveB
Destructive

Save the current project to file.

Inputs: path.

bulc_save_evac_resultA
Destructive

Save current evacuation results to a .evac file.

Inputs: outputPath, filename.

bulc_set_agent_propertiesB
Destructive

Set default properties for evacuation agents (radius, speed, etc.).

Inputs: agentRadius, desiredSpeed, maxSpeed, minSpacing.

bulc_set_ambientB
Destructive

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_modelA
Destructive

Set the evacuation simulation model type and parameters. Supports CollisionFreeSpeed, SocialForce, and GeneralizedCentrifugal models.

Inputs: model, simulationTime, timeStep, strengthNeighborRepulsion, +3 more.

bulc_set_evac_timeA
Destructive

Set evacuation simulation time parameters. Controls total simulation duration and time step resolution.

Inputs: simulationTime (required), timeStep.

bulc_set_exit_assignmentA
Destructive

Set the exit assignment strategy for evacuation agents. Determines how agents choose which exit to use.

Inputs: mode (required), balanceThreshold, customAssignments.

bulc_set_fds_detectorB
Destructive

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_sourceA
Destructive

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_hvacA
Destructive

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_sprinklerA
Destructive

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_thermocoupleA
Destructive

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_couplingB
Destructive

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_settingsB
Destructive

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_timeA
Destructive

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_timeA
Destructive

Set FDS simulation time parameters. Controls simulation duration and time step settings.

Inputs: duration (required), dtInit, dtMax.

bulc_setup_evac_stairA
Destructive

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_evacA
Destructive

Stop a running evacuation simulation.

Inputs: no named parameters.

bulc_stop_fdsA
Destructive

Stop a running FDS simulation. Sends stop signal and waits for graceful shutdown.

Inputs: force.

bulc_undoB
Destructive

Undo the last operation. Returns information about what was undone.

Inputs: no named parameters.

bulc_validate_evacB
Read-only

Validate evacuation setup for errors and warnings. Checks agents, exits, walkable areas, and stair configurations.

Inputs: no named parameters.

bulc_validate_fdsA
Read-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

    A3.6/5.0

    Scored across 75 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness5/5

    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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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 npm
      8
      Apache 2.0
    • F
      license
      B
      quality
      B
      maintenance
      Enables Claude to create, query, and modify BIM elements in Allplan via natural language, with full undo history support.
      2
      25
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects 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 npm
      9
      MIT