BULC MCP
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@BULC MCP run a fire simulation on the current project and show me the ASET results"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
BULC MCP
한국어
무엇인가
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 에서 여는 브리지에 요청을 전달하는 얇은 클라이언트입니다.
분야별로 할 수 있는 일
분야 | 대표 도구 | 흐름 |
프로젝트 |
| 연 프로젝트 읽기 → 편집 → 저장(덮어쓰기는 확인 뒤) |
건축 도면 → 건물 |
| 인식 → 질문 확인 → dryRun → 생성(되돌리기 1단계) |
화재·연기 해석 |
| 격자 → 화원(사용자 지시) → 경계 → 출력 → 점검 → 확인 → 실행 |
결과·ASET |
| 최대 HRR·감지 시각 → 출구별 ASET(1.8 m) |
피난·RSET |
| 배치 → 계단·경로 → 실행 → 출구별 통계·RSET |
HVAC 제연 |
| 덕트망 → 풍량 계산 → FDS 반영 |
스프링클러·물분무 |
| 도면 인식·자동 배치 → 수리계산 → 펌프·검토 → 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) 밖의 주소에는 연결하지 않습니다.
요구 사항
BULC 데스크톱 앱(라이선스 필요), 실행 중이어야 합니다. 0.90 이상을 권합니다(0.88 은 줄어든 도구 집합으로 동작). 설치 파일: Meteor-Simulation/bulc-releases. 브리지는 기본으로 켜져 있습니다(앱 환경 변수
BULC_BRIDGE=0이면 꺼짐).Node.js 20 이상
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-mcpCursor (~/.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 가 아닌 프로그램이 응답함", 앱과 내장 스냅샷의 도구 집합 차이를 알려 줍니다.
환경 변수
변수 | 기본값 | 설명 |
| — | 브리지 전체 주소(가장 우선), 예: |
| 앱과 같은 위치 | 발견 파일 경로를 바꿈. |
| — | 브리지 토큰(발견 파일 없이 |
|
| 발견 파일이 없을 때 쓰는 주소 |
|
|
|
| — |
|
| — | 숨길 도구(쉼표), 예: |
|
|
|
| — | 도구 설명 길이 상한(문자 수). 1,024자 제한이 있는 클라이언트는 |
|
| 앱 도구 호출 시간 제한(도면 분석·결과 읽기·열기 등 일부는 5분 이상) |
|
| 앱 연결 감시 간격( |
|
|
|
|
|
|
도구
이 서버의 로컬 도구 — 앱 없이도 동작하는 것은 ○ 로 표시했습니다.
도구 | 앱 없이 | 하는 일 |
| ○ | 브리지 주소와 찾은 경로, 연결 여부, BULC 식별, 도구 수, 스냅샷과의 차이 |
| ○ | 규칙 id·클래스·FDS 키·오류 번호·자유 낱말(한/영)로 지식 팩 검색 |
| ○ | 영역·심각도·클래스·도구별 규칙 목록 |
| ○ | 호출하려는 도구 순서를 규칙으로 점검(없는 도구·인자, 단위, XB 순서, HRR, 화원 지시, 바닥 개방, 재계산 누락, 헤드·단말 label, 도면 가져오기 dryRun, 실행 전 점검·확인, 피난 실행 순서 등) |
| ○ | 도면 파일을 로컬에서 분류하고 플레이북·질문·도구 순서를 돌려줌. DXF 평면은 벽 중심선 후보 추출(구버전 앱용) |
| ○ | FDS 6.10.1 덱 결정적 점검(파일·텍스트·앱의 현재 덱) |
| ○ | D* 와 셀 크기, 2·3·5 친화 IJK, 총 셀 수 |
| ○ | 키워드로 앱 도구와 입력 스키마 찾기 |
| (compact 프로필) 이름으로 앱 도구 호출 | |
| 앱 프로젝트 짧은 요약(0.90 이상은 | |
| 모든 앱 버전용 실행 가드 — |
앱 도구(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" 로 표시됩니다.
지식 팩
종류 | 위치 |
온톨로지 |
|
규칙 |
|
플레이북 |
|
용어집 |
|
FDS 6.10.1 키 |
|
도구 카드 |
|
라이브 |
|
prompts |
|
LLM 이 지식 팩을 쓰는 방식:
초기화 instructions — 연결하면 서버가 핵심 규칙 10개(단위, 읽고 쓰기, 도면, 화원 지시, 실행 전 점검·확인, 결과 보고)를 보냅니다.
도구 설명의 규칙 힌트 — 앱 도구마다 관련 규칙 id 가 붙어 있어(
[bulc-mcp rules] VENT-002 …) 모델이bulc_knowledge_search "<id>"로 원문을 찾습니다.계획 점검 — 여러 단계 작업 전에
bulc_plan_check가 도구 순서를 규칙으로 점검해 오류·경고와 따를 플레이북을 돌려줍니다(앱 없이 동작).오류 응답의 안내 — 앱이 인자를 거절하거나 없는 도구를 부르면 결과에 규칙 id 와 실제 도구 이름을 덧붙입니다.
prompts·resources — 작업별 prompt 가 플레이북 전문과 그 규칙을 한 번에 넣어 줍니다.
자세한 내용은 knowledge/README.md 를 보십시오.
도면으로 작업하기
도면을 PC 에 두고 절대 경로를 AI 에게 알려 줍니다(채팅 첨부 파일은 MCP 서버가 읽을 수 없습니다).
AI 가
bulc_drawing_intake로 분류하고, 단위·축척·기준점·층고·최종 출구를 묻습니다.건축 평면도:
arch_analyze_drawing이 벽·문·창·기둥·실명·층 표기를 인식하고 확인할 질문을 냅니다 →arch_import_building을 dryRun(기본)으로 개수·크기를 보여 주고 → 동의하면 건물을 만듭니다(되돌리기 1단계). 그림이나 글자가 윤곽선인 PDF 는 AI 가 그림을 읽어arch_import_floorplan_report로 넣습니다.스프링클러 평면·배관 ISO:
spr_analyze_drawing→ 열린 끝·참조선·모호한 항목 확인 →spr_import_network(먼저 dryRun) → 수리계산·펌프·검토.그 건물 위에서 화재(사용자가 정한 화원만), 피난, 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 가 아닌 프로그램이 응답합니다" | 다른 프로그램이 같은 포트를 씀 → 앱을 켜 두면 발견 파일로 찾음. 안 되면 앱을 빈 포트로 실행하고 |
"브리지 토큰이 필요합니다" | 앱이 |
앱을 켰는데 도구 목록이 그대로 | 클라이언트가 |
| 앱이 인자를 검증한 결과입니다. 문구가 제안하는 인자 이름으로 다시 호출 |
| 0.88 이하 앱입니다. 앱을 업데이트하거나 규칙의 대안(파일 메뉴, |
도구가 너무 많다는 오류 |
|
라이선스
이 서버의 코드와 지식 팩은 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_intakeclassifies 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 |
| read → edit → save (overwrite only after consent) |
Drawing → building |
| recognise → confirm → dry run → build (one undo step) |
Fire & smoke |
| mesh → fire (user-given) → boundaries → outputs → check → consent → run |
Results & ASET |
| peak HRR, detector times → ASET per exit at 1.8 m |
Evacuation & RSET |
| place → stairs/routes → run → per-exit statistics, RSET |
HVAC smoke control |
| network → airflow → FDS |
Sprinkler & water spray |
| 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
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=0in the app's environment turns it off).Node.js 20+
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 asstructuredContent.Resources:
bulc://knowledge/{index, ontology, ontology.jsonld, rules, glossary, fds-6.10.1/keys}, playbooks, templatesbulc://knowledge/rule/{id},…/rules/{domain},…/class/{name},…/fds-6.10.1/namelist/{group},bulc://tools/{name}, livebulc://project/summaryandbulc://project/deck, and the syntheticbulc://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_asetMore 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 snapshotLicense
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 toolsadd_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 drawingARead-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 buildingADestructive
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 reportADestructive
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 multimeshADestructive
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 deckARead-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 statusARead-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 intakeARead-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 toolsARead-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 rulesARead-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_knowledge_searchSearch BULC knowledgeARead-onlyIdempotent
Search the bundled BULC knowledge pack — modelling rules (condition → check → fix), common LLM mistakes, ontology classes (units, coordinates, which tool creates what), playbook steps, glossary (Korean ↔ English ↔ FDS keyword ↔ tool), FDS 6.10.1 key reference and FDS input errors. Pass a rule id (e.g. FIRE-001), a class (Mesh), an FDS key (MESH.IJK), an error (ERROR 314) or free text in Korean or English. Works without the app. 지식 팩 검색(규칙 id·키워드).
Inputs: query (required), kinds, limit, domain.
bulc_mesh_advisorMesh advisorARead-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 actingARead-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 viewARead-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 storiesBRead-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 storyCDestructive
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 paramsBIdempotent
Set default door dimensions [bulc-mcp rules] EVAC-001, GEO-002 — bulc_knowledge_search ""
Inputs: doorWidth, doorHeight.
draw_set_wall_paramsDraw set wall paramsBIdempotent
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 paramsBIdempotent
Set default window dimensions [bulc-mcp rules] EVAC-001, GEO-002 — bulc_knowledge_search ""
Inputs: windowWidth, windowHeight, windowSillHeight.
draw_update_storyDraw update storyBIdempotent
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 agentsBDestructive
Remove all evacuation agents [bulc-mcp rules] EVAC-001 — bulc_knowledge_search ""
Inputs: no named parameters.
evac_get_resultsEvac get resultsARead-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 summaryBRead-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 agentCDestructive
Remove an evacuation agent by ID [bulc-mcp rules] EVAC-001, EVAC-005 — bulc_knowledge_search ""
Inputs: id (required).
evac_remove_journeyEvac remove journeyCDestructive
Remove an evacuation journey by ID
Inputs: id (required).
evac_remove_stairEvac remove stairBDestructive
Remove a staircase by ID [bulc-mcp rules] EVAC-001 — bulc_knowledge_search ""
Inputs: id (required).
evac_remove_waypointEvac remove waypointCDestructive
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 statusBRead-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 stopADestructive
Stop the running evacuation simulation (confirm=true). No result is kept. Live app only.
Inputs: confirm (required).
evac_update_agentEvac update agentCIdempotent
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 journeyBIdempotent
Update an existing evacuation journey
Inputs: id (required), name, stages.
evac_update_setupEvac update setupBIdempotent
Update evacuation simulation settings (model, time, timestep)
Inputs: model, timeStep, simulationTime.
evac_update_stairEvac update stairCIdempotent
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 waypointCIdempotent
Update properties of an existing waypoint
Inputs: id (required), x, y, radius, +2 more.
fds_apply_textFds apply textADestructive
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 asetARead-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 summaryARead-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 timeseriesARead-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 summaryBRead-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 conventionsARead-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 infoARead-onlyIdempotent
Get detailed information about a specific furniture item (dimensions, fire data, fuel)
Inputs: furniture_id (required).
get_numericsGet numericsBRead-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 propertiesBRead-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 summaryARead-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 metricsARead-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 settingsARead-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 resultsARead-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 summaryARead-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 handlerCDestructive
Remove an air handler unit by ID
Inputs: id (required).
hvac_remove_ductHvac remove ductCDestructive
Remove a duct connection by ID
Inputs: id (required).
hvac_remove_exhaust_grilleHvac remove exhaust grilleCDestructive
Remove an exhaust grille by ID [bulc-mcp rules] HVAC-001 — bulc_knowledge_search ""
Inputs: id (required).
hvac_remove_nodeHvac remove nodeBDestructive
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 diffuserBDestructive
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 defaultsBIdempotent
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 handlerCIdempotent
Update properties of an existing air handler unit
Inputs: id (required), fanType, maxAirflowCFM, staticPressurePa.
hvac_update_ductHvac update ductBIdempotent
Update properties of an existing duct
Inputs: id (required), width, height, diameter, +2 more.
hvac_update_exhaust_grilleHvac update exhaust grilleAIdempotent
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 nodeBIdempotent
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 diffuserBIdempotent
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 bndfBRead-onlyIdempotent
List the animated boundary (BNDF) quantities written for solid surfaces.
Inputs: no named parameters.
list_devicesList devicesARead-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 catalogBRead-onlyIdempotent
List available furniture items. Filter by category or keyword search.
Inputs: keyword, category.
list_geomsList geomsARead-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 libraryBRead-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 meshesARead-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 obstaclesBRead-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 namelistsBRead-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 slcfARead-onlyIdempotent
List all slice (SLCF) outputs with id, quantity, plane, and flags.
Inputs: no named parameters.
list_surfacesList surfacesBRead-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 ventsBRead-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 meshesADestructive
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 slicesAIdempotent
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 fdsARead-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 fdsAIdempotent
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 infoARead-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 newADestructive
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 openADestructive
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 saveAIdempotent
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 bndfBDestructive
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 controlCDestructive
Remove a CTRL control by ID. [bulc-mcp rules] DEVC-004, DEVC-006 — bulc_knowledge_search ""
Inputs: id (required).
remove_deviceRemove deviceADestructive
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 fireBDestructive
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 geomBDestructive
Remove a &GEOM entry by ID (see list_geoms).
Inputs: id (required).
remove_holeRemove holeCDestructive
Remove a hole by ID. [bulc-mcp rules] EVAC-002, GEO-004 — bulc_knowledge_search ""
Inputs: id (required).
remove_materialRemove materialBDestructive
Remove a material by ID. [bulc-mcp rules] SURF-001 — bulc_knowledge_search ""
Inputs: id (required).
remove_obstacleRemove obstacleCDestructive
Remove an obstacle by ID. [bulc-mcp rules] GEN-003 — bulc_knowledge_search ""
Inputs: id (required).
remove_propRemove propADestructive
Remove a &PROP model by ID. Devices referencing it fall back to solver defaults.
Inputs: id (required).
remove_rampRemove rampCDestructive
Remove a ramp by ID.
Inputs: id (required).
remove_raw_namelistRemove raw namelistADestructive
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 slcfCDestructive
Remove a slice file output by ID.
Inputs: id (required).
remove_speciesRemove speciesCDestructive
Remove a tracked species by ID.
Inputs: id (required).
remove_surfaceRemove surfaceADestructive
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 ventBDestructive
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 probesBDestructive
Remove all graph probes.
Inputs: no named parameters.
result_get_stateResult get stateARead-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 detectBRead-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 datasetAIdempotent
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 colormapCIdempotent
Set the result colormap. name: 'turbo'|'jet'|'inferno'|'viridis'|'grayscale'.
Inputs: name (required), reversed.
result_set_legend_rangeResult set legend rangeBIdempotent
Set the result colorbar (legend) min/max range. Use null for auto.
Inputs: max, min.
result_set_particlesResult set particlesCIdempotent
Configure particle rendering in the result viewer.
Inputs: visible, pointSize, renderMode.
result_set_playback_speedResult set playback speedBIdempotent
Set result animation playback speed (1.0 = real-time).
Inputs: speed (required).
result_set_timeResult set timeBIdempotent
Set the result viewer playback time (seconds).
Inputs: time (required).
result_set_view_lockedResult set view lockedBIdempotent
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 openBIdempotent
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 ambientAIdempotent
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 chidAIdempotent
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 propertiesAIdempotent
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 meshAIdempotent
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 sizeAIdempotent
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 meshesADestructiveIdempotent
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 numericsAIdempotent
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 boundaryBIdempotent
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 outputsBIdempotent
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 optionsAIdempotent
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 modeCIdempotent
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 timeCIdempotent
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 modelBIdempotent
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 nodeBDestructive
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 propsBRead-onlyIdempotent
Item library: read the FDS properties and metadata of a registered item.
Inputs: item_id (required).
shape_get_treeShape get treeARead-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 screenshotARead-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 propsAIdempotent
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 paramsAIdempotent
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 tailARead-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 preflightARead-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 statusARead-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 stopADestructive
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 drawingARead-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 reviewARead-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 resultsARead-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 bundleADestructive
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 networkADestructive
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 summaryARead-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 sizingARead-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 nodeADestructive
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 pipeCDestructive
Remove a pipe connection by ID
Inputs: id (required).
spr_remove_sprinkler_headSpr remove sprinkler headBDestructive
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 sourceCDestructive
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 defaultsAIdempotent
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 sprayAIdempotent
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 nozzlesAIdempotent
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 pipesAIdempotent
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 valvesAIdempotent
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 nodeBIdempotent
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 pipeAIdempotent
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 headAIdempotent
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 sourceAIdempotent
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 controlBIdempotent
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 deviceBIdempotent
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 configCIdempotent
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 fireCIdempotent
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 holeCIdempotent
Update an existing hole by ID. [bulc-mcp rules] EVAC-002, GEN-003, GEO-004 — bulc_knowledge_search ""
Inputs: id (required), xb.
update_materialUpdate materialCIdempotent
Update a material by ID. [bulc-mcp rules] SURF-001 — bulc_knowledge_search ""
Inputs: id (required), density, emissivity, conductivity, +1 more.
update_obstacleUpdate obstacleCIdempotent
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 propBIdempotent
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 rampBIdempotent
Update an existing ramp with new points.
Inputs: id (required), points (required).
update_reactionUpdate reactionCIdempotent
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 slcfCIdempotent
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 surfaceAIdempotent
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 ventCIdempotent
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 projectARead-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
Scored across 249 tools
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.
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).
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.
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
Related MCP Connectors
Run FDS, OpenFOAM, CalculiX and other engineering simulations on cloudHPC from your AI assistant.
AI-callable calculators and engineering models with real formulas. No hallucinated math.
Structural FEM for AI agents: frames, plates, buckling, seismic and Eurocode checks, solved locally.
Conversational what-if simulation: build, diagnose and compare Petri-net models; CC0 catalog.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables 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.22MIT

idfkit-mcpofficial
AlicenseAqualityBmaintenanceEnables AI assistants to create, edit, and simulate EnergyPlus building energy models via natural language. Supports schema exploration, model editing, simulation execution, and documentation search.39237 PyPI14MIT- AlicenseBqualityBmaintenanceEnables 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.251MIT
- AlicenseBqualityCmaintenanceEnables 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.20Apache 2.0