Skip to main content
Glama
BULC MCP

BULC MCP

Official

BULC MCP


한국어

무엇인가

BULC MCP 는 Model Context Protocol 서버입니다. Claude Desktop, Claude Code, Cursor, VS Code 같은 MCP 클라이언트의 AI 가 이 PC 에서 실행 중인 BULC 데스크톱 앱(FDS 6.10.1 기반 GPU 화재 시뮬레이터, 2D/3D 건물 편집기)을 자연어로 조작하게 합니다.

  • 앱의 모든 기능: 프로젝트 열기·저장, 도면 인식, 형상·Shape Studio, 격자, 해석 설정·사전 점검·실행·진행 확인, 출력, 화원, 재료, 감지기·제어, 스프링클러/물분무 배관망과 수리계산·펌프 사양·설계 검토, HVAC 덕트망, 피난 배치·실행·결과, 화재 결과 요약·ASET 판정, 결과 뷰어(결과 세트 열기·데이터셋 읽기), 화면 보기(레이어·물체 숨기기·화면 가운데 맞춤·3D 연기 미리보기)·화면 캡처 — BULC 0.103 기준 앱 도구 298종(BIM 평면·IFC 가져오기/내보내기, 압력 존·누설·문 상태, FDS 전문가 키, Shape Studio CAD, 온톨로지 조회 포함)을 그대로 노출합니다. 앱을 업데이트하면 새 도구가 이 서버를 다시 설치하지 않아도 따라옵니다.

  • 도면 기반 작업: 사용자가 PC 의 도면 파일(DWG, DXF, PDF, 이미지, ZIP 묶음, IFC) 경로를 알려 주면, 서버가 파일을 로컬에서 분류하고(bulc_drawing_intake) 맞는 작업 절차를 돌려줍니다. 건축 평면도는 앱이 벽·문·창·기둥·실명을 인식해 건물을 만들고(arch_analyze_drawing → arch_import_building), 스프링클러·물분무 배관 도면은 배관망을 만듭니다(spr_analyze_drawing → spr_import_network).

  • 오류를 줄이는 지식 팩: 온톨로지(클래스 83개), 규칙 213개(조건 → 확인 → 고치는 법), 흔한 LLM 실수 38개, 단계별 플레이북 6편, 한·영·FDS·도구 용어집, FDS 6.10.1 키 참조를 MCP resources·prompts·도구로 제공합니다. 실행 전 계획 점검(bulc_plan_check)과 덱 점검(bulc_check_deck)이 들어 있습니다.

이 저장소에는 BULC 앱이나 해석 엔진의 소스가 없습니다. 서버는 앱이 127.0.0.1 에서 여는 브리지에 요청을 전달하는 얇은 클라이언트입니다.

분야별로 할 수 있는 일

분야

대표 도구

흐름

프로젝트

project_info, project_open, project_save, project_export_fds, project_undo, fds_apply_text, capture_view

연 프로젝트 읽기 → 편집 → 저장(덮어쓰기는 확인 뒤)

건축 도면 → 건물

arch_analyze_drawing, arch_import_building, arch_import_floorplan_report, add_wall·add_door·add_window

인식 → 질문 확인 → dryRun → 생성(되돌리기 1단계)

화재·연기 해석

set_mesh·auto_multimesh, add_fire, set_all_boundaries_open, output_add_tenability_slices, sim_preflight, sim_start, sim_status

격자 → 화원(사용자 지시) → 경계 → 출력 → 점검 → 확인 → 실행

결과·ASET

results_detect, fire_results_summary, fire_timeseries, fire_compute_aset, result_*

최대 HRR·감지 시각 → 출구별 ASET(1.8 m)

피난·RSET

evac_add_agents_batch, evac_add_stair, evac_add_journey, evac_run, evac_status, evac_get_results

배치 → 계단·경로 → 실행 → 출구별 통계·RSET

HVAC 제연

hvac_add_node, hvac_add_duct, hvac_add_exhaust_grille, hvac_run_calc, hvac_apply_to_fds

덕트망 → 풍량 계산 → FDS 반영

스프링클러·물분무

spr_analyze_drawing, spr_import_network, spr_auto_layout, spr_run_calc, spr_pump_sizing, spr_design_review, spr_apply_to_fds, spr_export_results

도면 인식·자동 배치 → 수리계산 → 펌프·검토 → FDS 작동 해석·계산서

앱 버전에 따라 도구 집합이 다릅니다. 0.88 이하 앱에는 project_*·sim_*·fire_*·evac_run·arch_*·capture_view 가 없고, 지식 팩의 규칙이 그때의 대안(앱 파일 메뉴, run_simulation, 수동 벽 입력)을 알려 줍니다.

동작 방식

MCP 클라이언트 ──stdio──▶ bulc-mcp (이 저장소)
 (Claude 등)               ├─ 로컬 도구: 연결 상태 · 지식 검색 · 규칙 · 계획 점검 · 도면 분류 · 덱 점검 · 격자 조언
                           ├─ resources: bulc://knowledge/… (온톨로지·규칙·플레이북·용어집·FDS 키)
                           ├─ prompts: 작업 절차 8종
                           └─ 앱 도구 ──HTTP 127.0.0.1──▶ BULC 데스크톱 앱 (2D/3D 편집기 · 도면 인식 · 덱 생성 · GPU/CPU 솔버)
  • 앱이 켜져 있으면 앱의 도구 목록을 그대로 쓰고, 꺼져 있으면 내장 스냅샷(이름·설명·입력 스키마만)으로 목록을 채웁니다. 앱이 나중에 켜지거나 도구 집합이 바뀌면 tools/list_changed 알림을 보냅니다.

  • 앱이 돌려준 그림(capture_view)은 이미지로, 구조화 결과(sim_preflight, fire_compute_aset 등)는 structuredContent 로 전달합니다.

  • 앱이 HTTP 200 으로 돌려주는 오류 문구(Tool input error, Unknown tool 등)는 오류(isError)로 표시하고 관련 규칙을 덧붙입니다.

  • 브리지 포트에서 BULC 가 아닌 프로그램이 응답하면 알아채고 알려 줍니다. 루프백(127.0.0.1) 밖의 주소에는 연결하지 않습니다.

요구 사항

  1. BULC 데스크톱 앱(라이선스 필요), 실행 중이어야 합니다. 0.90 이상을 권합니다(0.88 은 줄어든 도구 집합으로 동작). 설치 파일: Meteor-Simulation/bulc-releases. 브리지는 기본으로 켜져 있습니다(앱 환경 변수 BULC_BRIDGE=0 이면 꺼짐).

  2. Node.js 20 이상

  3. MCP 클라이언트(Claude Desktop, Claude Code, Cursor, VS Code 등)

설치

Claude Desktop — 설정 파일(Windows %APPDATA%\Claude\claude_desktop_config.json, macOS ~/Library/Application Support/Claude/claude_desktop_config.json)에 추가합니다.

{
  "mcpServers": {
    "bulc": {
      "command": "npx",
      "args": ["-y", "github:Meteor-Simulation/bulc-mcp"]
    }
  }
}

Windows 에서 npx 를 찾지 못하면 "command": "cmd", "args": ["/c", "npx", "-y", "github:Meteor-Simulation/bulc-mcp"] 로 바꿉니다.

Claude Code

claude mcp add bulc --scope user -- npx -y github:Meteor-Simulation/bulc-mcp

Cursor (~/.cursor/mcp.json) — 도구 수 상한이 있는 클라이언트는 compact 프로필을 권합니다.

{ "mcpServers": { "bulc": { "command": "npx", "args": ["-y", "github:Meteor-Simulation/bulc-mcp"], "env": { "BULC_MCP_PROFILE": "compact" } } } }

VS Code (.vscode/mcp.json)

{ "servers": { "bulc": { "type": "stdio", "command": "npx", "args": ["-y", "github:Meteor-Simulation/bulc-mcp"] } } }

소스에서

git clone https://github.com/Meteor-Simulation/bulc-mcp.git
cd bulc-mcp
npm install        # prepare 단계에서 빌드합니다
node build/server.js

클라이언트 설정의 command 는 node, args 는 ["<저장소 경로>/build/server.js"] 로 둡니다.

앱 찾기(브리지 주소와 토큰)

설정 없이 동작합니다. BULC 앱(0.90 이상)은 브리지를 열 때 사용자 설정 폴더에 발견 파일 BULC/bridge.json(Windows %APPDATA%\BULC\bridge.json)을 쓰고, 이 서버가 그 파일에서 주소·포트·토큰을 읽습니다. 앱이 8787 이 아닌 포트에서 돌아도(다른 프로그램이 8787 을 쓰는 경우) 그대로 찾습니다. 종료된 앱이 남긴 파일은 무시합니다.

  • 순서: BULC_BRIDGE_URL → 발견 파일 → BULC_BRIDGE_HOST/BULC_BRIDGE_PORT(기본 127.0.0.1:8787).

  • 앱을 BULC_BRIDGE_AUTH=sensitive|all 로 실행하면 파일·실행 도구(또는 전부)에 토큰이 필요합니다. 서버는 발견 파일의 토큰을 그 주소에만 Authorization: Bearer 로 보냅니다. 발견 파일을 읽을 수 없는 환경에서는 BULC_BRIDGE_TOKEN 을 씁니다.

  • 발견 파일을 쓰지 않는 구버전 앱이 다른 포트에서 돌면 BULC_BRIDGE_URL(예: http://127.0.0.1:8790)을 지정합니다. bulc_connection_status 가 연결 여부, 주소를 찾은 경로, "BULC 가 아닌 프로그램이 응답함", 앱과 내장 스냅샷의 도구 집합 차이를 알려 줍니다.

환경 변수

변수

기본값

설명

BULC_BRIDGE_URL

—

브리지 전체 주소(가장 우선), 예: http://127.0.0.1:8790

BULC_BRIDGE_DISCOVERY_FILE

앱과 같은 위치

발견 파일 경로를 바꿈. 0 이면 읽지 않음

BULC_BRIDGE_TOKEN

—

브리지 토큰(발견 파일 없이 BULC_BRIDGE_AUTH 앱에 연결할 때)

BULC_BRIDGE_PORT / BULC_BRIDGE_HOST

8787 / 127.0.0.1

발견 파일이 없을 때 쓰는 주소

BULC_MCP_PROFILE

full

compact: 로컬 도구 + bulc_find_tools·bulc_call 만 노출(도구 수 상한이 있는 클라이언트용)

BULC_MCP_TOOLSETS

—

full 에서 노출할 앱 도구 분류(쉼표): project, arch, geometry, fire, ventilation, device, mesh, material, surface, output, query, evac, spr, hvac, draw, furniture, result, shape, shapeext, bim, pressure, expert, view, ontology

BULC_MCP_HIDE_TOOLS

—

숨길 도구(쉼표), 예: project_new,sim_stop

BULC_MCP_HINTS

1

0 이면 도구 설명 끝의 규칙 id 힌트를 붙이지 않음(힌트는 설명을 1,024자 넘게 늘리지 않음)

BULC_MCP_MAX_DESCRIPTION

—

도구 설명 길이 상한(문자 수). 1,024자 제한이 있는 클라이언트는 1024

BULC_MCP_CALL_TIMEOUT_MS

120000

앱 도구 호출 시간 제한(도면 분석·결과 읽기·열기 등 일부는 5분 이상)

BULC_MCP_WATCH_MS

15000

앱 연결 감시 간격(0 이면 끔)

BULC_MCP_ATTACH_IMAGES

1

0 이면 capture_view·shape_screenshot 그림을 이미지로 첨부하지 않음

BULC_MCP_ALLOW_REMOTE

0

1 이면 루프백이 아닌 브리지 주소 허용(권장하지 않음)

도구

이 서버의 로컬 도구 — 앱 없이도 동작하는 것은 ○ 로 표시했습니다.

도구

앱 없이

하는 일

bulc_connection_status

○

브리지 주소와 찾은 경로, 연결 여부, BULC 식별, 도구 수, 스냅샷과의 차이

bulc_knowledge_search

○

규칙 id·클래스·FDS 키·오류 번호·자유 낱말(한/영)로 지식 팩 검색

bulc_get_rules

○

영역·심각도·클래스·도구별 규칙 목록

bulc_plan_check

○

호출하려는 도구 순서를 규칙으로 점검(없는 도구·인자, 단위, XB 순서, HRR, 화원 지시, 바닥 개방, 재계산 누락, 헤드·단말 label, 도면 가져오기 dryRun, 실행 전 점검·확인, 피난 실행 순서 등)

bulc_drawing_intake

○

도면 파일을 로컬에서 분류하고 플레이북·질문·도구 순서를 돌려줌. DXF 평면은 벽 중심선 후보 추출(구버전 앱용)

bulc_check_deck

○

FDS 6.10.1 덱 결정적 점검(파일·텍스트·앱의 현재 덱)

bulc_mesh_advisor

○

D* 와 셀 크기, 2·3·5 친화 IJK, 총 셀 수

bulc_find_tools

○

키워드로 앱 도구와 입력 스키마 찾기

bulc_call

(compact 프로필) 이름으로 앱 도구 호출

get_project_summary

앱 프로젝트 짧은 요약(0.90 이상은 project_info 가 더 자세함)

run_simulation

모든 앱 버전용 실행 가드 — validate_project 를 먼저 돌려 오류가 있으면 실행하지 않음(0.90 이상은 sim_preflight → sim_start 권장)

앱 도구(BULC 0.103 기준 298종): 프로젝트·실행·결과 25 · 건축 도면 3 · BIM 평면·IFC 10 · 형상 14 · 화재 6 · 경계 5 · 압력 존·누설·문 상태 7 · 장치·제어 14 · 격자 21 · 재료 6 · 표면 10 · 출력 10 · FDS 전문가 키 3 · 조회·점검 7 · 온톨로지 5 · 피난 20 · 스프링클러·물분무 33 · HVAC 21 · 층 7 · 가구 3 · 결과 뷰어 11 · 화면 보기 4 · Shape Studio 33 + 정의·배치·스케치 20. 도구마다 읽기 전용·파괴적·멱등 주석이 붙고, 실행 중인 앱에서만 동작하는 도구(열기·저장·실행·캡처 등)는 "Live app only" 로 표시됩니다.

지식 팩

종류

위치

온톨로지

bulc://knowledge/ontology (YAML), bulc://knowledge/ontology.jsonld, 클래스별 bulc://knowledge/class/{name}

규칙

bulc://knowledge/rules, 영역별 bulc://knowledge/rules/{domain}, 하나씩 bulc://knowledge/rule/{id}

플레이북

bulc://knowledge/playbooks/01-architectural-drawing-fire-aset … 06-troubleshooting

용어집

bulc://knowledge/glossary

FDS 6.10.1 키

bulc://knowledge/fds-6.10.1/keys, 그룹별 bulc://knowledge/fds-6.10.1/namelist/{group}

도구 카드

bulc://tools/{name} (설명·스키마·주석·관련 규칙)

라이브

bulc://project/summary, bulc://project/deck (앱 필요)

prompts

bulc-start, drawing-to-fire-aset, evacuation-rset, hvac-smoke-control, sprinkler-design, marine-water-spray-iso, troubleshooting, review-fds-deck

LLM 이 지식 팩을 쓰는 방식:

  1. 초기화 instructions — 연결하면 서버가 핵심 규칙 10개(단위, 읽고 쓰기, 도면, 화원 지시, 실행 전 점검·확인, 결과 보고)를 보냅니다.

  2. 도구 설명의 규칙 힌트 — 앱 도구마다 관련 규칙 id 가 붙어 있어([bulc-mcp rules] VENT-002 …) 모델이 bulc_knowledge_search "<id>" 로 원문을 찾습니다.

  3. 계획 점검 — 여러 단계 작업 전에 bulc_plan_check 가 도구 순서를 규칙으로 점검해 오류·경고와 따를 플레이북을 돌려줍니다(앱 없이 동작).

  4. 오류 응답의 안내 — 앱이 인자를 거절하거나 없는 도구를 부르면 결과에 규칙 id 와 실제 도구 이름을 덧붙입니다.

  5. prompts·resources — 작업별 prompt 가 플레이북 전문과 그 규칙을 한 번에 넣어 줍니다.

자세한 내용은 knowledge/README.md 를 보십시오.

도면으로 작업하기

  1. 도면을 PC 에 두고 절대 경로를 AI 에게 알려 줍니다(채팅 첨부 파일은 MCP 서버가 읽을 수 없습니다).

  2. AI 가 bulc_drawing_intake 로 분류하고, 단위·축척·기준점·층고·최종 출구를 묻습니다.

  3. 건축 평면도: arch_analyze_drawing 이 벽·문·창·기둥·실명·층 표기를 인식하고 확인할 질문을 냅니다 → arch_import_building 을 dryRun(기본)으로 개수·크기를 보여 주고 → 동의하면 건물을 만듭니다(되돌리기 1단계). 그림이나 글자가 윤곽선인 PDF 는 AI 가 그림을 읽어 arch_import_floorplan_report 로 넣습니다.

  4. 스프링클러 평면·배관 ISO: spr_analyze_drawing → 열린 끝·참조선·모호한 항목 확인 → spr_import_network(먼저 dryRun) → 수리계산·펌프·검토.

  5. 그 건물 위에서 화재(사용자가 정한 화원만), 피난, HVAC, 스프링클러 작업을 이어 갑니다. 실행은 sim_preflight → 조건 요약·확인 → sim_start 순서이고, 결과는 fire_results_summary·fire_compute_aset·evac_get_results 가 돌려준 값만 보고합니다.

합성 예제: examples/ (평면 DXF, 물분무 ISO DXF, FDS 덱, 예시 세션).

개인정보와 보안

  • 서버는 사용자 PC 에서만 실행되고 127.0.0.1 의 BULC 앱에만 연결합니다. 텔레메트리는 없습니다.

  • 서버가 직접 읽는 파일은 사용자가 지정한 도면·덱과 앱의 발견 파일뿐이며, 어디에도 올리지 않습니다. 브리지 토큰은 그 앱 주소에만 보냅니다.

  • 다만 도구 결과(도면 인식 요약, 화면 캡처 포함)는 대화의 일부로 사용자가 쓰는 AI 공급자에게 전달됩니다. 보안이 엄격한 도면은 로컬 LLM 을 쓰는 MCP 클라이언트를 검토하십시오.

  • 자세한 내용: PRIVACY_POLICY.md, SECURITY.md

문제 해결

증상

조치

"BULC 앱에 연결할 수 없습니다"

앱을 실행하고 bulc_connection_status 로 확인. 구버전 앱이 다른 포트에서 돌면 BULC_BRIDGE_URL 지정

"BULC 가 아닌 프로그램이 응답합니다"

다른 프로그램이 같은 포트를 씀 → 앱을 켜 두면 발견 파일로 찾음. 안 되면 앱을 빈 포트로 실행하고 BULC_BRIDGE_URL 지정

"브리지 토큰이 필요합니다"

앱이 BULC_BRIDGE_AUTH 로 실행됨 → 발견 파일을 읽을 수 있게 하거나 BULC_BRIDGE_TOKEN 설정

앱을 켰는데 도구 목록이 그대로

클라이언트가 tools/list_changed 를 지원하지 않으면 클라이언트를 다시 시작

Tool input error

앱이 인자를 검증한 결과입니다. 문구가 제안하는 인자 이름으로 다시 호출

project_*·sim_*·arch_* 가 없음

0.88 이하 앱입니다. 앱을 업데이트하거나 규칙의 대안(파일 메뉴, run_simulation, 수동 벽 입력)을 따름(GEN-014, GEN-016, DRW-004)

도구가 너무 많다는 오류

BULC_MCP_PROFILE=compact 또는 BULC_MCP_TOOLSETS 사용

라이선스

이 서버의 코드와 지식 팩은 MIT 입니다. BULC 데스크톱 앱과 해석 엔진은 별도의 상용 라이선스로 제공되며 이 저장소에 포함되지 않습니다. "BULC" 는 Meteor Simulation 의 상표이며, MIT 라이선스는 상표 사용권을 주지 않습니다. 인용한 외부 자료의 출처는 NOTICE.md 에 있습니다.


Related MCP server: idfkit-mcp

English

What it is

BULC MCP is a Model Context Protocol server. It lets the AI in an MCP client — Claude Desktop, Claude Code, Cursor, VS Code and others — drive the BULC desktop app running on the same PC (a GPU fire simulator built on FDS 6.10.1, with a 2D/3D building editor) in plain language.

  • Every app feature: opening and saving projects, drawing recognition, geometry, Shape Studio, meshing, run settings, pre-flight checks, runs and progress, outputs, fires, materials, detectors and controls, sprinkler / water-spray networks with hydraulics, pump sizing and design review, HVAC ducts, evacuation set-up, runs and results, fire result summaries and ASET, the result viewer and screenshots, BIM floor plans with IFC import / export, pressure zones and leakage, FDS expert keys, view layers / hiding / camera focus / 3D smoke preview and ontology look-ups — 298 app tools as of BULC 0.103, taken live from the app so new app versions bring new tools without reinstalling this server.

  • Work from drawings: give the AI the local path of a DWG, DXF, PDF, image, ZIP bundle or IFC file. bulc_drawing_intake classifies it on your PC and returns the playbook. The app recognises architectural floor plans (walls, doors, windows, columns, room names) and builds the building (arch_analyze_drawing → arch_import_building), and turns sprinkler / water-spray piping drawings into pipe networks (spr_analyze_drawing → spr_import_network).

  • A knowledge pack that prevents mistakes: an ontology (83 classes), 213 rules (condition → check → fix), 38 common LLM mistakes, six playbooks, a Korean–English–FDS–tool glossary and an FDS 6.10.1 key reference, served as MCP resources, prompts and tools. Plans and decks are checked before acting (bulc_plan_check, bulc_check_deck).

This repository contains no BULC application or solver source. The server is a thin client of the bridge the app opens on 127.0.0.1.

What it can do, by domain

Domain

Key tools

Flow

Project

project_info, project_open, project_save, project_export_fds, project_undo, fds_apply_text, capture_view

read → edit → save (overwrite only after consent)

Drawing → building

arch_analyze_drawing, arch_import_building, arch_import_floorplan_report

recognise → confirm → dry run → build (one undo step)

Fire & smoke

set_mesh, add_fire, set_all_boundaries_open, output_add_tenability_slices, sim_preflight, sim_start, sim_status

mesh → fire (user-given) → boundaries → outputs → check → consent → run

Results & ASET

results_detect, fire_results_summary, fire_timeseries, fire_compute_aset

peak HRR, detector times → ASET per exit at 1.8 m

Evacuation & RSET

evac_add_agents_batch, evac_add_stair, evac_run, evac_status, evac_get_results

place → stairs/routes → run → per-exit statistics, RSET

HVAC smoke control

hvac_add_node, hvac_add_duct, hvac_run_calc, hvac_apply_to_fds

network → airflow → FDS

Sprinkler & water spray

spr_analyze_drawing, spr_import_network, spr_run_calc, spr_pump_sizing, spr_design_review, spr_apply_to_fds

recognise / lay out → hydraulics → pump & review → FDS activation

BULC 0.88 and older lack project_*, sim_*, fire_*, evac_run, arch_* and capture_view; the rules describe the fallbacks.

Requirements

  1. The BULC desktop app (licensed), running — 0.90 or later recommended (0.88 works with the smaller tool set). Installer: Meteor-Simulation/bulc-releases. The bridge is on by default (BULC_BRIDGE=0 in the app's environment turns it off).

  2. Node.js 20+

  3. An MCP client.

Install

Claude Desktop (claude_desktop_config.json):

{ "mcpServers": { "bulc": { "command": "npx", "args": ["-y", "github:Meteor-Simulation/bulc-mcp"] } } }

Claude Code: claude mcp add bulc --scope user -- npx -y github:Meteor-Simulation/bulc-mcp

Cursor / VS Code: same command; clients with a tool-count limit should set BULC_MCP_PROFILE=compact. From source: git clone, npm install (builds in prepare), then run node build/server.js.

Finding the app

No configuration is needed. When BULC (0.90+) opens its bridge it writes a discovery file BULC/bridge.json in the user's config folder (%APPDATA%\BULC\bridge.json on Windows); this server reads the address, port and token from it — also when the app runs on a port other than 8787. Files left behind by an app that has ended are ignored. Order: BULC_BRIDGE_URL → discovery file → BULC_BRIDGE_HOST/BULC_BRIDGE_PORT (default 127.0.0.1:8787). With BULC_BRIDGE_AUTH=sensitive|all in the app, the token from the discovery file is sent as Authorization: Bearer to that address only; BULC_BRIDGE_TOKEN covers set-ups without the file. All environment variables are listed in the Korean section above.

Tools, knowledge and prompts

  • Local tools: bulc_connection_status, bulc_knowledge_search, bulc_get_rules, bulc_plan_check, bulc_drawing_intake, bulc_check_deck, bulc_mesh_advisor, bulc_find_tools (all work without the app), bulc_call (compact profile), get_project_summary, run_simulation (guarded run for any app version).

  • App tools carry read-only / destructive / idempotent annotations, "Live app only" marks, side-effect notes and, by default, a short list of related rule ids — never pushing a description past 1,024 characters.

  • App pictures (capture_view) arrive as image content and structured results as structuredContent.

  • Resources: bulc://knowledge/{index, ontology, ontology.jsonld, rules, glossary, fds-6.10.1/keys}, playbooks, templates bulc://knowledge/rule/{id}, …/rules/{domain}, …/class/{name}, …/fds-6.10.1/namelist/{group}, bulc://tools/{name}, live bulc://project/summary and bulc://project/deck, and the synthetic bulc://examples/….

  • Prompts: bulc-start, drawing-to-fire-aset, evacuation-rset, hvac-smoke-control, sprinkler-design, marine-water-spray-iso, troubleshooting, review-fds-deck.

Example session (synthetic)

user: Build a fire model from D:\work\office-plan-synthetic.dxf — ground floor, 3 m storey, exit on the south side.
→ bulc_connection_status · project_info · bulc_drawing_intake {"path": "D:\\work\\office-plan-synthetic.dxf", "purpose": "fire"}
→ arch_analyze_drawing {"filePath": "D:\\work\\office-plan-synthetic.dxf"} → mm, 5 walls, 2 doors, 1 window + questions
assistant: confirms units, origin, which door is the final exit and the fire scenario (no fire until the user gives one — GEN-015)
→ arch_import_building {"candidateId": "…", "story": 1} (dry run) → user agrees → … "dryRun": false
→ bulc_plan_check {...} → set_mesh · set_all_boundaries_open · add_fire · output_add_tenability_slices · set_time
→ sim_preflight → summary → user confirms → project_save → sim_start {"confirm": true} → sim_status … → fire_compute_aset

More in examples/sessions.

Privacy and security

The server runs on your PC and talks only to the BULC app on 127.0.0.1; no telemetry. It reads only the files you point it to and the app's discovery file, and uploads nothing; the bridge token is sent only to that app. Tool results (including drawing summaries and screenshots) become part of your conversation with the AI provider you use — consider an MCP client with a local model for confidential drawings. See PRIVACY_POLICY.md and SECURITY.md.

Development

npm install
npm run check          # typecheck, build, tests, knowledge lint, public-content scan, licence check, package contents
npm run gen:examples   # regenerate the synthetic DXF examples
node scripts/import-snapshot.mjs <export.json> --app-version X.Y.Z   # refresh the bundled tool snapshot

License

The server code and the knowledge pack are MIT. The BULC desktop app and its solvers are commercial software under a separate licence and are not part of this repository. "BULC" is a trademark of Meteor Simulation; the MIT licence grants no trademark rights. Sources cited by the knowledge pack are listed in NOTICE.md.

Available Tools

249 tools
add_bndfAdd bndfA

Add an animated boundary quantity (&BNDF) such as WALL TEMPERATURE or ADIABATIC SURFACE TEMPERATURE. Use spec_id for species quantities (MASS FLUX, SURFACE DEPOSITION, MPUA_Z, CPUA_Z, AMPUA_Z) and part_id for particle quantities (MPUA, CPUA, AMPUA). The GPU engine records these 7 quantities: WALL TEMPERATURE, WALL HEAT FLUX, NET HEAT FLUX, RADIATIVE HEAT FLUX, CONVECTIVE HEAT FLUX, INCIDENT HEAT FLUX, BACK WALL TEMPERATURE. Any other quantity needs CPU FDS (the GPU engine warns and falls back to WALL HEAT FLUX). WALL HEAT FLUX is a GPU-engine-only name — use NET HEAT FLUX when the deck must also run on CPU FDS. [bulc-mcp rules] OUT-005 — bulc_knowledge_search ""

Inputs: quantity (required), part_id, spec_id.

add_controlAdd controlA

Add a CTRL control logic element. FUNCTION_TYPE: logic ANY/ALL/NOT/XOR/X_OF_N(N), TIME_DELAY(delay), KILL/RESTART, DEADBAND(setpoint+setpoint2+on_bound), CUSTOM(ramp_id), PID(target_value+gains), math ABS/EXP/LOG/SIN/COS/ASIN/ACOS/ATAN/SUM/SUBTRACT/MULTIPLY/DIVIDE/POWER/MIN/MAX (with setpoint+trip_direction they act as boolean gates). INPUT_ID accepts device IDs, other CTRL IDs, or CONSTANT. [bulc-mcp rules] DEVC-004, DEVC-006 — bulc_knowledge_search ""

Inputs: id (required), input_id (required), function_type (required), n, +13 more.

add_deviceAdd deviceA

Add a measurement device (&DEVC) with full parameter support: point (xyz) or region (xb) quantities, species, statistics, trip options (setpoint/latch/initial_state/trip_direction), post-processing, aspiration, HVAC and particle quantities. Provide xyz for point quantities or xb for flow/HRR/layer/beam/statistics. [bulc-mcp rules] DEVC-001, DEVC-003, DEVC-004 — bulc_knowledge_search ""

Inputs: id (required), quantity (required), xb, ior, +33 more.

add_doorAdd doorA

Convenience tool: add a door opening in a wall. Specify the wall obstacle ID and door position/size. Creates a HOLE that cuts through the wall. [bulc-mcp rules] EVAC-002, GEO-004 — bulc_knowledge_search ""

Inputs: id (required), wall_id (required), width, height, +1 more.

add_fireAdd fireA

Add a fire source. HRRPUA = Heat Release Rate Per Unit Area (kW/m²). XB defines location. For a time-varying fire, pass ramp_points (an explicit HRR fraction curve) OR growth (an NFPA t-squared growth curve) — both auto-create a RAMP and link it. [bulc-mcp rules] FIRE-001, FIRE-002, FIRE-003 — bulc_knowledge_search ""

Inputs: xb (required), hrrpua (required), growth, ramp_id, +3 more.

add_floorAdd floorC

Convenience tool: add a floor slab. Specify x/y range and optional thickness. [bulc-mcp rules] GEN-003, GEO-007 — bulc_knowledge_search ""

Inputs: id (required), x_max (required), x_min (required), y_max (required), +4 more.

add_heat_detectorAdd heat detectorA

Convenience: add a heat detector as a small obstacle with FDS override. Generates DEVC+PROP in FDS output. [bulc-mcp rules] DEVC-001, DEVC-009 — bulc_knowledge_search ""

Inputs: x (required), y (required), id (required), z, +2 more.

add_holeAdd holeB

Add a hole (opening in an obstacle) to the FDS model. XB defines the hole volume. [bulc-mcp rules] GEO-004, GEO-008 — bulc_knowledge_search ""

Inputs: id (required), xb (required).

add_materialAdd materialC

Add a material definition (MATL). [bulc-mcp rules] SURF-001 — bulc_knowledge_search ""

Inputs: id (required), density (required), conductivity (required), specific_heat (required), +1 more.

add_material_from_libraryAdd material from libraryB

Copy a material preset from the built-in library into the model as a &MATL. [bulc-mcp rules] SURF-001 — bulc_knowledge_search ""

Inputs: library_id (required), id.

add_nozzleAdd nozzleA

Convenience: add a Lagrangian-particle virtual fuel nozzle (e.g. hydrogen TPRD jet release). Automatically creates DEVC (QUANTITY=TIME, SETPOINT=0, ORIENTATION), PROP (MASS_FLOW_RATE / FLOW_RAMP / PARTICLE_VELOCITY / SPRAY_ANGLE / PARTICLES_PER_SECOND), PART (SPEC_ID / DIAMETER / MONODISPERSE / INITIAL_TEMPERATURE), the fuel SPEC (FORMULA + liquid-droplet properties taken from the built-in fuel database) and aligns REAC (FUEL / RADIATIVE_FRACTION / SOOT_YIELD / CO_YIELD) when no reaction is set yet.

Inputs: id (required), xyz (required), spec_id, diameter_um, +7 more.

add_obstacleAdd obstacleB

Add an obstacle (solid block) to the FDS model. XB=[x1,x2,y1,y2,z1,z2] in metres. [bulc-mcp rules] GEN-003 — bulc_knowledge_search ""

Inputs: id (required), xb (required), surf_ids.

add_propAdd propA

Add a &PROP device model. quantity presets seed standard defaults: 'LINK TEMPERATURE' (heat detector link), 'SPRINKLER LINK TEMPERATURE', 'CHAMBER OBSCURATION' (smoke detector), 'THERMOCOUPLE' (bead). Override any field. Reference from devices via prop_id. Every other FDS 6.10.1 spray key (mass flow, pressure/flow ramp, particle velocity, orifice, parcels, spray pattern shape/table, smokeview id …) goes in spray with the spr_upsert_spray_profile.prop key names. [bulc-mcp rules] DEVC-009 — bulc_knowledge_search ""

Inputs: id (required), quantity (required), rti, spray, +19 more.

add_rampAdd rampB

Add a time ramp (RAMP) for time-dependent parameters. Points are [time, value] pairs. [bulc-mcp rules] FIRE-008 — bulc_knowledge_search ""

Inputs: id (required), points (required).

add_raw_namelistAdd raw namelistA

Add a raw namelist line emitted verbatim just before &TAIL — for settings with no GUI dialog (e.g. "&RADI RADIATIVE_FRACTION=0.35 /", "&PRES VELOCITY_TOLERANCE=1.E-4 /"). Must start with & and end with /. Use the dedicated tools for anything the GUI does model (&MESH/&OBST/&VENT/&SURF/&REAC/&DEVC/&CTRL/&SLCF/&BNDF/&DUMP/&TIME/&MISC) — a duplicate namelist is an FDS error. [bulc-mcp rules] GEN-016, SIM-002, GEN-017 — bulc_knowledge_search ""

Inputs: line (required).

add_slcfAdd slcfC

Add a slice file output (SLCF). Specify quantity and plane position. [bulc-mcp rules] ASET-001, ASET-004, OUT-002 — bulc_knowledge_search ""

Inputs: id (required), quantity (required), pbx, pby, +4 more.

add_smoke_detectorAdd smoke detectorA

Convenience: add a smoke detector as a small obstacle with FDS override. Generates DEVC+PROP in FDS output. [bulc-mcp rules] DEVC-001, DEVC-009 — bulc_knowledge_search ""

Inputs: x (required), y (required), id (required), z, +4 more.

add_speciesAdd speciesC

Add a tracked species.

Inputs: id (required), formula (required).

add_sprinklerAdd sprinklerA

Convenience: add a complete sprinkler head (FDS 6.10.1). Creates DEVC + PROP (QUANTITY=SPRINKLER LINK TEMPERATURE) + water-droplet PART (SPEC_ID=WATER VAPOR) from the project default spray profile (standard pendant K80: K 80 L/(min·bar^½), 1.0 bar, 68 °C, RTI 100, SPRAY_ANGLE 30/80, 10 m/s, 1000 µm, 5000 particles/s). Flow: give k_factor+operating_pressure (FDS derives Q=K√p), or flow_rate (optionally with pressure/K). K alone or pressure alone is rejected by FDS (ERROR 238). Upright heads also spray downward (only SMOKEVIEW_ID differs). profile_id picks another shared spray profile (e.g. ESFR or water mist from spr_upsert_spray_profile); spray / particle override any other &PROP / &PART key for this head (same keys as spr_upsert_spray_profile prop / part); activation opens it by time / CTRL / at t=0. [bulc-mcp rules] DEVC-001, DEVC-009, SPR-010 — bulc_knowledge_search ""

Inputs: id (required), xyz (required), rti, spray, +13 more.

add_surfaceAdd surfaceA

Add a general surface (&SURF) with material layers, burning behaviour, thermal boundary conditions and injection. This is what gives walls/objects real heat transfer and lets them burn away. [bulc-mcp rules] SURF-001, VENT-005 — bulc_knowledge_search ""

Inputs: id (required), color, tau_q, hrrpua, +27 more.

add_surface_from_libraryAdd surface from libraryB

Copy a surface preset from the built-in library into the model as a &SURF, pulling in any materials it needs. [bulc-mcp rules] SURF-001 — bulc_knowledge_search ""

Inputs: library_id (required), id.

add_thermocoupleAdd thermocoupleB

Convenience: add a thermocouple as a small obstacle with FDS override. Generates DEVC in FDS output. [bulc-mcp rules] DEVC-001 — bulc_knowledge_search ""

Inputs: x (required), y (required), z (required), id (required), +2 more.

add_ventAdd ventB

Add a vent (boundary patch). XB defines the vent surface. [bulc-mcp rules] EVAC-002, VENT-002, VENT-004 — bulc_knowledge_search ""

Inputs: id (required), xb (required), surf_id (required), mass_flux, +1 more.

add_wallAdd wallB

Convenience tool: add a wall by specifying start point, end point, height, and thickness. Automatically calculates the OBST bounding box. Points are [x,y] on the floor plane. [bulc-mcp rules] GEN-003, GEO-002, DRW-004 — bulc_knowledge_search ""

Inputs: id (required), end (required), start (required), height, +3 more.

add_windowAdd windowB

Convenience tool: add a window opening in a wall. Similar to add_door but with sill height. [bulc-mcp rules] GEO-004 — bulc_knowledge_search ""

Inputs: id (required), wall_id (required), width, height, +2 more.

arch_analyze_drawingArch analyze drawingA
Read-onlyIdempotent

Read an architectural floor plan (.dxf, .dwg via the bundled converter, vector .pdf, or an image) and recognise the building: units and scale (DXF $INSUNITS, dimension values, PDF scale text), layer roles, wall centrelines with thickness (double-line or single-line walls), doors (swing arcs / door blocks), windows (window layers / blocks), columns, stair areas, room names and story labels. Returns candidateId, a summary and questions to confirm with the user (DRW-001…003). Images and outlined PDFs return needsVision — then read the picture yourself and call arch_import_floorplan_report. show = walls | openings | columns | rooms | levels | layers lists details (offset, limit, ids). Read-only; the file is read on this PC only. [bulc-mcp rules] DRW-004 — bulc_knowledge_search ""

Inputs: ids, show, limit, offset, +3 more.

arch_import_buildingArch import buildingA
Destructive

Create the building on one story in ONE undo step: walls as obstacles (axis-aligned box per wall, diagonal walls stair-stepped like the 2D editor), doors as holes 'Door_n' (also evacuation exits) and windows as holes 'Win_n' at sill height (not exits), optional columns and slabs. Source: candidateId from arch_analyze_drawing (exclude walls / openings by id) or building = {walls:[{start:[x,y],end:[x,y],thickness?,height?}], doors:[{at:[x,y]|wall:n,position:0..1,width?,height?}], windows:[{at|wall,position,width?,sill?,height?}], columns:[{xb:[x1,x2,y1,y2]}|{center,size}]} in metres; wall:n counts from 1 in the order of building.walls (openings that cannot be placed are listed in warnings). story = story id (default current story; z = its zMin, wall height = its height). dryRun defaults to TRUE — report first, confirm with the user, then call again with dryRun:false. mode append (default) | replace (removes what an earlier import with the same idPrefix created).

Inputs: mode, story, zBase, dryRun, +9 more.

arch_import_floorplan_reportArch import floorplan reportA
Destructive

Build walls / doors / windows from YOUR reading of a floor-plan picture (image or outlined PDF page — use when arch_analyze_drawing says needsVision). report = {building_width_m (real width of the outer walls), wall_height_m?, wall_thickness_m?, walls:[{x1,y1,x2,y2}] wall CENTRELINES in normalised image coordinates 0..1 (origin top-left, y down; split at corners, skip dimension lines, text, furniture, hatching), doors:[{x,y,width_m?}], windows:[{x,y,width_m?,sill_m?,height_m?}]}. image = {width,height} pixels (or imagePath) for the aspect ratio. The app converts the report with fixed rules (snap to horizontal/vertical, y flipped, origin at the lower-left wall corner) and creates the same objects as arch_import_building. Needs no AI key in the app. dryRun defaults to TRUE. [bulc-mcp rules] DRW-008, DRW-004 — bulc_knowledge_search ""

Inputs: report (required), mode, image, story, +7 more.

assign_surfaceAssign surfaceA

Assign a surface (SURF_ID) to an obstacle, vent or geometry. Without 'faces' the whole object uses it; with 'faces' only those faces do (SURF_ID6 order -X,+X,-Y,+Y,-Z,+Z). [bulc-mcp rules] GEN-003, SURF-001 — bulc_knowledge_search ""

Inputs: surf_id (required), target_id (required), target_type (required), faces.

auto_cutcell_meshAuto cutcell meshA

Build a cut-cell multi-mesh deck from &GEOM triangulated shapes (plus OBSTs). Cells shrink where the fluid gap is narrow (gap / gap_cells), the GEOM surface band always gets the finest cell so the engine keeps its cut-cell wall physics there, sharp curvature gets one level finer, and levels change at most 2:1 between neighbouring blocks. Cell sizes are min_cell x 2^k. If the deck has no GEOM this is identical to auto_multimesh. Over budget it relaxes curvature, buffer, gap_cells, then raises min_cell and reports what it changed; a gapped, overlapping or misaligned deck is refused. Engine constraints (engine multimesh ratio_union_grid): (1) every mesh must use CUBIC cells whose size is the finest cell x 2^k (k in 1,2,4,8,16); (2) every mesh boundary and the union extent must land on a fine-grid index that is a multiple of the LARGEST ratio actually used; (3) meshes must tile the domain with no overlap and no gap; (4) a 1:4 or larger ratio makes the engine print an experimental-feature warning and switches it to per-mesh storage (MM2) plus the composite block-CG v2 pressure solve, both automatically. Verify with list_meshes.

Inputs: max_cell (required), min_cell (required), gap_cells.

auto_fit_meshAuto fit meshA

Auto-fit the mesh domain to the bounding box of all obstacles plus margin; recomputes NI/NJ/NK to keep the current cell size. ⚠ Resets any multi-mesh deck to a single mesh. Use set_meshes / auto_multimesh to keep or build a multi-mesh deck. [bulc-mcp] Resets a multi-mesh deck to a single mesh (MESH-004). [bulc-mcp rules] MESH-001, MESH-005, GEO-006 — bulc_knowledge_search ""

Inputs: margin_z, margin_xy.

auto_multimeshAuto multimeshA
Destructive

Build a multi-mesh deck from the OBSTRUCTION geometry. It measures the fluid gap everywhere (obstacles minus HOLEs, so doorways stay open), gives narrow places 3+ cells across and open places the default wide cell, then merges equal-size regions into boxes cut on obstacle faces so walls stay on mesh boundaries. Wall slabs up to 2 cells thick are absorbed into a neighbour. Cell sizes are quantised to min_cell x 2^k; an overlapping, gapped or misaligned deck is refused, not committed. The domain may grow to a multiple of the coarsest cell; OPEN vents follow. Engine constraints (engine multimesh ratio_union_grid): (1) every mesh must use CUBIC cells whose size is the finest cell x 2^k (k in 1,2,4,8,16); (2) every mesh boundary and the union extent must land on a fine-grid index that is a multiple of the LARGEST ratio actually used; (3) meshes must tile the domain with no overlap and no gap; (4) a 1:4 or larger ratio makes the engine print an experimental-feature warning and switches it to per-mesh storage (MM2) plus the composite block-CG v2 pressure solve, both automatically. Verify the result with list_meshes.

Inputs: max_cell (required), min_cell (required).

bulc_check_deckCheck an FDS deckA
Read-onlyIdempotent

Deterministic FDS 6.10.1 deck check with rule ids: mesh XB/IJK, cell aspect ratio, 2·3·5 cell counts, multi-mesh overlaps and cell ratios, objects and devices outside the meshes, VENT planes, undefined SURF/MATL/PROP/PART/RAMP/CTRL references, HRRPUA without &REAC, total HRR and D*/dx, dump intervals ≥ T_END, missing OPEN boundary or SLCF, detector/sprinkler PROP data, spray flow keys, CHID. Give deck_text, a local .fds path, or from_app=true for the deck of the project open in BULC. Complements validate_project (which also checks app-side state). FDS 덱을 규칙 id 와 함께 결정적으로 점검합니다.

Inputs: path, from_app, deck_text, min_severity.

bulc_connection_statusBULC connection statusA
Read-onlyIdempotent

Check whether the BULC desktop app is running and reachable through its local bridge, whether the program answering is really BULC, how many tools it exposes, whether its tool set matches the bundled snapshot, and whether this server is showing the live tool list or the bundled snapshot. Call this first, and again whenever an app tool fails. BULC 앱 연결 상태를 확인합니다.

Inputs: no named parameters.

bulc_drawing_intakeDrawing intakeA
Read-onlyIdempotent

First step for any drawing the user gives (DWG, DXF, PDF, image, ZIP bundle, IFC, or an .fds deck). Pass the ABSOLUTE local path. Reads the file on this PC only — it never uploads anything — and classifies it (architectural plan, sprinkler plan, piping isometric, HVAC plan, FDS deck) from the extension, file name, DXF units/layers/blocks/line angles, PDF pages and fonts, ZIP contents or IFC entities. Returns the playbook to follow, the questions to ask the user (units, scale, origin, layers …) and the tool sequence (architectural plans → arch_analyze_drawing / arch_import_building, piping → spr_analyze_drawing / spr_import_network). For DXF plans, extract_geometry=true also returns wall centre-line candidates in metres (fallback for older apps). Text inside the drawing (title blocks, notes) is never returned. 도면 파일을 로컬에서 분류하고 플레이북·질문·도구 순서를 돌려줍니다(업로드 없음).

Inputs: path (required), units, purpose, max_walls, +2 more.

bulc_find_toolsFind BULC app toolsA
Read-onlyIdempotent

Find BULC app tools by keyword (Korean or English) or category and return their names, descriptions and full input schemas. Categories: project (open/save/run/results/ASET/screenshots), arch (floor-plan drawings), geometry, fire, ventilation, device, mesh, material, surface, output, query, evac, spr, hvac, draw, furniture, result, shape. In the compact profile, call the tool you found with bulc_call. 키워드로 앱 도구를 찾습니다.

Inputs: limit, names, query, category.

bulc_get_rulesGet BULC rulesA
Read-onlyIdempotent

List modelling rules filtered by domain, severity, class (applies_to), confidence, or the tool they mention. Use before a phase of work (e.g. domain=sprinkler, min_severity=warning) and quote rule ids when explaining. Works without the app. 규칙을 영역·심각도·도구별로 가져옵니다.

Inputs: ids, tool, limit, domain, +5 more.

bulc_mesh_advisorMesh advisorA
Read-onlyIdempotent

Cell-size advice from the fire size: characteristic fire diameter D* = (Q / (ρ∞ cp T∞ √g))^(2/5) and the cell sizes for D*/dx = 4 (coarse), 10 (moderate) and 16 (fine). With domain_xb it proposes IJK per axis rounded to counts made of 2, 3 and 5 (friendly to the FFT pressure solver), the resulting cells and the total cell count. Works without the app. 화원 크기로 셀 크기와 IJK 를 제안합니다(MESH-002, MESH-003, MESH-010).

Inputs: hrr_kw (required), quality, ambient_c, cell_size, +1 more.

bulc_plan_checkCheck a plan before actingA
Read-onlyIdempotent

Review the sequence of tool calls you intend to make BEFORE calling them. Checks tool names and argument names against the live app (or the bundled snapshot), and the plan against the BULC rules: units and XB order, total HRR from HRRPUA × area, fires the user did not ask for, opening the floor boundary, single-mesh tools after multi-mesh, dump intervals ≥ T_END, re-running hydraulic/HVAC calculations before applying them to FDS, unique labels for sprinkler heads and HVAC terminals, dry runs before drawing imports, validate_project / sim_preflight before sim_start, user confirmation, evacuation run order, file tools of other servers, and more. Returns findings with rule ids and the playbook to follow. Works without the app. Steps are objects {tool, args} or strings like 'add_fire {"hrrpua": 500, "xb": [..]}'. 실행 전에 계획을 규칙으로 점검합니다.

Inputs: steps (required), goal, run_confirmed_by_user, fire_requested_by_user.

capture_viewCapture viewA
Read-onlyIdempotent

Screenshot of the running app for visual checking: view = current (default) | 2d (plan of a story) | 3d | result (result viewer) | shape (Shape Studio). story = story id to show in 2D. region = viewport (default, only the drawing area) | window. Returns the PNG as an image (and its path); savePath (absolute .png) also keeps a copy. Live app only. [bulc-mcp] Returns the picture as an image; savePath also writes a PNG on this PC. [bulc-mcp rules] GEN-006, GEN-010, GEN-016 — bulc_knowledge_search ""

Inputs: view, story, region, maxWidth, +1 more.

draw_add_storyDraw add storyB

Add a new building story (floor level) [bulc-mcp rules] EVAC-001, GEO-002 — bulc_knowledge_search ""

Inputs: no named parameters.

draw_list_storiesDraw list storiesB
Read-onlyIdempotent

Get current building stories list (read-only) [bulc-mcp rules] EVAC-001, GEO-002 — bulc_knowledge_search ""

Inputs: no named parameters.

draw_remove_storyDraw remove storyC
Destructive

Remove a building story by ID [bulc-mcp rules] EVAC-001, GEO-002 — bulc_knowledge_search ""

Inputs: id (required).

draw_set_door_paramsDraw set door paramsB
Idempotent

Set default door dimensions [bulc-mcp rules] EVAC-001, GEO-002 — bulc_knowledge_search ""

Inputs: doorWidth, doorHeight.

draw_set_wall_paramsDraw set wall paramsB
Idempotent

Set default wall height and thickness for 2D drawing [bulc-mcp rules] EVAC-001, GEO-002 — bulc_knowledge_search ""

Inputs: wallHeight, wallThickness.

draw_set_window_paramsDraw set window paramsB
Idempotent

Set default window dimensions [bulc-mcp rules] EVAC-001, GEO-002 — bulc_knowledge_search ""

Inputs: windowWidth, windowHeight, windowSillHeight.

draw_update_storyDraw update storyB
Idempotent

Update a story name or height [bulc-mcp rules] EVAC-001, GEO-002 — bulc_knowledge_search ""

Inputs: id (required), name, height.

evac_add_agentEvac add agentB

Add an evacuation agent at a specific position [bulc-mcp rules] EVAC-001 — bulc_knowledge_search ""

Inputs: x (required), y (required), maxSpeed, floorIndex, +1 more.

evac_add_agents_batchEvac add agents batchC

Add multiple evacuation agents distributed in a rectangular area [bulc-mcp rules] EVAC-001, EVAC-005 — bulc_knowledge_search ""

Inputs: xMax (required), xMin (required), yMax (required), yMin (required), +3 more.

evac_add_journeyEvac add journeyA

Create an evacuation journey (route) with ordered stages. Waypoint ids come from evac_list_summary. End the route with an EXIT stage (it goes to the nearest exit automatically). Floors are joined by stairs automatically — stairs are not journey stages. [bulc-mcp rules] EVAC-006, EVAC-007 — bulc_knowledge_search ""

Inputs: name (required), stages.

evac_add_stairEvac add stairB

Add a staircase connecting two floors [bulc-mcp rules] EVAC-001, EVAC-006 — bulc_knowledge_search ""

Inputs: x1 (required), x2 (required), y1 (required), y2 (required), +4 more.

evac_add_waypointEvac add waypointC

Add a navigation waypoint for evacuation routing

Inputs: x (required), y (required), radius, floorIndex.

evac_clear_agentsEvac clear agentsB
Destructive

Remove all evacuation agents [bulc-mcp rules] EVAC-001 — bulc_knowledge_search ""

Inputs: no named parameters.

evac_get_resultsEvac get resultsA
Read-onlyIdempotent

Summary of the last evacuation result in the project (never the raw trajectories): agents, evacuated / remaining, last exit time (the RSET shown in the app), mean and p50/p90/p95 exit times, evacuation start delay from the alarm chain, FED casualties and their causes, and per-exit counts, first/last times and flow (persons/s/m; each agent is assigned to the exit nearest to its last position). detail = summary (default) | exits | agents (agents lists exit times, limit ≤ 500). Read-only. [bulc-mcp rules] GEN-010, ASET-005, EVAC-004 — bulc_knowledge_search ""

Inputs: limit, detail.

evac_list_summaryEvac list summaryB
Read-onlyIdempotent

Get current evacuation module status summary (read-only) [bulc-mcp rules] EVAC-001, EVAC-002, EVAC-007 — bulc_knowledge_search ""

Inputs: no named parameters.

evac_remove_agentEvac remove agentC
Destructive

Remove an evacuation agent by ID [bulc-mcp rules] EVAC-001, EVAC-005 — bulc_knowledge_search ""

Inputs: id (required).

evac_remove_journeyEvac remove journeyC
Destructive

Remove an evacuation journey by ID

Inputs: id (required).

evac_remove_stairEvac remove stairB
Destructive

Remove a staircase by ID [bulc-mcp rules] EVAC-001 — bulc_knowledge_search ""

Inputs: id (required).

evac_remove_waypointEvac remove waypointC
Destructive

Remove a waypoint by ID

Inputs: id (required).

evac_runEvac runA

Run the evacuation simulation in the running app after the user agreed (confirm=true): builds the same engine input as the EVAC run dialog (agents, exits = OPEN vents / door items / Door_·Window_ holes, walls, stairs → multi-level mode, waypoints, journeys, FED and alarm settings) and starts the engine in the background. Refuses with no agents, and with no user-defined exits unless allowNoExits=true (the engine would then use temporary exits at the domain edges). Poll evac_status, then read evac_get_results. Live app only. [bulc-mcp] Starts the evacuation engine after the user agreed; outputFolder also writes the result there (EVAC-004). [bulc-mcp rules] EVAC-004 — bulc_knowledge_search ""

Inputs: confirm (required), allowNoExits, outputFolder.

evac_statusEvac statusB
Read-onlyIdempotent

Status of the current / last evacuation run of this app session: running or finished, percent, last engine message, error, result summary. Read-only. [bulc-mcp rules] EVAC-004 — bulc_knowledge_search ""

Inputs: no named parameters.

evac_stopEvac stopA
Destructive

Stop the running evacuation simulation (confirm=true). No result is kept. Live app only.

Inputs: confirm (required).

evac_update_agentEvac update agentC
Idempotent

Update properties of an existing evacuation agent [bulc-mcp rules] EVAC-001 — bulc_knowledge_search ""

Inputs: id (required), x, y, mass, +3 more.

evac_update_journeyEvac update journeyB
Idempotent

Update an existing evacuation journey

Inputs: id (required), name, stages.

evac_update_setupEvac update setupB
Idempotent

Update evacuation simulation settings (model, time, timestep)

Inputs: model, timeStep, simulationTime.

evac_update_stairEvac update stairC
Idempotent

Update properties of an existing staircase [bulc-mcp rules] EVAC-001 — bulc_knowledge_search ""

Inputs: id (required), x1, x2, y1, +4 more.

evac_update_waypointEvac update waypointC
Idempotent

Update properties of an existing waypoint

Inputs: id (required), x, y, radius, +2 more.

fds_apply_textFds apply textA
Destructive

Apply an edited FDS deck to the project: send the complete .fds text (start from preview_fds, edit, send back). The deck is parsed and compared section by section with the current model; only changed sections (meshes, obstacles, vents, devices, controls, dump …) are applied, untouched sections keep their app metadata (changed sections are replaced by the parsed values). dryRun (default true) only reports the changed sections. sections limits which top-level sections may change. Nothing changes on a parse error. [bulc-mcp rules] GEN-006, GEN-010, GEN-016 — bulc_knowledge_search ""

Inputs: fdsText (required), dryRun, sections.

fire_compute_asetFire compute asetA
Read-onlyIdempotent

Available safe egress time (ASET) at breathing height: for each point (default: every user exit — OPEN vents, door items, Door_/Window_ holes) the time series at floor + samplingHeight (default 1.8 m) is read from horizontal slices (preferred) or Plot3D and compared with the criteria (default temperature 60 °C, visibility 5 m, CO 1,400 ppm, O2 15 %, CO2 5 %; same as the app ASET report). Returns ASET per point, the governing criterion, a lower bound when no criterion is exceeded, and which quantities are missing (then add output_add_tenability_slices and re-run). points[].floorZ = floor elevation of that point (or story = story id). Read-only. [bulc-mcp rules] GEN-010, ASET-001, ASET-004 — bulc_knowledge_search ""

Inputs: points, source, fdsPath, criteria.

fire_results_summaryFire results summaryA
Read-onlyIdempotent

Summarise a finished (or running) fire simulation from its result files: peak HRR and time, total heat released (MJ), radiative fraction, last simulated time vs T_END, every device column (max, time of max, final, unit), first time each device with a setpoint reached it, sprinkler / detector activation times from the engine log of this session, and the available output files. Read-only. [bulc-mcp rules] FIRE-001, GEN-010, ASET-005 — bulc_knowledge_search ""

Inputs: fdsPath, maxDevices.

fire_timeseriesFire timeseriesA
Read-onlyIdempotent

Time series from the result CSV files: file = hrr (HRR, Q_RADI, MLR …) | devc (device ids) | ctrl. columns = column names (default the first 6). t0 / t1 limit the time window; maxPoints ≤ 500 (default 300 — longer series are reduced by time-averaging). Read-only. [bulc-mcp rules] FIRE-001, GEN-010 — bulc_knowledge_search ""

Inputs: file (required), t0, t1, columns, +2 more.

get_config_summaryGet config summaryB
Read-onlyIdempotent

Get a summary of the current FDS configuration: domain size, cell count, number of objects, etc. [bulc-mcp rules] GEN-006, GEN-010, GEN-016 — bulc_knowledge_search ""

Inputs: no named parameters.

get_conventionsGet conventionsA
Read-onlyIdempotent

Units, coordinate axes, story / floorIndex numbering, id rules and file conventions used by the BULC tools (they differ between modules — read this before building a model from a drawing). topic = units | coordinates | floors | ids | files | aset | all (default all). Read-only. [bulc-mcp rules] GEN-006, GEN-010, GEN-016 — bulc_knowledge_search ""

Inputs: topic.

get_furniture_infoGet furniture infoA
Read-onlyIdempotent

Get detailed information about a specific furniture item (dimensions, fire data, fuel)

Inputs: furniture_id (required).

get_numericsGet numericsB
Read-onlyIdempotent

Read the current numerical stability settings (time step, CFL/VN limits, flux limiter). [bulc-mcp rules] GEN-016, SIM-002 — bulc_knowledge_search ""

Inputs: no named parameters.

get_object_propertiesGet object propertiesB
Read-onlyIdempotent

Get one obstacle's full properties as JSON, including ALL Runtime FDS Properties (fds_override: fire HRRPUA/ramp, detector activation_temp/RTI, sprinkler k_factor/flow, HVAC airflow, fuel/REAC yields, etc.). [bulc-mcp rules] GEN-001, GEN-003, GEO-011 — bulc_knowledge_search ""

Inputs: id (required).

get_project_summaryProject summaryA
Read-onlyIdempotent

Short summary of the project currently open in the BULC app: CHID, title, end time, mesh, and object counts (obstacles, fire sources, vents, devices, evacuation agents, sprinkler heads, HVAC terminals). Needs the app. On BULC 0.90+ project_info gives more (file path, unsaved changes, stories, deck path). 현재 앱 프로젝트 요약입니다.

Inputs: no named parameters.

get_simulation_metricsGet simulation metricsA
Read-onlyIdempotent

Get LIVE simulation runtime metrics if a simulation is running: HRR(qdot, kW), Tmax(K), max velocities(umax/wmax), pmax, dt/cfl, step/time, nan count, ms/step, particles, GPU VRAM. Only meaningful in live mode with a running simulation. [bulc-mcp rules] GEN-010, GEN-016, SIM-002 — bulc_knowledge_search ""

Inputs: no named parameters.

get_simulation_settingsGet simulation settingsA
Read-onlyIdempotent

Read every simulation setting in one call: time (T_BEGIN/T_END), SIMULATION_MODE, turbulence model, numerics (DT/CFL/VN/flux limiter), ambient &MISC values, output dump intervals and Plot3D quantities, and the mesh deck size. Use it before changing settings so you know what is already explicit. [bulc-mcp rules] GEN-006, GEN-010, GEN-016 — bulc_knowledge_search ""

Inputs: no named parameters.

hvac_add_air_handlerHvac add air handlerA

Add an air handler unit (AHU) to an existing fan node

Inputs: nodeId (required), fanType, maxAirflowCFM, staticPressurePa.

hvac_add_ductHvac add ductC

Connect two HVAC nodes with a duct

Inputs: endNodeId (required), startNodeId (required), width, height, +3 more.

hvac_add_exhaust_grilleHvac add exhaust grilleB

Add an exhaust grille to an existing exhaust node [bulc-mcp rules] HVAC-001 — bulc_knowledge_search ""

Inputs: nodeId (required), airflowCFM, grilleType.

hvac_add_nodeHvac add nodeA

Add an HVAC node (junction, supply_diffuser, exhaust_grille, or fan) [bulc-mcp] Give heads / terminals a unique label (H1, H2 …, EX1 …): it becomes the FDS id after *_apply_to_fds (GEN-021). [bulc-mcp rules] EVAC-001, GEN-021 — bulc_knowledge_search ""

Inputs: x (required), y (required), type (required), z, +2 more.

hvac_add_supply_diffuserHvac add supply diffuserB

Add a supply diffuser to an existing supply node [bulc-mcp rules] HVAC-001 — bulc_knowledge_search ""

Inputs: nodeId (required), airflowCFM, supplyTempC, diffuserType.

hvac_apply_to_fdsHvac apply to fdsA

Apply the HVAC duct network to the FDS model: every supply_diffuser / exhaust_grille node becomes a small HVAC obstacle whose bottom face blows (SUPPLY) or sucks (EXHAUST) the terminal airflow. Uses the flow from hvac_run_calc when available, otherwise the design CFM of the diffuser/grille. Re-running replaces the previous ones. [bulc-mcp rules] HVAC-001, GEN-021, HVAC-003 — bulc_knowledge_search ""

Inputs: no named parameters.

hvac_get_resultsHvac get resultsA
Read-onlyIdempotent

Get HVAC airflow calculation results (run hvac_run_calc first): total supply/exhaust flow, duct velocity / terminal flow ranges. [bulc-mcp rules] HVAC-001 — bulc_knowledge_search ""

Inputs: no named parameters.

hvac_list_summaryHvac list summaryA
Read-onlyIdempotent

Get current HVAC network status summary (read-only) [bulc-mcp rules] HVAC-001, GEN-008, GEN-021 — bulc_knowledge_search ""

Inputs: no named parameters.

hvac_remove_air_handlerHvac remove air handlerC
Destructive

Remove an air handler unit by ID

Inputs: id (required).

hvac_remove_ductHvac remove ductC
Destructive

Remove a duct connection by ID

Inputs: id (required).

hvac_remove_exhaust_grilleHvac remove exhaust grilleC
Destructive

Remove an exhaust grille by ID [bulc-mcp rules] HVAC-001 — bulc_knowledge_search ""

Inputs: id (required).

hvac_remove_nodeHvac remove nodeB
Destructive

Remove an HVAC node (also removes connected ducts and equipment) [bulc-mcp rules] EVAC-001 — bulc_knowledge_search ""

Inputs: id (required).

hvac_remove_supply_diffuserHvac remove supply diffuserB
Destructive

Remove a supply diffuser by ID [bulc-mcp rules] HVAC-001 — bulc_knowledge_search ""

Inputs: id (required).

hvac_run_calcHvac run calcA

Run HVAC airflow calculation on the current duct network [bulc-mcp rules] HVAC-001, HVAC-003 — bulc_knowledge_search ""

Inputs: no named parameters.

hvac_set_defaultsHvac set defaultsB
Idempotent

Set default duct shape, diameter, and material for new ducts [bulc-mcp rules] HVAC-001 — bulc_knowledge_search ""

Inputs: width, height, diameter, material, +2 more.

hvac_update_air_handlerHvac update air handlerC
Idempotent

Update properties of an existing air handler unit

Inputs: id (required), fanType, maxAirflowCFM, staticPressurePa.

hvac_update_ductHvac update ductB
Idempotent

Update properties of an existing duct

Inputs: id (required), width, height, diameter, +2 more.

hvac_update_exhaust_grilleHvac update exhaust grilleA
Idempotent

Update properties of an existing exhaust grille [bulc-mcp rules] HVAC-001, HVAC-003 — bulc_knowledge_search ""

Inputs: id (required), airflowCFM, grilleType.

hvac_update_nodeHvac update nodeB
Idempotent

Update properties of an existing HVAC node [bulc-mcp rules] EVAC-001, GEN-021, HVAC-002 — bulc_knowledge_search ""

Inputs: id (required), x, y, z, +2 more.

hvac_update_supply_diffuserHvac update supply diffuserB
Idempotent

Update properties of an existing supply diffuser [bulc-mcp rules] HVAC-001, HVAC-003 — bulc_knowledge_search ""

Inputs: id (required), airflowCFM, supplyTempC, diffuserType.

list_bndfList bndfB
Read-onlyIdempotent

List the animated boundary (BNDF) quantities written for solid surfaces.

Inputs: no named parameters.

list_devicesList devicesA
Read-onlyIdempotent

List all measurement devices with their ID, quantity, and position — both &DEVC devices and detector objects (heat/smoke detectors, thermocouples, sprinkler and nozzle objects), which are written to the deck as DEVC+PROP. [bulc-mcp rules] DEVC-001, DEVC-003, DEVC-004 — bulc_knowledge_search ""

Inputs: no named parameters.

list_furniture_catalogList furniture catalogB
Read-onlyIdempotent

List available furniture items. Filter by category or keyword search.

Inputs: keyword, category.

list_geomsList geomsA
Read-onlyIdempotent

List the &GEOM (triangulated cut-cell geometry) entries in the deck with triangle count, SURF_ID and bounding box.

Inputs: no named parameters.

list_material_libraryList material libraryB
Read-onlyIdempotent

List built-in material presets (density/conductivity/specific heat/pyrolysis) available to add to the model, optionally filtered by category or search text. [bulc-mcp rules] SURF-001 — bulc_knowledge_search ""

Inputs: search, category.

list_meshesList meshesA
Read-onlyIdempotent

List the current &MESH deck (multi-mesh or the single mesh) with per-mesh XB, IJK, cell size, cell count and coarse/fine ratio, plus totals and a self-check for overlap / gaps / non-cubic cells. Read this before set_meshes, slice_mesh or merge_meshes so index numbers refer to the right mesh. [bulc-mcp rules] MESH-001, MESH-005, GEO-003 — bulc_knowledge_search ""

Inputs: no named parameters.

list_obstaclesList obstaclesB
Read-onlyIdempotent

List all obstacles with their ID, position, and properties. [bulc-mcp rules] GEN-002, GEN-003, GEN-004 — bulc_knowledge_search ""

Inputs: no named parameters.

list_raw_namelistsList raw namelistsB
Read-onlyIdempotent

List the raw namelist lines carried through unchanged (&RADI, &PRES, &COMB, &ZONE, &MULT, …) — settings the GUI has no dialog for but the deck and the engine keep. [bulc-mcp rules] GEN-016, SIM-002, SIM-006 — bulc_knowledge_search ""

Inputs: no named parameters.

list_slcfList slcfA
Read-onlyIdempotent

List all slice (SLCF) outputs with id, quantity, plane, and flags.

Inputs: no named parameters.

list_surfacesList surfacesB
Read-onlyIdempotent

List all user-defined general surfaces (&SURF) with their layers and burning behaviour. [bulc-mcp rules] SURF-001 — bulc_knowledge_search ""

Inputs: no named parameters.

list_ventsList ventsB
Read-onlyIdempotent

List all vents with their ID, surface type, and position. [bulc-mcp rules] GEN-004, TRB-002, VENT-002 — bulc_knowledge_search ""

Inputs: no named parameters.

merge_meshesMerge meshesA
Destructive

Merge several meshes back into one (inverse of slice_mesh). Succeeds only when the selected meshes do not overlap and their union is exactly a box. When their cell sizes differ, choice picks which size the result uses; the union must divide into a whole number of those cells. Use list_meshes for index numbers. [bulc-mcp rules] MESH-001, MESH-005 — bulc_knowledge_search ""

Inputs: indices (required), choice.

output_add_tenability_slicesOutput add tenability slicesA
Idempotent

Add the horizontal slices the ASET check needs at floor + height (default 1.8 m) on every story (or the given story ids / absolute z): TEMPERATURE, VISIBILITY and VOLUME FRACTION of OXYGEN, CARBON DIOXIDE, CARBON MONOXIDE (quantities can be limited). Existing identical slices are skipped. Run before sim_start (OUT-006, ASET-004). [bulc-mcp rules] ASET-001, ASET-004 — bulc_knowledge_search ""

Inputs: z, height, stories, quantities.

place_furniturePlace furnitureA

Place a furniture/item at a position. Doors and windows (doors_windows category) auto-snap to the nearest wall and create a wall opening (hole), exactly like the GUI. Items with fire data are placed as fire sources automatically. Changes reflect to the 2D/3D view immediately. [bulc-mcp rules] EVAC-002, FIRE-001, FIRE-002 — bulc_knowledge_search ""

Inputs: x (required), y (required), furniture_id (required), z, +1 more.

preview_fdsPreview fdsA
Read-onlyIdempotent

Render the current project as FDS deck text and return it WITHOUT writing a file (the GUI FDS Preview dialog). Use namelist to show only one group (e.g. "MESH", "SLCF", "OBST", "DUMP") and max_lines to cap the output. This is the fastest way to check that a mesh / output / geometry change lands in the deck the way you expect. [bulc-mcp rules] DEVC-005, DEVC-009, FIRE-013 — bulc_knowledge_search ""

Inputs: namelist, max_lines.

project_export_fdsProject export fdsA
Idempotent

Write the current model as an FDS 6.10.1 input deck (.fds) to path (absolute, must end with .fds). CHID becomes the file name. Refuses to replace an existing file unless overwrite=true. To only read the deck use preview_fds. Live app only. [bulc-mcp] Writes files on this PC; overwrite=true only after the user agreed (GEN-014). [bulc-mcp rules] GEN-006, GEN-010, GEN-016 — bulc_knowledge_search ""

Inputs: path (required), overwrite.

project_infoProject infoA
Read-onlyIdempotent

Read the open project: file path, unsaved changes, CHID, deck path used for runs, stories (id, name, zMin, height, EVAC floorIndex), domain and mesh cells, object counts per module. Call this first in a session and after project_open. Read-only. [bulc-mcp rules] EVAC-002, GEN-006, GEN-010 — bulc_knowledge_search ""

Inputs: no named parameters.

project_newProject newA
Destructive

Start a new empty project in the running app (File > New): clears geometry, evacuation, sprinkler, HVAC and drawing state. Refuses when there are unsaved changes unless discard_unsaved=true. Live app only. [bulc-mcp] discard_unsaved=true throws away unsaved edits — ask the user first (GEN-014). [bulc-mcp rules] GEN-006, GEN-010, GEN-016 — bulc_knowledge_search ""

Inputs: discard_unsaved.

project_openProject openA
Destructive

Open a .bulc project or a .fds deck in the running BULC app (same as File > Open, including evacuation, drawing, sprinkler and HVAC side files). path must be absolute. Refuses when the open project has unsaved changes unless discard_unsaved=true (ask the user first). Live app only. [bulc-mcp] discard_unsaved=true throws away unsaved edits — ask the user first (GEN-014). [bulc-mcp rules] GEN-006, GEN-010, GEN-016 — bulc_knowledge_search ""

Inputs: path (required), discard_unsaved.

project_redoProject redoA

Redo model edits undone with project_undo (Ctrl+Y). steps 1–20 (default 1). [bulc-mcp rules] GEN-006, GEN-010, GEN-016 — bulc_knowledge_search ""

Inputs: steps.

project_saveProject saveA
Idempotent

Save the open project as a .bulc bundle (.bulc + .fds + _evac.json + _spr.json + _hvac.json) like File > Save. Without path it saves to the current .bulc file. A new path must end with .bulc; an existing file is only replaced with overwrite=true. Saving renames CHID to the file name (GEN-009) — result files follow it. Live app only. [bulc-mcp] Writes files on this PC; overwrite=true only after the user agreed (GEN-014). [bulc-mcp rules] GEN-006, GEN-010, GEN-016 — bulc_knowledge_search ""

Inputs: path, overwrite.

project_undoProject undoA

Undo the last model edit(s) of the fire model (obstacles, holes, vents, devices, settings …) like Ctrl+Z. steps 1–20 (default 1). Sprinkler/HVAC/evacuation module edits have their own tools. [bulc-mcp rules] GEN-006, GEN-010, GEN-016 — bulc_knowledge_search ""

Inputs: steps.

remove_bndfRemove bndfB
Destructive

Remove an animated boundary quantity (&BNDF) by QUANTITY (and SPEC_ID/PART_ID when the entry has one).

Inputs: quantity (required), part_id, spec_id.

remove_controlRemove controlC
Destructive

Remove a CTRL control by ID. [bulc-mcp rules] DEVC-004, DEVC-006 — bulc_knowledge_search ""

Inputs: id (required).

remove_deviceRemove deviceA
Destructive

Remove a single device by ID (or internal uid). With duplicate IDs, removes only the first match. [bulc-mcp rules] DEVC-001, DEVC-003, DEVC-004 — bulc_knowledge_search ""

Inputs: id (required).

remove_fireRemove fireB
Destructive

Remove a fire source by index (0-based). [bulc-mcp rules] FIRE-001, FIRE-002, FIRE-003 — bulc_knowledge_search ""

Inputs: index (required).

remove_geomRemove geomB
Destructive

Remove a &GEOM entry by ID (see list_geoms).

Inputs: id (required).

remove_holeRemove holeC
Destructive

Remove a hole by ID. [bulc-mcp rules] EVAC-002, GEO-004 — bulc_knowledge_search ""

Inputs: id (required).

remove_materialRemove materialB
Destructive

Remove a material by ID. [bulc-mcp rules] SURF-001 — bulc_knowledge_search ""

Inputs: id (required).

remove_obstacleRemove obstacleC
Destructive

Remove an obstacle by ID. [bulc-mcp rules] GEN-003 — bulc_knowledge_search ""

Inputs: id (required).

remove_propRemove propA
Destructive

Remove a &PROP model by ID. Devices referencing it fall back to solver defaults.

Inputs: id (required).

remove_rampRemove rampC
Destructive

Remove a ramp by ID.

Inputs: id (required).

remove_raw_namelistRemove raw namelistA
Destructive

Remove a raw namelist line by its index from list_raw_namelists. [bulc-mcp rules] GEN-016, SIM-002, FIRE-009 — bulc_knowledge_search ""

Inputs: index (required).

remove_slcfRemove slcfC
Destructive

Remove a slice file output by ID.

Inputs: id (required).

remove_speciesRemove speciesC
Destructive

Remove a tracked species by ID.

Inputs: id (required).

remove_surfaceRemove surfaceA
Destructive

Remove a general surface (&SURF) by ID. Objects referencing it fall back to INERT. [bulc-mcp rules] SURF-001 — bulc_knowledge_search ""

Inputs: id (required).

remove_ventRemove ventB
Destructive

Remove a vent by ID. [bulc-mcp rules] VENT-002, VENT-004 — bulc_knowledge_search ""

Inputs: id (required).

result_add_graph_probeResult add graph probeB

Add a graph probe to extract time-series data. type=point needs xyz; type=line needs start & end. slot: primary or compare.

Inputs: type (required), end, xyz, slot, +1 more.

result_clear_graph_probesResult clear graph probesB
Destructive

Remove all graph probes.

Inputs: no named parameters.

result_get_stateResult get stateA
Read-onlyIdempotent

Get the result viewer current state: active dataset, current time, colormap, legend range, playback, particles, view-lock, graph probe count. Read this before setting values.

Inputs: no named parameters.

results_detectResults detectB
Read-onlyIdempotent

Find the result files of a deck (named by its &HEAD CHID, next to the .fds): .smv, _hrr.csv, _devc.csv, _ctrl.csv, .out, and list the slice planes (quantity + plane), Plot3D times / quantities, Smoke3D, boundary and particle files. Read-only. [bulc-mcp rules] GEN-010, ASET-004 — bulc_knowledge_search ""

Inputs: fdsPath.

result_set_active_datasetResult set active datasetA
Idempotent

Select the active result dataset by id. Node id shapes: slcf- (slice), pl3d-var- (3D data), s3d- (smoke), bndf- (boundary surface, .bf), prt5- (particles), csv-hrr / csv-devc (time series).

Inputs: id (required).

result_set_colormapResult set colormapC
Idempotent

Set the result colormap. name: 'turbo'|'jet'|'inferno'|'viridis'|'grayscale'.

Inputs: name (required), reversed.

result_set_legend_rangeResult set legend rangeB
Idempotent

Set the result colorbar (legend) min/max range. Use null for auto.

Inputs: max, min.

result_set_particlesResult set particlesC
Idempotent

Configure particle rendering in the result viewer.

Inputs: visible, pointSize, renderMode.

result_set_playback_speedResult set playback speedB
Idempotent

Set result animation playback speed (1.0 = real-time).

Inputs: speed (required).

result_set_timeResult set timeB
Idempotent

Set the result viewer playback time (seconds).

Inputs: time (required).

result_set_view_lockedResult set view lockedB
Idempotent

Lock/link the result view for side-by-side compare (true = linked).

Inputs: locked (required).

result_toggle_playbackResult toggle playbackB

Toggle play/pause of the result animation.

Inputs: no named parameters.

run_simulationRun simulation (guarded)A

Guarded run for any BULC version: writes the project open in BULC to Documents/bulc_<folder_name> and starts the simulation. Before starting, this server runs the app's validate_project and refuses to start when it reports errors (점검 실패) — fix them first. When the app lists sim_preflight / sim_start (BULC 0.90+), prefer sim_preflight → user confirmation → sim_start {confirm: true}: they also check output intervals and grid resolution and write the deck next to the saved project. Summarise the conditions (mesh, fire, T_END, outputs, solver) and get the user's go-ahead before calling (GEN-016). Use a new folder_name per scenario (GEN-019). 실행 전에 validate_project 를 자동으로 돌리고, 오류가 있으면 실행하지 않습니다.

Inputs: folder_name, solver_type.

set_all_boundaries_openSet all boundaries openB
Idempotent

Set all 6 domain faces to OPEN (or selectively by providing a list of faces). [bulc-mcp rules] EVAC-002, VENT-002, VENT-004 — bulc_knowledge_search ""

Inputs: faces.

set_ambientSet ambientA
Idempotent

Set the ambient (initial atmosphere) conditions written to &MISC: TMPA (ambient temperature °C), HUMIDITY (%RH), Y_CO2_INFTY (background CO2 mass fraction). The GPU engine reads all three. Use extra for any other &MISC key you need to carry (e.g. P_INF, GVEC) — it is written verbatim. Pass null for a key to drop it and fall back to the FDS default (TMPA 20°C, HUMIDITY 40%). [bulc-mcp rules] GEN-016, SIM-002 — bulc_knowledge_search ""

Inputs: tmpa, extra, humidity, y_co2_infty.

set_chidSet chidA
Idempotent

Set the simulation CHID (Case Heading Identifier) and optional title. Note: when the project is saved, CHID is normalized to the .fds file name (so output files such as .smv match the deck file); a CHID set here only persists until the next save. [bulc-mcp rules] GEN-006, GEN-010, GEN-016 — bulc_knowledge_search ""

Inputs: chid (required), title.

set_fds_propertiesSet fds propertiesA
Idempotent

Update an obstacle's Runtime FDS Properties. Merge ANY fds_override fields and/or set is_fire_source/hrrpua/surf_ids. fds_override examples — fire: hrrpua_override, tmp_front, ramp_points, fire_area, fire_faces, ext_coeff; fuel/REAC: fuel_type, reac_co_yield, reac_soot_yield, reac_hcn_yield, reac_radiative_fraction; heat detector: activation_temp, rti, initial_temp; smoke: alpha_e, beta_e, alpha_c, beta_c; thermocouple: bead_diameter, emissivity, tc_density, specific_heat; sprinkler: spr_profile_id (shared spray profile), spr_spray_override (per-head FDS keys, e.g. {"particles_per_second":10000,"part":{"age":600}}; replaces the overrides — prefer spr_set_head_spray), spr_temp, spr_rti, k_factor (L/(min·bar^½)), operating_pressure (bar), flow_rate (L/min), spray_angle, particle_diameter (µm), spr_activation_time, spr_orientation (upright still 0,0,-1); HVAC: hvac_direction, volume_flow_rate, temperature, velocity, fan_curve, face_surfs, ramp_up_time. Read current values first with get_object_properties.

Inputs: id (required), hrrpua, surf_ids, fds_override, +1 more.

set_meshSet meshA
Idempotent

Set the computational mesh resolution and domain extents (a single &MESH). ⚠ Resets any multi-mesh deck to a single mesh. Use set_meshes / auto_multimesh to keep or build a multi-mesh deck. [bulc-mcp] Resets a multi-mesh deck to a single mesh (MESH-004). [bulc-mcp rules] MESH-001, MESH-005, GEO-006 — bulc_knowledge_search ""

Inputs: ni (required), nj (required), nk (required), xb.

set_mesh_cell_sizeSet mesh cell sizeA
Idempotent

Set a uniform cell size (m); NI/NJ/NK are computed from the current domain extents. ⚠ Resets any multi-mesh deck to a single mesh. Use set_meshes / auto_multimesh to keep or build a multi-mesh deck. [bulc-mcp] Resets a multi-mesh deck to a single mesh (MESH-004). [bulc-mcp rules] MESH-001, MESH-005, MESH-002 — bulc_knowledge_search ""

Inputs: cell_size (required).

set_meshesSet meshesA
DestructiveIdempotent

Replace the whole &MESH deck with an explicit list of meshes (multi-mesh). Passing a single mesh reverts the project to single-mesh mode. config.mesh (the union bounding box) and the OPEN-boundary vents are kept consistent by the app. Engine constraints (engine multimesh ratio_union_grid): (1) every mesh must use CUBIC cells whose size is the finest cell x 2^k (k in 1,2,4,8,16); (2) every mesh boundary and the union extent must land on a fine-grid index that is a multiple of the LARGEST ratio actually used; (3) meshes must tile the domain with no overlap and no gap; (4) a 1:4 or larger ratio makes the engine print an experimental-feature warning and switches it to per-mesh storage (MM2) plus the composite block-CG v2 pressure solve, both automatically. Verify with list_meshes; for shape-driven placement prefer auto_multimesh. [bulc-mcp rules] MESH-001, MESH-005, MESH-004 — bulc_knowledge_search ""

Inputs: meshes (required).

set_numericsSet numericsA
Idempotent

Set numerical stability controls (time step and advection scheme). Use this when a run diverges, produces NaN, or when matching CPU FDS settings. dt/lock_time_step map to &TIME; the rest to &MISC. Omitted fields keep the FDS default for the current SIMULATION_MODE. particle_global sets the particle/spray-wide keys (&MISC POROUS_FLOOR, PARTICLE_CFL(_MAX/_MIN), CNF_CUTOFF, NEAR_WALL_PARTICLE_INTERPOLATION; &DUMP MAXIMUM_PARTICLES, DT_PART); particle_global_unset returns keys to the FDS default. [bulc-mcp rules] GEN-016, SIM-002, SIM-003 — bulc_knowledge_search ""

Inputs: dt, vn_max, cfl_max, cfl_min, +5 more.

set_open_boundarySet open boundaryB
Idempotent

Set a domain face as OPEN (or close it). Face: XMIN, XMAX, YMIN, YMAX, ZMIN, ZMAX. [bulc-mcp rules] EVAC-002, VENT-002, VENT-004 — bulc_knowledge_search ""

Inputs: face (required), open (required).

set_plot3d_outputsSet plot3d outputsB
Idempotent

Set the Plot3D output quantities and species IDs (NUM dialog). Provide up to 5 quantities. [bulc-mcp rules] ASET-004, EVAC-008, OUT-003 — bulc_knowledge_search ""

Inputs: spec_ids, quantities.

set_run_optionsSet run optionsA
Idempotent

Set simulation RUN options (RUN dialog): solver type (gpu / gpu_cutcell = octree cut-cell engine (beta), runs on the grid from the Mesh dialog cut-cell tab / cpu_openmp), CPU thread count, FDS output path. [bulc-mcp] Writes files on this PC at the path you give. [bulc-mcp rules] GEN-016, SIM-002, SIM-009 — bulc_knowledge_search ""

Inputs: cpu_threads, solver_type, fds_output_path.

set_simulation_modeSet simulation modeC
Idempotent

Set simulation mode: LES, VLES, SVLES, or DNS [bulc-mcp rules] GEN-016, SIM-002, SIM-001 — bulc_knowledge_search ""

Inputs: mode (required).

set_timeSet timeC
Idempotent

Set the simulation end time. [bulc-mcp rules] GEN-016, SIM-002, FIRE-005 — bulc_knowledge_search ""

Inputs: t_end (required), t_begin.

set_turbulence_modelSet turbulence modelB
Idempotent

Set the turbulence model. Options: DEARDORFF (default), VREMAN, WALE, CONSTANT_SMAGORINSKY. [bulc-mcp rules] GEN-016, SIM-002 — bulc_knowledge_search ""

Inputs: model (required).

shape_add_archShape add archA

Shape Studio: add an ARCHED / VAULTED / SEMICIRCULAR ceiling (barrel vault, dome-roof tunnel) in ONE call — a curved shell whose inner surface is a circular arc of clear width span and inner height rise above the springing line (rise = span/2 → semicircle; smaller → shallow segmental arch), extruded length metres along axis. Use this whenever the user asks for a round/arched/curved/semicircular ceiling or tunnel roof instead of composing primitives. Placement: start = coordinate along the axis where the arch begins, center = transverse coordinate of the arch centre line, z_base = height of the springing line (0 = arch rises from the floor; for a room use the wall-top height). Afterwards export it with shape_export_geom (exact curved &GEOM for the cut-cell solver) or shape_export_obst (voxelised). Units: metres.

Inputs: axis (required), span (required), length (required), name, +8 more.

shape_add_boxShape add boxA

Shape Studio: add a box. Origin = bottom-face center, z-up, metres. Optional at=[x,y,z] placement and rotate_deg=[rx,ry,rz].

Inputs: d (required), h (required), w (required), at, +4 more.

shape_add_coneShape add coneB

Shape Studio: add a cone/frustum (r1=bottom radius, r2=top radius, axis z, m).

Inputs: h (required), r1 (required), r2 (required), at, +5 more.

shape_add_cylinderShape add cylinderB

Shape Studio: add a cylinder (axis along z, origin = bottom center, m).

Inputs: h (required), r (required), at, name, +4 more.

shape_add_polygon_prismShape add polygon prismB

Shape Studio: extrude a 2D polygon (xy plane, CCW) along z by height — like FreeCAD Sketch+Pad. points=[[x,y],...] (m).

Inputs: height (required), points (required), at, name, +3 more.

shape_add_revolveShape add revolveB

Shape Studio: revolve a half-profile around the z axis — like FreeCAD Revolution. points=[[radius,z],...] radius>=0, top-to-bottom order. angle_deg default 360.

Inputs: points (required), at, name, color, +4 more.

shape_add_sphereShape add sphereC

Shape Studio: add a sphere (origin = bottom tangent point, m).

Inputs: r (required), at, name, color, +2 more.

shape_add_torusShape add torusC

Shape Studio: add a torus lying in the xy plane (r=ring radius, tube=tube radius, m).

Inputs: r (required), tube (required), at, name, +4 more.

shape_add_wedgeShape add wedgeB

Shape Studio: add a right-angle wedge (ramp). Base w×d, height h; slope descends along +x. (m)

Inputs: d (required), h (required), w (required), at, +4 more.

shape_arrayShape arrayB

Shape Studio: repeat a node. linear: step=[dx,dy,dz] per copy. polar: rotate copies around a z-parallel axis at axis_point=[x,y], total angle_deg (default 360).

Inputs: mode (required), count (required), input (required), name, +3 more.

shape_booleanShape booleanB

Shape Studio: boolean of nodes. union=merge all; subtract=first minus rest; intersect=common volume. Input nodes are consumed into the result.

Inputs: op (required), inputs (required), name, color, +1 more.

shape_delete_nodeShape delete nodeB
Destructive

Shape Studio: delete a node. with_inputs (default true) also deletes its consumed input subtree.

Inputs: id (required), with_inputs.

shape_edit_nodeShape edit nodeA

Shape Studio: rename / show-hide / assign FDS SURF / set color / mark fire faces + fire properties of a node. fire_faces: 6 booleans in FDS SURF_ID6 order [-X,+X,-Y,+Y,-Z,+Z] OR face-name strings like ["-Z"] ("bottom"/"top" aliases ok); [] clears. Fire faces render as red hatching in the viewport and are wired to a FIRE SURF (+ RAMP_Q / &REAC) on shape_export_obst. Fire properties (merged individually, unspecified keys keep their previous value): fire_hrrpua, fire_tmp_front (°C), fire_ramp_points ([[t_seconds, fraction_0..1], ...] HRR time curve), fire_fuel_type, fire_soot_yield, fire_co_yield, fire_radiative_fraction, fire_ext_coeff. ONE FIRE OBST PER DOCUMENT: fire faces may exist on only one shape — assigning them to another node automatically clears the previous node's fire faces. PLAN FIRST: real FDS can only apply a fire SURF to a FLAT face (never a curved or stepped one), so setting fire_faces without plan_confirmed changes nothing (the fire_* properties in the same call are dropped too) and returns a 6-direction flatness analysis instead — discuss it with the user, agree on which flat face, HRRPUA, RAMP and combustion properties, then call again with plan_confirmed=true.

Inputs: id (required), name, color, surf_id, +11 more.

shape_export_geomShape export geomA

Shape Studio → FDS cut-cell: export the exact CSG mesh as an &GEOM triangulated surface — no voxelization, so slopes and curves keep their true shape instead of being stair-stepped like shape_export_obst. Only a watertight surface is exported: primitives, hull, array, mirror and non-overlapping unions are fine, but an OVERLAPPING boolean (union/subtract/intersect) always leaves an open seam the CSG library cannot close, so the export is refused — voxelize those with shape_export_obst instead. Needs a GPU engine build with cut-cell support; older engines parse &GEOM but ignore it. Fire (HRRPUA) on a GEOM surface is not supported yet — use shape_export_obst for the burner. Units m, z-up. Default: every visible root, each keeping its own SURF; origin repositions the bbox min corner. [bulc-mcp rules] GEO-010 — bulc_knowledge_search ""

Inputs: geom_id (required), rgb, origin, node_id, +3 more.

shape_export_objShape export objA

Shape Studio → CFD: export the exact CSG mesh as OBJ (no voxelization). Units m, z-up. [bulc-mcp] Writes files on this PC at the path you give.

Inputs: path (required), node_id.

shape_export_obstShape export obstA

Shape Studio → FDS: voxelize the shape (node_id, or union of all visible roots) and add it to the model as an obstacle with voxel geometry. Recommended: align_to_mesh=true — voxels then use the project MESH cell size and sit exactly on FDS cell boundaries (no ±1 cell snapping). Otherwise voxel_size (m, e.g. 0.1) or per-axis cell [dx,dy,dz]. voxel_mode "shell" voxelizes only the surface (hollow meshes such as hoods, ducts, funnels, open imported STL); default "solid" fills the inside. origin optionally repositions the bbox min corner in the domain (breaks mesh alignment). [bulc-mcp rules] GEN-003, GEO-009, GEO-010 — bulc_knowledge_search ""

Inputs: obstacle_id (required), cell, origin, node_id, +4 more.

shape_export_stlShape export stlA

Shape Studio → CFD (OpenFOAM etc.): export the exact CSG mesh as STL (no voxelization). ascii=true for text STL with solid name (snappyHexMesh patch name). Units m, z-up. [bulc-mcp] Writes files on this PC at the path you give.

Inputs: path (required), ascii, node_id, solid_name.

shape_extrude_sketchShape extrude sketchA

Shape Studio (SketchUp-style): draw closed 2D loops on ANY plane and extrude them along the plane normal. plane = {origin:[x,y,z], normal:[nx,ny,nz], x_axis:[ax,ay,az]} (x_axis ⟂ normal; y = normal × x_axis); loops = [[[u,v],...], ...] in plane coords, even-odd fill so inner loops become holes. distance (m, sign = along/against normal). mode "new" makes a separate solid; "add"/"cut" fuses into / carves out of target_id (the result replaces target in the tree). Booleans are watertight (manifold kernel), so coplanar faces are fine.

Inputs: loops (required), plane (required), distance (required), mode, +4 more.

shape_get_item_fds_propsShape get item fds propsB
Read-onlyIdempotent

Item library: read the FDS properties and metadata of a registered item.

Inputs: item_id (required).

shape_get_treeShape get treeA
Read-onlyIdempotent

Shape Studio: get the current feature tree (nodes, params, roots, bounding boxes). Call this to see what exists before editing.

Inputs: no named parameters.

shape_hullShape hullC

Shape Studio: convex hull of the given nodes (blob/rounded forms).

Inputs: inputs (required), name.

shape_import_meshShape import meshA

Shape Studio: import an STL or OBJ file as a mesh node (metres). y_up=true if the file is Y-up (converted to Z-up). For GLB/FBX use the Shape Studio UI import button.

Inputs: path (required), at, name, y_up, +2 more.

shape_mirrorShape mirrorA

Shape Studio: mirror a node across a plane ('xy'|'yz'|'xz', offset = plane position). keep_original default true (result = original + mirrored union).

Inputs: input (required), plane (required), name, offset, +1 more.

shape_new_documentShape new documentA

Shape Studio: start a new empty shape document (discards current shape tree).

Inputs: no named parameters.

shape_preview_voxelsShape preview voxelsA

Shape Studio: switch the viewport into FDS voxel preview mode — it shows exactly what the shape becomes once voxelized into FDS OBST boxes (including the fire faces). size = voxel edge in metres (default 0.1), off=true returns to the smooth CSG view. Call this before shape_screenshot to review the FDS result rather than the ideal mesh. GUI only (no effect headless). [bulc-mcp rules] GEO-009 — bulc_knowledge_search ""

Inputs: off, size.

shape_push_pullShape push pullA

Shape Studio (SketchUp Push/Pull): pick a flat face of node_id and push it in (negative distance → carves) or pull it out (positive → extends the solid). The face is the whole coplanar region reached from the triangle whose outward normal matches face ("+x","-x","+y","-y","+z","-z" or [nx,ny,nz]); point [x,y,z] selects among several faces facing that way (nearest wins), otherwise the outermost one. Works on any node, including results of earlier push/pulls and booleans. Example: box then shape_push_pull(face:"+z", distance:0.5) raises the top by 0.5 m.

Inputs: face (required), node_id (required), distance (required), name, +1 more.

shape_register_itemShape register itemA

Shape Studio: voxelize the shape and register it as a reusable library item (furniture/item catalog). It then appears in the Item panel and can be placed like any furniture. Optionally set FDS fire properties at the same time.

Inputs: name (required), voxel_size (required), icon, color, +5 more.

shape_screenshotShape screenshotA
Read-onlyIdempotent

Shape Studio: capture a screenshot of the running GUI (Shape Studio opens automatically) so you can visually REVIEW the shape you built. Returns a PNG file path — read the image, compare against reference photos, then fix with shape_set_params. select_node opens that node in the property panel first (e.g. to review fire faces / HRR chart). Live GUI mode only. [bulc-mcp] Writes files on this PC at the path you give.

Inputs: path, select_node.

shape_set_item_fds_propsShape set item fds propsA
Idempotent

Item library: set FDS fire/material properties on a registered item (shown via the item panel's 'Library FDS Properties' button and applied when the item is placed). Sets a 'fire' preset override.

Inputs: item_id (required), hrrpua, ramp_id, co_yield, +11 more.

shape_set_paramsShape set paramsA
Idempotent

Shape Studio: change parameters of an existing node — everything downstream recomputes automatically (parametric). e.g. {id:"s3", params:{r:0.4}} or {params:{translate:[1,0,0]}} on a transform node.

Inputs: id (required), params (required).

shape_transformShape transformA

Shape Studio: wrap a node with translate/rotate/scale. To move an existing shape, prefer shape_set_params on its transform node if it has one.

Inputs: input (required), name, scale, translate, +1 more.

shape_undoShape undoB

Shape Studio: undo the last document mutation.

Inputs: no named parameters.

sim_log_tailSim log tailA
Read-onlyIdempotent

Last lines of the engine console output of the current / last run (lines ≤ 500, default 60). grep = optional regular expression filter. Read-only. [bulc-mcp rules] GEN-016, SIM-002 — bulc_knowledge_search ""

Inputs: grep, lines.

sim_preflightSim preflightA
Read-onlyIdempotent

Pre-run check with structured results: every issue carries a knowledge-pack rule id (e.g. OUT-001, VENT-001, MESH-002). Combines validate_project, the run dialog deck checks (output intervals ≥ T_END, deck reference errors CPU FDS rejects, fires outside the mesh, spray keys the chosen GPU solver ignores, LOCK_TIME_STEP stability hint) and grid resolution advice (D*/dx from the peak HRR). ok=false means do not run. solver = gpu (default) | gpu_cutcell | cpu_openmp. Read-only. [bulc-mcp rules] GEN-006, GEN-010, GEN-016 — bulc_knowledge_search ""

Inputs: solver.

sim_startSim startA

Start the fire simulation in the running app after the user agreed (confirm=true required). Runs sim_preflight first and refuses on errors (force=true only if the user explicitly accepts). The deck is written next to the saved project (.bulc → .fds, like the toolbar RUN) or, for an unsaved project, to Documents/bulc_/. Refuses while another run is active. solver = gpu (default) | gpu_cutcell | cpu_openmp; restart=true resumes from the checkpoint. Then poll sim_status. Live app only. [bulc-mcp] Starts the solver (GPU for minutes to hours): sim_preflight, summary, the user's go-ahead first (GEN-016). [bulc-mcp rules] GEN-006, GEN-010, GEN-016 — bulc_knowledge_search ""

Inputs: confirm (required), force, solver, restart, +3 more.

sim_statusSim statusA
Read-onlyIdempotent

Status of the current / last fire simulation of this app session: running or finished, exit code, simulated time vs T_END (percent, ETA), step, dt, CFL, HRR (kW), Tmax (K), max velocity, NaN count, health flags (nan=0, Tmax ≤ 2500 K, |u| < 50 m/s) and sprinkler / detector activation times read from the engine log. Read-only. [bulc-mcp rules] GEN-010, GEN-016, SIM-002 — bulc_knowledge_search ""

Inputs: no named parameters.

sim_stopSim stopA
Destructive

Stop the running fire simulation (confirm=true). mode graceful (default) writes .stop so the engine finishes its output files and a restart checkpoint; mode kill ends the process at once (results may be incomplete). Live app only. [bulc-mcp rules] GEN-016, SIM-002 — bulc_knowledge_search ""

Inputs: confirm (required), mode.

slice_meshSlice meshA

Split one mesh into two at a plane (multi-mesh cutter). The coordinate snaps to that mesh's own grid lines, cell size is preserved on both halves, and OPEN vents crossing the plane are split too. Slicing the single mesh turns the project into a multi-mesh deck. Use list_meshes for index numbers. [bulc-mcp rules] MESH-001, MESH-005 — bulc_knowledge_search ""

Inputs: axis (required), coord (required), index (required).

spr_add_drainSpr add drainA

Add a drain hole (always-open orifice, flow = K√P, no required pressure): on a pipe at position (splits it with a new branch node), on an existing node, or at a free point. K defaults to the project nozzle K (drain hole = sprinkler orifice); orificeDiameterMm converts with Cd 0.62. [bulc-mcp rules] SPR-023 — bulc_knowledge_search ""

Inputs: x, y, z, zone, +9 more.

spr_add_nodeSpr add nodeA

Add a pipe network node (junction, sprinkler, or source). A junction can carry a fitting (elbow/tee/cross/wye/reducer); "auto" (default) detects it from the connected pipes. Node ids are generated by the store — call spr_list_summary to get them. [bulc-mcp] Give heads / terminals a unique label (H1, H2 …, EX1 …): it becomes the FDS id after *_apply_to_fds (GEN-021). [bulc-mcp rules] EVAC-001, SPR-001, SPR-002 — bulc_knowledge_search ""

Inputs: x (required), y (required), type (required), z, +3 more.

spr_add_pipeSpr add pipeA

Connect two nodes with a pipe. For a floor-to-floor connection use spr_add_riser (exactly vertical) first, then connect horizontally on the upper story [bulc-mcp rules] SPR-002, SPR-008 — bulc_knowledge_search ""

Inputs: endNodeId (required), startNodeId (required), lineNo, valves, +4 more.

spr_add_riserSpr add riserA

Floor-to-floor riser (e.g. 1F → 2F): a perfectly vertical pipe (same x,y, only z changes) from the node up/down to a NEW junction on the target story at targetZ (default: same height above the target story floor as the source node above its own floor). It never attaches to a nearby existing node; only a node at exactly the same position (±1 mm in x,y,z) is reused. Continue the upper network from the new junction (id via spr_list_summary). The riser is a normal pipe — the hydraulic calculation includes its static head ρgΔz and the elbows at its ends. Stories: draw_list_stories / draw_add_story. sameFloor=true makes a vertical pipe on the SAME story instead (drop / rise to targetZ or by dz, e.g. dz=-1.0 for a 1 m drop). [bulc-mcp rules] SPR-009 — bulc_knowledge_search ""

Inputs: nodeId (required), dz, targetZ, diameter, +4 more.

spr_add_sprinkler_headSpr add sprinkler headA

Add a sprinkler head to an existing sprinkler node. The head follows a shared spray profile (sprayProfileId, default = project default profile); K / activation temperature / RTI default to that profile. spray / particle override single FDS &PROP / &PART keys for this head only. [bulc-mcp rules] SPR-010, SPR-011 — bulc_knowledge_search ""

Inputs: nodeId (required), rti, zone, spray, +12 more.

spr_add_water_sourceSpr add water sourceB

Add a water source to an existing source node: city water (static / residual pressure at residual flow), pump (rated flow / rated head / shut-off head or a curve), gravity tank (water level elevation), pressure tank. [bulc-mcp rules] SPR-001 — bulc_knowledge_search ""

Inputs: nodeId (required), pumpCurve, sourceType, tankVolume, +7 more.

spr_analyze_drawingSpr analyze drawingA
Read-onlyIdempotent

Read a sprinkler / water-spray piping drawing (.dxf, .dwg, .pdf, .zip of drawings, .png/.jpg) and recognise a candidate pipe network. Isometric (ISO) drawings: scale from DIMENSION entities, pipe linetype, bends, flange/valve gaps bridged, nozzle stems, line-number / reducer / valve labels, 3D reconstruction (X,Y horizontal, Z up, inlet = origin), nominal sizes from labels and flange rings. Plan drawings: pipe layers + head symbols at one height. Returns a summary with candidateId, open ends (drain candidates), reference (dashed, other-system) labels, exclusion hints, runs and ambiguities to ask the user about. Attached chat files arrive as "[첨부 도면] name path=… candidateId=…". PDFs with outlined text set needsVision (read the page image instead). show=segments|nodes|runs|tags|components lists details (ids, offset, limit, component). Then call spr_import_network. [bulc-mcp rules] DRW-006 — bulc_knowledge_search ""

Inputs: ids, show, entry, limit, +5 more.

spr_apply_to_fdsSpr apply to fdsA

Apply the hydraulic pipe-network sprinklers to the FDS model: for every sprinkler node (with a head and calc results from spr_run_calc), creates/replaces DEVC (SPRINKLER LINK TEMPERATURE) + PROP + PART entries using the calculated nozzle flow and pressure. Run spr_run_calc first. [bulc-mcp rules] DEVC-001, SPR-001, SPR-002 — bulc_knowledge_search ""

Inputs: no named parameters.

spr_auto_layoutSpr auto layoutA

Automatically build a complete, calculable sprinkler pipe network in a rectangular area: a water source node (city water) at the (xMin, yMin) corner, a cross-main along x = xMin, one branch line per row, sprinkler nodes on a grid with heads, and every connecting pipe. Follow with spr_run_calc and spr_apply_to_fds to put the sprinklers into the FDS model. [bulc-mcp rules] SPR-001, SPR-002, SPR-003 — bulc_knowledge_search ""

Inputs: xMax (required), xMin (required), yMax (required), yMin (required), +4 more.

spr_design_reviewSpr design reviewA
Read-onlyIdempotent

Specification and design-error review of the sprinkler / water-spray network and its design results (deterministic). Checks: pipe pressure rating by standard (KS D 3507 1.2 MPa NFTC 103, SGP, B31.1 wall formula, CuNi/GRE ratings), valve / flange class (JIS 5K/10K/16K/20K, PN, ASME class from valve std/tag), velocities vs limits, nozzles below required / above max pressure, imbalance, drains, closed valves isolating nozzles, disconnected / orphan / dead-end / coincident nodes, zero-length or duplicate pipes, expansion against flow, tee imbalance, high-loss valves, standards / sizes / C / K / required pressure data, zones and zone valves, stories and risers, pump curve NFPA 20 and run-out. Each finding: severity, category, location, message, suggested fix, ids. [bulc-mcp rules] SPR-001, SPR-002, SPR-003 — bulc_knowledge_search ""

Inputs: code, limit, offset, category, +8 more.

spr_export_resultsSpr export resultsA

Write the sprinkler / water-spray design results to files: format csv = 5 tables (summary, zones, lines by line number, nozzles, pipes; UTF-8 BOM), fhc = FHC (Canute) calculation-sheet style CSVs (report, heads, pipes, summary, lines, NFPA worksheet, node map), both. scenario = "all" | "zone:" (default governing scenario), at = supply (actual source) | design (inverse design point). zip=true also writes one zip per format. language = header language (ko default). Uses the current design results or recalculates them. fhcDraft=true adds the FHC project-file draft (.FHC) and pipe data table draft (.PDT) to the FHC files (check them in FHC before use). The FHC files include _bulc_model.csv, which spr_import_fhc_bundle reads back exactly. [bulc-mcp] Writes files on this PC at the path you give. [bulc-mcp rules] SPR-001, SPR-002, SPR-003 — bulc_knowledge_search ""

Inputs: outputDir (required), at, zip, format, +5 more.

spr_get_resultsSpr get resultsA
Read-onlyIdempotent

Get sprinkler / water-spray results (run spr_run_calc first). With a design calculation: operation (all open / zone deluge), per scenario the actual-source flow and minimum margin, the REQUIRED SOURCE PRESSURE (inverse: every nozzle reaches its own required pressure), design flow, governing nozzle, pump check, warnings. detail = lines (table by line number) | zones | nozzles | pipes for one scenario (default governing) at supply or design point. Also the classic totals (total flow, source pressure, velocity / flow ranges, fitting losses). [bulc-mcp rules] SPR-001, SPR-002, SPR-003 — bulc_knowledge_search ""

Inputs: at, limit, detail, scenario.

spr_import_fhc_bundleSpr import fhc bundleA
Destructive

Load a BULC "FHC-style" export bundle back (zip, folder of CSVs, or *_bulc_model.csv). mode check (default) changes nothing: compares the bundle network and settings field by field with the CURRENT network, recalculates the bundle network and compares with the results written in the file (nozzle flows / pressures, required source pressure, summary). mode apply replaces the current pipe network with the bundle (undo history cleared, like opening a file) and runs the design calculation. Older bundles without bulc_model can only be partly restored (allowPartial). This is NOT an importer for files saved by the FHC (Canute) program. [bulc-mcp rules] SPR-001, SPR-002, SPR-003 — bulc_knowledge_search ""

Inputs: filePath (required), mode, recalc, allowPartial.

spr_import_networkSpr import networkA
Destructive

Create the recognised (or a hand-written) pipe network in the sprinkler module in ONE undo step: nodes, pipes (nominal size, pipe standard, C, line number, valves), nozzles (kind closed|open|drain, K, required pressure, zone, line), drains and the water source. From a drawing: candidateId (+ components, excludeSegments/Nodes/Lines/Runs, source, defaults, drains, nozzleOverrides, zoneByLine/Run/Component, valves, placement). Hand-written: network = {version:1, units:"m", nodes:[{ref,x,y,z}], pipes:[{from,to,diameter,lineNo}], heads:[{node,kind,kFactor,requiredPressure,zone}], sources:[{node,sourceType,…}]}. Water-spray ISO nozzles default to open K80 (project default: general K80, zone deluge — confirm with the user). Validates first (nothing changes on error); dryRun only reports. scriptPath saves the payload JSON (re-import later). mode append (default) | replace. Then spr_run_calc. [bulc-mcp] mode='replace' replaces the current pipe network; call with dryRun=true first (DRW-009).

Inputs: mode, drains, dryRun, source, +15 more.

spr_insert_fittingSpr insert fittingA

Insert a fitting into an existing pipe. elbow90 / elbow90_long / elbow45: bend the pipe into an L shape through a new intermediate corner node (route l_x = go along X first, l_y = Y first; elbow45 makes the last leg a 45° diagonal). tee / cross / wye / reducer: split the pipe at position with a new junction node carrying that fitting (then draw branch pipes from it with spr_add_pipe). The new node id is in spr_list_summary. [bulc-mcp rules] EVAC-001, SPR-002, SPR-007 — bulc_knowledge_search ""

Inputs: pipeId (required), fitting (required), route, position, +1 more.

spr_list_summarySpr list summaryA
Read-onlyIdempotent

Get the sprinkler status (read-only): pipe network nodes / pipes / fittings / risers with ids, sprinkler heads with their spray profile and override count, the spray profile library with usage. include_presets lists spray presets (standard, quick response, ESFR, residential, water mist low/intermediate/high pressure); profile_id returns one profile with every FDS key and the heads using it. [bulc-mcp rules] EVAC-001, SPR-001, SPR-002 — bulc_knowledge_search ""

Inputs: profile_id, include_presets.

spr_pump_sizingSpr pump sizingA
Read-onlyIdempotent

Pump specification for the sprinkler / water-spray network (deterministic). mode from_design (default): from the design calculation (per deluge zone or all-open) → rated flow and pressure with a safety margin, the points the pump curve must pass, NFPA 20 checks (churn ≤ 140 %, ≥ 65 % at 150 % flow), NFPA 20 standard capacity, hydraulic / shaft power and motor kW, NPSHa, pump type, governing zone and nozzle, governing-path losses and re-solved what-if hints (nozzle K −10 %, upsizing the bottleneck, closing drains, valve loss). mode target: a target flow and/or pressure at the source node. mode check_curve: check the network pump curve or a given curve. apply=true writes the proposed curve to the water source (then spr_run_calc). [bulc-mcp rules] SPR-001, SPR-003, SPR-030 — bulc_knowledge_search ""

Inputs: mode, apply, curve, fluid, +19 more.

spr_remove_nodeSpr remove nodeA
Destructive

Remove a pipe node (also removes connected pipes and heads) [bulc-mcp rules] EVAC-001, SPR-002 — bulc_knowledge_search ""

Inputs: id (required).

spr_remove_pipeSpr remove pipeC
Destructive

Remove a pipe connection by ID

Inputs: id (required).

spr_remove_sprinkler_headSpr remove sprinkler headB
Destructive

Remove a sprinkler head by ID [bulc-mcp rules] SPR-010, SPR-011 — bulc_knowledge_search ""

Inputs: id (required).

spr_remove_water_sourceSpr remove water sourceC
Destructive

Remove a water source by ID [bulc-mcp rules] SPR-001 — bulc_knowledge_search ""

Inputs: id (required).

spr_run_calcSpr run calcA

Run the hydraulic calculation. mode design (default) = scenarios "all" and one per deluge zone, each at the actual water source AND the inverse REQUIRED SOURCE PRESSURE (minimum source pressure so every participating nozzle reaches its own required pressure; drains always open; closed valves exclude pipes) with the governing nozzle and a pump check. mode calc = the classic single forward calculation. Read the results with spr_get_results (next round) — detail lines gives the table by line number. [bulc-mcp rules] SPR-001, SPR-002, SPR-003 — bulc_knowledge_search ""

Inputs: mode, zones, inverse, scenarios.

spr_set_defaultsSpr set defaultsA
Idempotent

Set default pipe diameter, pipe standard and K-factor for new pipes/heads, the project default spray profile, the hydraulic minor-loss options (fittings/valves by NFPA 13 equivalent length, large-size 250-600 mm table), and the DESIGN BASIS: default required pressure per nozzle kind (requiredPressureClosed / requiredPressureOpen, MPa), operation (auto = zone deluge when zones exist / all_open / zone_deluge), includeClosedHeads (false = only open nozzles and drains discharge), drainCd, velocity warning / fail limits. [bulc-mcp rules] SPR-001, SPR-002, SPR-003 — bulc_knowledge_search ""

Inputs: drainCd, drawRoute, operation, velocityFail, +12 more.

spr_set_head_spraySpr set head sprayA
Idempotent

Set per-head spray settings on one or many sprinkler heads — pipe-network heads, obstacle sprinklers and DEVC sprinklers alike (the GUI spray dialog "this head only" path). Pick heads with all / group (interlock or deluge group) / network_of_node / head_ids / node_ids / obstacle_ids / device_ids. profile_id links them to a shared profile (pipe heads take its K, activation temperature and RTI unless keep_head_values). prop / part override single FDS keys for these heads only; inherit lists keys to hand back to the profile (prop/part keys or orientation, rotation, pipe_index, activation); reset drops every override. orientation / rotation / pipe_index / activation are DEVC values. head_type applies to pipe heads (upright still sprays down). All heads are checked first; if any would be an FDS error nothing changes. Pipe heads whose K changed need spr_run_calc then spr_apply_to_fds. [bulc-mcp rules] DEVC-001, SPR-010, SPR-011 — bulc_knowledge_search ""

Inputs: all, part, prop, group, +14 more.

spr_set_nozzlesSpr set nozzlesA
Idempotent

Set nozzle data on many pipe-network nozzles at once — choose them with all / headIds / nodeIds / zone / lineNo / kind (filters combine). Sets kind (closed sprinkler | open nozzle | drain), K, the REQUIRED DISCHARGE PRESSURE per nozzle (MPa; clearRequiredPressure = back to the design default), zone (deluge zone), lineNo, disabled, nozzleModel, drain orifice diameter (K recalculated). One undo step. [bulc-mcp rules] SPR-010, SPR-011, SPR-017 — bulc_knowledge_search ""

Inputs: all, kind, zone, lineNo, +11 more.

spr_set_pipesSpr set pipesA
Idempotent

Change many pipes at once: choose all / pipeIds / lineNo / runOf (the run through that pipe up to branches); set the pipe standard (material, C resets unless keepC), Hazen-Williams C, line number. One undo step per change. Out-of-standard sizes keep their size (inner diameter = nominal) and are reported. [bulc-mcp rules] SPR-003, SPR-005, SPR-021 — bulc_knowledge_search ""

Inputs: all, keepC, runOf, lineNo, +4 more.

spr_set_valvesSpr set valvesA
Idempotent

Open / close valves (closed valve → that pipe is excluded from the calculation, downstream is isolated) and set their tag or zone (zone valve = open only in the "all" scenario and its own zone scenario). Choose with pipeId (+ index, default all valves on the pipe), tag, or zone. [bulc-mcp rules] SPR-008, SPR-022 — bulc_knowledge_search ""

Inputs: tag, open, type, zone, +4 more.

spr_update_nodeSpr update nodeB
Idempotent

Update properties of an existing pipe network node, including its fitting (auto = detect from connected pipes). [bulc-mcp rules] DEVC-001, EVAC-001, SPR-002 — bulc_knowledge_search ""

Inputs: id (required), x, y, z, +4 more.

spr_update_pipeSpr update pipeA
Idempotent

Update properties of an existing pipe: diameter, pipe standard (C resets to the standard default), Hazen-Williams C, line number, and the inline valve list (replaces all valves; [] removes them; valveDetails sets open/closed, tag, zone). For many pipes use spr_set_pipes; to open/close one valve use spr_set_valves. [bulc-mcp rules] SPR-008, SPR-005, SPR-016 — bulc_knowledge_search ""

Inputs: id (required), lineNo, valves, cFactor, +3 more.

spr_update_sprinkler_headSpr update sprinkler headA
Idempotent

Update one pipe-network sprinkler head: K / activation temperature / RTI / type, its shared spray profile (sprayProfileId), per-head spray overrides (spray = &PROP keys, particle = &PART keys, inherit = keys to hand back to the profile, clearSpray = drop all). Applied FDS copies of the head are rebuilt. For many heads or obstacle/DEVC sprinklers use spr_set_head_spray. [bulc-mcp rules] SPR-010, SPR-011 — bulc_knowledge_search ""

Inputs: id (required), rti, zone, spray, +15 more.

spr_update_water_sourceSpr update water sourceA
Idempotent

Update an existing water source (type, city-water pressures, pump rated flow / rated head / shut-off head / curve, tank level). [bulc-mcp rules] SPR-001, SPR-003, SPR-016 — bulc_knowledge_search ""

Inputs: id (required), pumpCurve, sourceType, tankVolume, +7 more.

spr_upsert_spray_profileSpr upsert spray profileA

Create, update or delete a shared SPRAY PROFILE — the FDS 6.10.1 &PROP+&PART template (flow, spray pattern, droplet size distribution, breakup, drag, evaporation, surface film, parcels) that sprinkler and water-mist heads reference. Omit id (or give a new id) to create: it starts from preset (default std_pendant_k80) or copy_from. With an existing id, preset overwrites its values, prop/part merge keys and unset_prop/unset_part return keys to the FDS default. Presets: standard, quick response, ESFR, residential, water mist low (12 bar) / intermediate (21 bar) / high (70-100 bar) — spr_list_summary {include_presets:true}. assign_to links heads to the profile (pipe heads take its K, activation temperature and RTI). Every edit is checked like FDS (K or pressure alone = ERROR 238, no DIAMETER = 214, equal SPRAY_ANGLE = 231, bad EVAP_MODEL = 224) for the profile and every head using it; on error nothing changes. Per-head overrides: spr_set_head_spray.

Inputs: id, name, part, prop, +11 more.

transform_obstacleTransform obstacleA

Move / resize / rotate an existing obstacle (the 3D gizmo + property-panel SX/SY/SZ of the GUI). move = relative offset [dx,dy,dz] (m); place_at = absolute target point for anchor (default the XB centre); scale = absolute per-axis scale factors that stretch XB about its centre and rescale furniture voxels; rotation = [rx,ry,rz] degrees (kept as GUI metadata — &OBST itself stays axis-aligned, so a rotated furniture item is exported through its voxels). Combine as many as you need in one call. [bulc-mcp rules] DEVC-001, GEN-003, GEO-002 — bulc_knowledge_search ""

Inputs: id (required), move, scale, anchor, +2 more.

update_controlUpdate controlB
Idempotent

Update an existing CTRL by ID. Any field of add_control can be changed. [bulc-mcp rules] DEVC-004, DEVC-006 — bulc_knowledge_search ""

Inputs: id (required), n, delay, latch, +13 more.

update_deviceUpdate deviceB
Idempotent

Update an existing device by ID (or internal uid). Any &DEVC field can be changed; only one device is modified even with duplicate IDs. [bulc-mcp rules] DEVC-001, DEVC-003, DEVC-004 — bulc_knowledge_search ""

Inputs: id (required), xb, ior, xbp, +33 more.

update_dump_configUpdate dump configC
Idempotent

Update output dump intervals and settings. [bulc-mcp rules] EVAC-008, OUT-001, OUT-004 — bulc_knowledge_search ""

Inputs: dt_hrr, dt_s3d, dt_bndf, dt_devc, +5 more.

update_fireUpdate fireC
Idempotent

Update an existing fire source by index (0-based). [bulc-mcp rules] FIRE-001, FIRE-002, FIRE-003 — bulc_knowledge_search ""

Inputs: index (required), xb, hrrpua, ramp_id, +1 more.

update_holeUpdate holeC
Idempotent

Update an existing hole by ID. [bulc-mcp rules] EVAC-002, GEN-003, GEO-004 — bulc_knowledge_search ""

Inputs: id (required), xb.

update_materialUpdate materialC
Idempotent

Update a material by ID. [bulc-mcp rules] SURF-001 — bulc_knowledge_search ""

Inputs: id (required), density, emissivity, conductivity, +1 more.

update_obstacleUpdate obstacleC
Idempotent

Update an existing obstacle by ID. Provide only fields to change. [bulc-mcp rules] GEN-003, GEO-002, GEO-005 — bulc_knowledge_search ""

Inputs: id (required), xb, surf_ids.

update_propUpdate propB
Idempotent

Update an existing &PROP model by ID. Same fields as add_prop; spray_unset removes spray keys (FDS default). [bulc-mcp rules] DEVC-009 — bulc_knowledge_search ""

Inputs: id (required), rti, spray, beta_c, +20 more.

update_rampUpdate rampB
Idempotent

Update an existing ramp with new points.

Inputs: id (required), points (required).

update_reactionUpdate reactionC
Idempotent

Update the combustion reaction parameters. [bulc-mcp rules] FIRE-003, FIRE-007, FIRE-009 — bulc_knowledge_search ""

Inputs: c, h, n, o, +6 more.

update_slcfUpdate slcfC
Idempotent

Update an existing SLCF output by ID. [bulc-mcp rules] OUT-002 — bulc_knowledge_search ""

Inputs: id (required), pbx, pby, pbz, +4 more.

update_surfaceUpdate surfaceA
Idempotent

Update an existing general surface (&SURF) by ID. Only the given fields change. [bulc-mcp rules] SURF-001 — bulc_knowledge_search ""

Inputs: id (required), color, tau_q, hrrpua, +27 more.

update_ventUpdate ventC
Idempotent

Update an existing vent by ID. [bulc-mcp rules] GEN-003, VENT-002, VENT-004 — bulc_knowledge_search ""

Inputs: id (required), xb, surf_id, mass_flux, +1 more.

validate_projectValidate projectA
Read-onlyIdempotent

Pre-flight check of the whole project before export or run: deck generation, mesh/domain sanity, objects outside the domain, duplicate IDs, dangling SURF_ID / MATL_ID / CTRL INPUT_ID / DEVC references, output intervals larger than T_END (which would store only the t=0 frame), missing OPEN boundary, fire without a reaction fuel, LOCK_TIME_STEP without DT, and sprinkler / spray-profile key combinations FDS 6.10.1 rejects. Returns errors (deck will not run) and warnings (deck runs but the result is probably not what you want). [bulc-mcp rules] DEVC-004, DEVC-005, DEVC-006 — bulc_knowledge_search ""

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 249 tools

    Disambiguation2/5

    With 249 tools there is heavy functional overlap between modules: set_mesh / set_meshes / set_mesh_cell_size / auto_fit_mesh / auto_multimesh / auto_cutcell_mesh / slice_mesh / merge_meshes all manipulate the mesh, and add_obstacle vs shape_add_box vs add_wall vs add_floor vs place_furniture all create geometry. Convenience wrappers (add_sprinkler, add_heat_detector, add_device, add_prop) and dual undo tools (project_undo vs shape_undo) further blur boundaries, so an agent can easily misselect even though descriptions try to distinguish them.

    Naming Consistency4/5

    Names are overwhelmingly snake_case verb_noun with clear module prefixes (shape_, spr_, hvac_, evac_, draw_, arch_, result_, sim_, project_) and this convention holds across the whole set. Minor deviations exist: core model tools drop the prefix (add_obstacle, remove_vent, update_dump_config) while their cousins are prefixed, and a few names are noun-first (bulc_connection_status, get_conventions).

    Tool Count1/5

    249 tools is an extreme mismatch, far past the rubric's 50+ threshold and well beyond what an agent can reliably scan per session. Even though the server spans FDS modelling, shape studio, sprinkler, HVAC, evacuation, drawing import and results, the surface is so disaggregated that it should be split into several scoped servers.

    Completeness5/5

    Coverage is exhaustive: near-full CRUD for obstacles, vents, devices, materials, surfaces, meshes, sprinkler networks, HVAC, evacuation agents, outputs and simulation control, plus reading/preview/validation/results/knowledge and drawing-import paths. Almost no obvious dead ends remain across the many domains.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables LLMs to build, inspect, run, and analyze CFAST fire models step by step via tools for compartments, materials, vents, fires, devices, and surface connections, with simulation and result summaries.
      22
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to create, edit, and simulate EnergyPlus building energy models via natural language. Supports schema exploration, model editing, simulation execution, and documentation search.
      39
      237 PyPI
      14
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables AI agents to drive OpenFOAM end to end: cloning tutorials or custom cases, editing dictionaries, meshing and running solvers in the background, tracking convergence and job status, and analyzing results. It also renders flow images — slices, patches, streamlines, iso-surfaces and residual or force plots — back to the agent.
      25
      1
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables AI assistants to drive local photonic simulation software through its Python API, supporting modeling and layout, property setup, simulation runs, parameter sweeps, job management, and result analysis.
      20
      Apache 2.0