Revit MCP

NPM · @SHUOTAO/REVIT-MCP-SERVER · SCANNED AUG 7

MCP Server for Revit integration - AI-Powered Revit Control

Available components

+60 this week 65 65 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security98

No malware found by supply-chain analysis.Pass
No known CVEs affecting this package version or its production dependencies.Pass
No install/post-install scripts declared.Pass
30 of 99 dependencies flagged as unhealthy. View diagnostics → Partial

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 6 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability33

0% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Fail
AI-judged instruction clarity (good).Pass
Context-footprint check failed: tool/resource definitions use about 27175 tokens (~161/item across 168 items; 167 tools + 1 resources), over budget; trim descriptions and params. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management37

Stability observed for 11 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage98

98% of tools have a non-trivial description (not blank, and not just the tool's name).Partial
99% of tool parameters carry a description.Partial

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Supports UI / widget rendering.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @shuotao/revit-mcp-server

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add shuotao-revit-mcp-server -- npx -y @shuotao/revit-mcp-server

# add to Codex CLI

codex mcp add shuotao-revit-mcp-server -- npx -y @shuotao/revit-mcp-server

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "shuotao-revit-mcp-server": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@shuotao/revit-mcp-server"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add shuotao-revit-mcp-server --command npx --arg -y --arg @shuotao/revit-mcp-server

# ~/.hermes/config.yaml

mcp_servers:
  shuotao-revit-mcp-server:
    command: "npx"
    args: ["-y", "@shuotao/revit-mcp-server"]

// mcp.json

{
  "mcpServers": {
    "shuotao-revit-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@shuotao/revit-mcp-server"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

7 Aug 26 +4
- Known CVEs: partial → pass ▲ security
- Dependency health: partial → 0.87 functional
5 Aug 26 +2
- CVE-2026-69207 no longer affects this package ▲ security
- Known CVEs: fail → partial ▲ security
4 Aug 26 −1
- CVE-2026-69207 affects this package: medium ▼ security
- Known CVEs: partial → fail ▼ security
2 Aug 26 +43
- Provenance: unverified → fail ▼ security
- Known CVEs: unverified → partial ▲ security
- Install scripts: unverified → pass ▲ security
- Malware scan: unverified → pass ▲ security
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Stability: unverified → 0.20 ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Schema quality: unverified → good ▲ functional
- First check of Capabilities: pass functional
- Licence: MIT functional
1 Aug 26 +12
- Tool coverage: unverified → 98 ▲ functional
- Schema quality: unverified → 0 ▲ functional
31 Jul 26 −38
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
28 Jul 26 +19
- Tool coverage: unverified → 98 ▲ functional
- First check of Schema quality: unverified functional
- First check of Tool coverage: 99 functional
- First check of Schema quality: fail functional
- First check of Schema quality: fail functional
27 Jul 26 24

First indexed and scored.

Show 4 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 7 Aug 2026 · Analysed npm/@shuotao/[email protected]

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result	No attestation
Ecosystem	npm

Dependencies 99 packages

Packages resolved	99
Stale	30
Tree resolution	Complete

MCP tools · 167 exposed · ~27,168 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

add_pipe_cap 在管件的未連線端安裝管帽或法蘭 ~73

在管件的未連線端安裝管帽或法蘭。自動尋找開放的接頭並連接。

Input Output Examples

Name	Type	Req	Description
familyName	string	yes	要安裝的管帽/法蘭族群名稱
pipeId	number	yes	管件的元素 ID

No output schema declared.

No examples provided.

adjust_section_datums 自動調整剖面視圖的網格線 (Grids) 與樓層線 (Levels) 2D 範圍與氣泡顯示 ~79

自動調整剖面視圖的網格線 (Grids) 與樓層線 (Levels) 2D 範圍與氣泡顯示。

Input Output Examples

Name	Type	Req	Description
viewIds	array	yes	要調整的剖面視圖或剖面標記的 Element ID 列表

No output schema declared.

No examples provided.

align_titleblocks_on_sheets 批次將多個 sheet 上的 titleblock 移動到同一個 anchor 座標 ~380

批次將多個 sheet 上的 titleblock 移動到同一個 anchor 座標。可用『referenceSheetNumber』指定要拷貝某張 sheet 上 titleblock 的位置，或用『referencePositionMm』直接給絕對座標。anchor 決定要對齊 titleblock bbox 的哪個角（top-left / top-right / bottom-left / bottom-right / center）。建議先 dryRun=true 預覽 delta，確認後再實際執行。觸發條件：使用者提到 titleblock 對齊、圖框對齊、把所有 sheet 圖框對齊到 X、change_element_type 後圖框沒跟著移動、align titleblock、move titleblock to match。

Input Output Examples

Name	Type	Req	Description
anchor	string	yes	對齊 titleblock bbox 的哪個角（預設 top-left）
dryRun	boolean	–	若 true 則只計算不實際移動，回傳預期 delta 供確認
referencePositionMm	object	–	直接給絕對座標（公釐，sheet 座標）。不可與 referenceSheetNumber 同時使用
referenceSheetNumber	string	–	參考 sheet 編號，會抓取此 sheet 上 titleblock 在 anchor 位置的座標作為 ground truth。不可與 referencePositionMm 同時使用
targetSheetNumbers	array	–	要對齊的 sheet 編號清單。省略 = 全部 sheets（會跳過沒有 titleblock 的）
toleranceMm	number	–	若 delta 小於此公差（mm）則視為已對齊不移動，預設 0.1

No output schema declared.

No examples provided.

align_view_cropbox_to_element 將指定視圖的 CropBox 對齊到目標元素（如 Detail Group 圖框）的 BoundingBox ~136

將指定視圖的 CropBox 對齊到目標元素（如 Detail Group 圖框）的 BoundingBox。保留原 Z 軸深度與 CropBox Transform。viewId 不指定時使用 active view。

Input Output Examples

Name	Type	Req	Description
elementId	number	yes	要對齊的目標元素 ID（例如 Detail Group 的 ID）
padding_mm	number	–	向外擴大的邊距（公釐），預設 0
viewId	number	–	目標視圖 ID（選填）；不填則使用當前 active view

No output schema declared.

No examples provided.

analyze_beam_penetration 分析特定結構梁上的套管穿孔 ~258

分析特定結構梁上的套管穿孔。回傳精確的幾何數據，如距離柱心長度、梁深度、開孔直徑等。

Input Output Examples

Name	Type	Req	Description
beamId	number	yes	要分析的目標結構梁 Element ID
diameterParamNames	array	–	可選。搜尋套管『直徑』的動態參數名稱清單（實體與類型自動 Fallback）。預設為 ['開孔直徑', '直徑', '管徑', 'Diameter', 'Size']
lengthParamNames	array	–	可選。搜尋套管『長度』的動態參數名稱清單。預設為 ['長度', 'Length']
linkInstanceId	number	–	可選。連結模型的 ID
sleeveIds	array	–	可選。指定檢核的套管 ID 清單，避免全區掃描
widthParamNames	array	–	可選。搜尋梁『寬度』的動態參數名稱清單。預設為 ['b', '梁寬', 'Width']

No output schema declared.

No examples provided.

analyze_corridor_width 分析走廊寬度 ~109

分析走廊寬度。使用 Revit 端的房間邊界線段找出平行牆對，回傳實測寬度、最小寬度與各區段檢討結果。

Input Output Examples

Name	Type	Req	Description
minWidth	number	–	最小寬度門檻（mm）
roomId	number	–	房間 Element ID（選填）
roomName	string	–	房間名稱（選填）

No output schema declared.

No examples provided.

analyze_floor_slopes 分析樓板頂面排水坡度：以 Solid→PlanarFace 法向量與 Z 軸夾角計算每片朝上頂面的坡度百分比，回傳每片樓 ~149

分析樓板頂面排水坡度：以 Solid→PlanarFace 法向量與 Z 軸夾角計算每片朝上頂面的坡度百分比，回傳每片樓板的 Min/Max 坡度，並可回寫至指定參數（預設 Comments）。未指定 elementIds 時自動收集 Function=Exterior 的樓板。

Input Output Examples

Name	Type	Req	Description
elementIds	array	–	要分析的樓板 Element ID 陣列；省略則自動收集所有 Function=Exterior 樓板
paramName	string	–	坡度回寫的目標參數名稱，預設 Comments

No output schema declared.

No examples provided.

analyze_smoke_detectors 偵煙探測器設置分析：掃描當前視圖的探測器、空調出風口（FCU/冷風機）、房間，回傳各探測器的距出風口距離、距牆/樑距離、 ~188

偵煙探測器設置分析：掃描當前視圖的探測器、空調出風口（FCU/冷風機）、房間，回傳各探測器的距出風口距離、距牆/樑距離、距天花板距離，以及各房間的探測器數量與樑區格數。供 JS 端進行五項法規判定。

Input Output Examples

Name	Type	Req	Description
detectorKeywords	array	–	偵煙探測器族群名稱關鍵字（預設：偵煙、smoke detector、探測器、感知器）
outletKeywords	array	–	出風口族群名稱關鍵字（預設：FCU、冷風機、AHU、送風口、出風口、散流器）

No output schema declared.

No examples provided.

analyze_tall_partition_rooms Find rooms on target levels that share or contain TYPE parti ~306

Find rooms on target levels that share or contain TYPE partition walls taller than a threshold. Uses room boundary segment ElementIds so shared room-to-room walls are assigned to both rooms, and can add upward ray evidence from room bottom to floor underside.

Input Output Examples

Name	Type	Req	Description
autoDetectLevels	boolean	–	When true and levels is omitted, scan all placed-room levels and let tall TYPE walls identify candidates.
excludeRoomNameContains	array	–	Room name keywords to exclude. Defaults include shafts, stairs, and elevators.
includeDetails	boolean	–	Return wall-level and room-side details.
includeRoomRayHeight	boolean	–	Add ray-cast evidence from room bottom to the nearest floor underside above sampled points.
includeSingleRoomBoundaryWalls	boolean	–	Include tall TYPE walls that only appear on one target room boundary. Set false to keep only walls shared by two or more target rooms.
levels	array	–	Level names to scan. Defaults to B-1F and B-3F unless autoDetectLevels is true.
maxSearchDistanceMm	number	–	Maximum upward/downward floor search distance used by the ray helper.
minWallHeightMm	number	–	Minimum wall height in millimeters. Default is 6000.
sampleGrid	number	–	Room ray sample grid size, clamped to 1-7. Default 3.
wallTypeContains	string	–	Case-insensitive wall type name keyword for partition walls.

No output schema declared.

No examples provided.

apply_panel_pattern 將面板排列模式套用到帷幕牆 ~97

將面板排列模式套用到帷幕牆。需要類型映射表和排列矩陣。

Input Output Examples

Name	Type	Req	Description
elementId	number	yes	帷幕牆的 Element ID
matrix	array	yes	面板排列矩陣，由上到下、由左到右
typeMapping	object	yes	類型映射表（字母→面板類型 ID）

No output schema declared.

No examples provided.

arrange_viewports_on_sheet 依指定順序排列圖紙上的視埠（僅限 DraftingView） ~283

依指定順序排列圖紙上的視埠（僅限 DraftingView）。支援水平或垂直排列，邊緣對齊（edge-to-edge）。第一個視埠的位置作為錨點。可用 viewNames（view 名稱陣列）或 viewportIds（視埠 ID 陣列）指定順序，二擇一。

Input Output Examples

Name	Type	Req	Description
alignY	string	–	垂直對齊方式（水平排列時有效）：top / center（預設）/ bottom
direction	string	–	排列方向：horizontal（水平，預設）或 vertical（垂直）
gapMm	number	–	視埠之間的間距（mm），預設 0（邊緣對齊）
sheetId	number	–	圖紙的 Element ID（選填，不指定則使用當前作用圖紙）
viewNames	array	–	依排列順序的 view 名稱陣列（與 viewportIds 二擇一）。工具會在圖紙上查找對應的 DraftingView viewport。
viewportIds	array	–	依排列順序的視埠 ID 陣列（與 viewNames 二擇一）

No output schema declared.

No examples provided.

assign_existing_material 將既有材質（透過名稱查找）套用到指定的 Type ~117

將既有材質（透過名稱查找）套用到指定的 Type。不建立新材質。用於復原或批次指派既有材質（例如把 9 個柱子從 'White_MCP' 改回 '鋼 AISI 1015'）。

Input Output Examples

Name	Type	Req	Description
materialName	string	yes	既有材質名稱（必須已存在於專案中）
typeIds	array	yes	要套用材質的 Type Element ID 陣列

No output schema declared.

No examples provided.

auto_convert_rotated_viewport_patterns Automatically fix fill patterns on rotated viewports so hatc ~33

Automatically fix fill patterns on rotated viewports so hatch orientation follows the rotation correctly. Takes no parameters.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

auto_dimension_walls 批次自動標註牆段尺寸（不需要 Room） ~233

批次自動標註牆段尺寸（不需要 Room）。三種模式：overall_bbox（外圍兩條總長串：top 邊沿 X、right 邊沿 Y，預設）/ chained（同列同排共線牆串成 string dimension）/ per_wall（每牆一條長度標註）。標註用 DetailCurve 當 reference，不抓牆面，但建模一次性場景剛好。常用於 sketch-to-revit 蓋完牆後自動補尺寸。

Input Output Examples

Name	Type	Req	Description
mode	string	–	標註模式（預設 overall_bbox）
offsetMm	number	–	標註線偏移距離 (mm)，預設 1500
viewId	number	yes	目標平面視圖 ID（必須是 ViewPlan）
wallIds	array	–	要標註的牆 ElementId 列表（選填，預設為 view 範圍內所有牆）

No output schema declared.

No examples provided.

auto_renumber_sheets 自動掃描專案中所有帶有 -1 後綴的圖紙（例如 ARB-D0417-1），並將其合併至主序列中（變成 ARB-D0418 ~71

自動掃描專案中所有帶有 -1 後綴的圖紙（例如 ARB-D0417-1），並將其合併至主序列中（變成 ARB-D0418），後續編號會自動順延。

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

batch_apply_view_template 批次將指定的 ViewTemplate 套用到多個 views ~401

批次將指定的 ViewTemplate 套用到多個 views。支援透過圖紙（sheets）、view ID、view 名稱或名稱子字串來選取目標 views。可搭配 viewTypeFilter 篩選特定視圖類型。dryRun 模式可預覽變更內容而不實際修改。觸發條件：使用者提到批次修改 view template、套用視圖樣版、sheet 中的 view 改 template。

Input Output Examples

Name	Type	Req	Description
dryRun	boolean	–	設為 true 時僅預覽變更清單，不實際修改。預設 false
sheetIds	array	–	圖紙 ElementId 清單 — 套用到這些圖紙上所有 viewport 對應的 views
sheetNumbers	array	–	圖紙編號清單（如 ['A101', 'A102']）— 套用到這些圖紙上所有 viewport 對應的 views
skipIfSameTemplate	boolean	–	若 view 已使用相同 template 則跳過。預設 true
viewIds	array	–	目標 view ElementId 清單（精確指定）
viewNameContains	string	–	view 名稱包含此字串（substring match，case-insensitive）
viewNames	array	–	目標 view 名稱清單（精確匹配）
viewTemplateId	number	–	目標 ViewTemplate 的 ElementId（與 viewTemplateName 二擇一）
viewTemplateName	string	–	目標 ViewTemplate 的名稱（與 viewTemplateId 二擇一；精確匹配）
viewTypeFilter	array	–	限定 view type，例: ['FloorPlan', 'CeilingPlan', 'Section', 'Elevation', 'ThreeD']

No output schema declared.

No examples provided.

batch_create_rc_filled_region Batch-create RC filled-region stickers across multiple views ~85

Batch-create RC filled-region stickers across multiple views, or across every placed viewport on the given sheets.

Input Output Examples

Name	Type	Req	Description
filledRegionTypeName	string	–	Name of the FilledRegionType to use for the stickers.
sheetNumbers	array	–	Sheet numbers whose placed viewports will each be processed.
viewIds	array	–	Target view ElementIds to process.

No output schema declared.

No examples provided.

batch_create_wall_sections 批次建立牆面套管剖面：以當前視圖的 BoundingBox 範圍過濾指定連結模型中的牆，再比對所有 MEP 連結模型的管 ~438

批次建立牆面套管剖面：以當前視圖的 BoundingBox 範圍過濾指定連結模型中的牆，再比對所有 MEP 連結模型的管附件（圓形套管）與風管附件（矩形開口），只對有開孔的牆建立剖面視圖。

Input Output Examples

Name	Type	Req	Description
autoCrop	boolean	–	依開孔範圍自動裁剪剖面框，預設 true
directionLogic	string	–	剖面觀察方向，預設 auto（自動找房間側）
marginHorizontal	number	–	剖面左右留白（mm），預設 500
marginVertical	number	–	剖面上下留白（mm），預設 200
minWallLength	number	–	最短牆長過濾（mm），過短的牆略過，預設 500
scale	number	–	視圖比例尺，預設 50（1:50）
sequentialNaming	boolean	–	啟用流水號命名：依 sortOrder 排序後命名為 {prefix}-001、{prefix}-002…，預設 false（使用牆 ID 作為後綴）
sortOrder	string	–	流水號排序方式。x_then_y = 先左後右再由下往上；y_then_x = 先下後上再由左往右；creation = 依建立順序不重排。預設 x_then_y
splitLongWalls	boolean	–	相鄰開孔間距 > 3m 時自動分割為多個剖面，預設 true
viewNamePrefix	string	–	視圖名稱前綴，預設「牆面套管剖面」
wallLinkId	number	yes	牆所在的連結模型 LinkInstanceId（來自 get_linked_models）

No output schema declared.

No examples provided.

batch_set_material 批次修改指定 Type 的材質（複製原材質模式） ~344

批次修改指定 Type 的材質（複製原材質模式）。為每個 Type 的原材質建立複本 '{原名}_{suffix}'，只修改複本的 Appearance Asset（diffuse color），保留 Graphics 顏色與原材質其他屬性。影響 Enscape/V-Ray 等渲染引擎，但平面圖切割填充和 Revit Shaded 3D 維持原材質外觀。牆/樓板只修改 CompoundStructure 最外層（Layer 0），其他層保留。已含 suffix 的材質會被冪等跳過。

Input Output Examples

Name	Type	Req	Description
color	object	yes	目標 Appearance diffuse 顏色 RGB (0-255)
materialName	string	–	材質名稱 suffix（後綴）。例如 '護眼白_MCP' 會把原材質 '鋼 AISI 1015' 複製成 '鋼 AISI 1015_護眼白_MCP'。預設 'White_MCP'。
roughness	number	–	Appearance roughness（選填）。0.0=鏡面反射，1.0=完全啞光。若值 > 1 會被當成百分比（除以 100）。不設則維持原值。建議白模用 1.0 避免金屬感反光。
typeIds	array	yes	要修改材質的 Type Element ID 陣列（從 get_types_by_category 取得）

No output schema declared.

No examples provided.

batch_set_room_height 批次依房間名稱或用途分組，設定 Room 的 Upper Limit（ROOM_UPPER_LEVEL）與 Limit ~284

批次依房間名稱或用途分組，設定 Room 的 Upper Limit（ROOM_UPPER_LEVEL）與 Limit Offset（ROOM_UPPER_OFFSET）。不動樓層，只改 Room 參數。對 Model Group 內的 Room 會自動進入 EditGroup 模式（每個 GroupType 只編輯一次，變更同步到所有 instance），避免「modified outside group edit mode」警告。Transaction 內註冊 WarningSwallower 吞掉其他警告。單一 Transaction，可 Ctrl+Z 整批還原。

Input Output Examples

Name	Type	Req	Description
groups	array	yes	分組規則陣列。每個 group 指定一個房間名稱/用途關鍵字與目標高度(mm)。
levelName	string	–	選填：限制只修改某一樓層的 Room。留空則全專案。
matchField	string	–	比對欄位：'name' (ROOM_NAME) 或 'department' (ROOM_DEPARTMENT)。預設 'name'。
summaryOnly	boolean	–	true（預設）=只回計數與錯誤列表，避免 500+ Room 時 payload 爆炸；false=附帶每個 Room 的 OriginalValues 與 Modifications 明細（供 audit）。

No output schema declared.

No examples provided.

calculate_exterior_wall_scaffold_perimeter Reliable scaffold takeoff mode ~438

Reliable scaffold takeoff mode. Automatically detects exterior/perimeter walls from wall centerline geometry using ray exposure tests, excludes interior walls, sums the included wall lengths, optionally selects the result in Revit, and reports the classification evidence.

Input Output Examples

Name	Type	Req	Description
activeViewOnly	boolean	–	Only analyze walls visible in the active view.
bridgeEndpointToleranceMm	number	–	Endpoint/network tolerance for perimeter bridge wall recovery.
endpointToleranceMm	number	–	Tolerance used only for reporting connected exterior wall groups.
includeCurtainWalls	boolean	–	Include curtain walls in the exterior perimeter calculation.
includeExcludedWalls	boolean	–	Return every excluded wall instead of only the highest-scoring sample.
includePerimeterBridgeWalls	boolean	–	Add short exterior or retaining walls whose endpoints reconnect to the detected exterior wall network. This catches perimeter walls hidden by adjacent walls in ray tests.
levelName	string	–	Optional Revit level name. When omitted, the active view filter is used if activeViewOnly is true.
maxBridgeWallLengthMm	number	–	Maximum wall length eligible for perimeter bridge recovery.
minWallHeightMm	number	–	Ignore walls whose effective height is below this value. Effective height uses unconnected height first, then top/base constraints, then bounding box height.
minWallLengthMm	number	–	Ignore very short walls below this length.
minimumExposedRatio	number	–	Minimum ratio of open-side samples required to classify a wall as exterior.
rayAngleDegrees	number	–	Fan angle on both sides of each wall normal for finding blocking walls.
sampleCount	number	–	Number of sample stations tested on each wall. Valid range is clamped to 3-9.
scaffoldHeightMm	number	–	Optional scaffold height. When provided, the tool also returns perimeter x height area in square meters.
searchDepthMm	number	–	Optional ray search depth. Defaults to twice the analyzed wall bounding diagonal.
selectResult	boolean	–	Select detected exterior walls in Revit after calculation so the user can review the result.

No output schema declared.

No examples provided.

calculate_grid_bounds 計算給定 X 與 Y 網格範圍的邊界 BoundingBox 座標 ~120

計算給定 X 與 Y 網格範圍的邊界 BoundingBox 座標。可指定外擴偏移量 (offset_mm)。

Input Output Examples

Name	Type	Req	Description
offset_mm	number	–	邊界向外偏移距離 (公釐)，預設 0
xGrids	array	–	X 軸網格名稱清單 (例如 ['B23', 'B27'])
yGrids	array	–	Y 軸網格名稱清單 (例如 ['BE'])

No output schema declared.

No examples provided.

calculate_room_scaffold_perimeters Indoor scaffold takeoff mode ~316

Indoor scaffold takeoff mode. Reads placed Revit Rooms and classifies them into general scaffold, interior finish scaffold, or excluded rooms. General scaffold for non-stair/elevator rooms is measured by perimeter x height. Interior finish scaffold for stair/elevator rooms is measured by length x width x height.

Input Output Examples

Name	Type	Req	Description
excludeKeywords	array	–	Room name/number keywords excluded from general scaffold. Defaults include outdoor platforms, terraces, balconies, pipe shafts, and water tanks.
excludeLevels	array	–	Level suffixes/names excluded from the room scaffold takeoff. Defaults to FN and TF.
finishKeywords	array	–	Room name/number keywords classified as interior finish scaffold. Defaults include safety stairs, accessible stairs, stairs, elevators, freight elevators, lifts, and passenger elevators.
includeRoomDetails	boolean	–	Return per-room audit rows.
includeUnnamed	boolean	–	Whether unnamed placed rooms should be included.
level	string	–	Optional level name or unambiguous partial level name. When omitted, all placed rooms are considered.
levelName	string	–	Alias of level.
minBoundarySegmentLengthMm	number	–	Ignore tiny room boundary fragments shorter than this length.
roomIds	array	–	Optional explicit Room ElementId list. Overrides level filtering.
scaffoldHeightMm	number	–	Optional scaffold height. For interior finish scaffold, this is the height used in length x width x height. If omitted, the tool attempts to use room bounding-box height.

No output schema declared.

No examples provided.

calculate_selected_detail_line_perimeter Fast scaffold takeoff mode ~132

Fast scaffold takeoff mode. Sum curve lengths from the current Revit selection, including detail lines, detail component family geometry, and filled region boundaries. Use this when the user manually traces the scaffold outline.

Input Output Examples

Name	Type	Req	Description
includeFamilyGeometry	boolean	–	Read measurable curve geometry from selected detail component family instances.
includeFilledRegions	boolean	–	Include selected filled region boundary curves.
minCurveLengthMm	number	–	Ignore tiny curve fragments shorter than this length.
scaffoldHeightMm	number	–	Optional scaffold height. When provided, the tool also returns perimeter x height area in square meters.

No output schema declared.

No examples provided.

change_element_type 變更 Revit 元素的類型（例如將牆從 Type A 改為 Type B） ~81

變更 Revit 元素的類型（例如將牆從 Type A 改為 Type B）。

Input Output Examples

Name	Type	Req	Description
elementId	number	–	元素 ID
elementIds	array	–	元素 ID 列表（用於批量變更）
typeId	number	yes	目標類型的 Element ID

No output schema declared.

No examples provided.

check_exterior_wall_openings 依據台灣建築技術規則第45條及第110條檢討外牆開口 ~139

依據台灣建築技術規則第45條及第110條檢討外牆開口。自動讀取地界線計算距離，以顏色標示違規。

Input Output Examples

Name	Type	Req	Description
checkArticle110	boolean	–	檢查第110條
checkArticle45	boolean	–	檢查第45條
colorizeViolations	boolean	–	以顏色標示
exportReport	boolean	–	匯出 JSON 報表
reportPath	string	–	報表輸出路徑

No output schema declared.

No examples provided.

check_floor_effective_openings 無開口樓層判定：檢查樓層外牆有效開口面積是否 ≥ 樓地板面積 1/30 ~87

無開口樓層判定：檢查樓層外牆有效開口面積是否 ≥ 樓地板面積 1/30。法源：消防§4 + §28③。

Input Output Examples

Name	Type	Req	Description
colorize	boolean	–	是否自動上色開口
levelName	string	yes	樓層名稱

No output schema declared.

No examples provided.

check_sanitary_fixture_requirements Calculate sanitary fixture requirements by detecting the bui ~343

Calculate sanitary fixture requirements by detecting the building type and applying the matching rule. This rule package currently supports C-1 factory/warehouse only; future building types should be added as separate rules. Output maps to the code table columns: building type, water closets, urinals, lavatories, and bathtubs/showers. Net area excludes stairs, elevators, air-raid shelter/refuge rooms, and parking spaces. This tool does not create or write Revit parameters.

Input Output Examples

Name	Type	Req	Description
areaPerPersonM2	number	–	Occupancy density in square meters per person.
buildingType	string	–	Optional building type / occupancy group hint, such as C-1, C-1 factory, factory, or warehouse. If omitted, the tool detects from level/view/project/room context and defaults to C-1 because this pack…
excludeKeywords	array	–	Optional extra Room name/number keywords to exclude from occupancy area in addition to stairs, elevators, refuge/shelter, and parking defaults.
femaleRatio	number	–	Female side of male:female ratio. Default 1.
level	string	–	Optional level name. If omitted, roomIds or all placed rooms matching filters are used.
maleRatio	number	–	Male side of male:female ratio. Default 1.
roomIds	array	–	Optional explicit Room ElementId list. Overrides level/name/number filters.
roomNameContains	string	–	Optional Room name filter, useful for factory/building scopes such as C-1.
roomNumberContains	string	–	Optional Room number filter.

No output schema declared.

No examples provided.

check_smoke_exhaust_windows 排煙窗檢討：檢查天花板下 80cm 內可開啟窗面積是否 ≥ 區劃面積 2% ~171

排煙窗檢討：檢查天花板下 80cm 內可開啟窗面積是否 ≥ 區劃面積 2%。同時判定無窗居室。法源：建技規§101① + 消防§188。自動上色：綠=全開、黃=折減、紅=固定。

Input Output Examples

Name	Type	Req	Description
ceilingHeightSource	string	–	天花板高度來源
colorize	boolean	–	是否自動上色窗戶
excludeKeywords	array	–	非居室排除關鍵字
levelName	string	yes	樓層名稱
smokeZoneHeight	number	–	有效帶高度（mm），預設 800

No output schema declared.

No examples provided.

check_stair_headroom 檢查樓梯淨高是否符合法規要求（190cm + 裝修厚度） ~95

檢查樓梯淨高是否符合法規要求（190cm + 裝修厚度）

Input Output Examples

Name	Type	Req	Description
finishThicknessCm	number	–	裝修面厚度 (cm，預設 0)
headroomLimitCm	number	–	法規最低淨高需求 (cm，預設 190)
stairId	number	yes	樓梯的 Element ID

No output schema declared.

No examples provided.

clear_element_override 清除元素在指定視圖中的圖形覆寫 ~62

清除元素在指定視圖中的圖形覆寫。

Input Output Examples

Name	Type	Req	Description
elementId	number	–	要清除覆寫的元素 ID
elementIds	array	–	批次操作
viewId	number	–	視圖 ID

No output schema declared.

No examples provided.

colorize_clashes 將 detect_clashes 的結果視覺化上色到 CSA 元素 ~147

將 detect_clashes 的結果視覺化上色到 CSA 元素。colorScheme 可選 by_csa_category（柱紅/樑橘/板黃/牆藍）、by_system（依 MEP 系統）、by_severity（依貫穿深度嚴重度）。

Input Output Examples

Name	Type	Req	Description
clashData	object	yes	detect_clashes 的完整回傳物件（含 Clashes 陣列）
colorScheme	string	–	配色方案：by_csa_category / by_system / by_severity
viewId	number	–	目標視圖 ID；省略則使用當前 active view

No output schema declared.

No examples provided.

convert_drafting_to_model_pattern Convert drafting fill patterns to model fill patterns in the ~40

Convert drafting fill patterns to model fill patterns in the document so hatching stays fixed to the model rather than the sheet. Takes no parameters.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

copy_detail_items_to_views 批次複製詳圖項目（DetailCurve、TextNote、FilledRegion、DetailComponent、D ~521

批次複製詳圖項目（DetailCurve、TextNote、FilledRegion、DetailComponent、Dimension）從來源視圖到一或多個目標視圖（同一專案內）。支援 DraftingView 與 model view。

Input Output Examples

Name	Type	Req	Description
dryRun	boolean	–	若 true 則只回傳要複製的元素統計，不實際複製。
elementCategories	array	–	要複製的詳圖項目類別，預設 ["All"]。可指定子集如 ["DetailCurves", "Dimensions"]。Dimensions 包含 Linear/Aligned/Radial/Angular/ArcLength/SpotElevation 等所有尺寸標註類型。
fallbackToIndividual	boolean	–	true=當批次複製失敗時，自動 fallback 為逐個元素重試，記錄哪些成功哪些失敗（強烈推薦）；false=批次失敗則整批 rollback，回傳 Failed 狀態。Dimension 跨 view 複製常因 host element 引用遺失導致整批 fail，這個參數能自動繞過問題元素只保留可複製的部分。回傳結構新增 Mode（Batch/Individual）、FailedCoun…
offset	object	–	複製後的位置偏移（公釐）。預設 {x:0, y:0} 即原位置。
preserveGroups	boolean	–	true=收集到的 group 成員會被替換成整個 group instance 一起複製，保留 detail group/model group 結構（推薦）；false=group 成員以個別元素複製，丟失 group 結構（舊行為）。注意：preserveGroups=true 時，若 group 內含其他類別的成員（不在 elementCategories 過濾範圍內），那些成員仍會隨…
sourceElementIds	array	–	指定要複製的元素 ID 清單（選填）。省略則複製來源視圖中符合 elementCategories 的所有詳圖項目。
sourceViewId	number	yes	來源視圖的 Element ID
targetViewIds	array	yes	目標視圖的 Element ID 陣列

No output schema declared.

No examples provided.

copy_sheets_from_file 從來源 .rvt 檔案複製圖紙到目前開啟的專案 ~456

從來源 .rvt 檔案複製圖紙到目前開啟的專案。讀取來源的 sheet/viewport/view metadata，在目標專案中重建 sheets、匹配或建立 views、放置 viewports 並同步設定。View 依四級分類處理：Tier 1（FloorPlan/CeilingPlan）可自動建立；Tier 2（Section/3D/DraftingView）可部分建立；Tier 3（Legend/Schedule）只匹配不建立；Tier 4（Elevation/Callout/AreaPlan）回報 manual_action_required。衝突項目必須在 conflictResolution 中指定處理方式。

Input Output Examples

Name	Type	Req	Description
closeAfterCopy	boolean	–	完成後是否關閉來源檔案。預設 true。
conflictResolution	object	–	衝突解決設定。當 read_source_file_sheets 偵測到衝突時必須提供。
copyDraftingContents	boolean	–	是否複製 DraftingView 的內容（detail lines, text notes 等）。預設 true。
copySheetCustomParameters	boolean	–	是否複製 sheet 上的 custom parameters（如 sheet folder/圖集、Discipline、繪圖人、Issue Date 等）。同名 + 同 StorageType 的 writable parameter 會被複製，ElementId 類型跳過（跨文件 ID 不可移植）。預設 true。
sheetNumbers	array	–	要複製的圖紙編號清單。省略則複製全部 sheets。
sourceFilePath	string	yes	來源 .rvt 檔案的絕對路徑
syncProperties	object	–	控制同步哪些 view 屬性到目標。全部預設 true。
viewMatchStrategy	string	–	view 匹配策略。match_only: 只使用目標檔已存在的同名 view；match_or_create: 優先匹配，找不到時建立新 view（僅 Tier 1-2）。預設 match_or_create。

No output schema declared.

No examples provided.

create_beams_from_dwg 從 CAD 指定圖層建立 Revit 結構樑（必須搭配文字標注圖層） ~455

從 CAD 指定圖層建立 Revit 結構樑（必須搭配文字標注圖層）。重要：建議按類型分批執行（先大樑、再次樑、再地樑），每批只處理一個線條圖層與對應的文字圖層。使用 beamRole 參數標示目前處理的批次。

Input Output Examples

Name	Type	Req	Description
beamRole	string	–	（選填）標示此批次處理的樑角色，例如「大樑」、「次樑」、「地樑」。除回報顯示外，也用於設定樑的結構用途：大樑／地樑→大樑(Girder)、次樑→格柵樑(Joist)。
familyName	string	yes	指定使用的族群名稱（必填），例如「2_RC樑-矩形」。
layerName	string	yes	CAD 樑輪廓線條的圖層名稱（必填）
textLayerNameX	string	–	（名稱對應模式必填其一）CAD 圖面上 X 軸向標注樑名稱（例如水平向的 B1）的文字圖層。文字僅會與 X 軸向的中心線進行配對，避免干擾。
textLayerNameY	string	–	（名稱對應模式必填其一）CAD 圖面上 Y 軸向標注樑名稱（例如垂直向的 B1）的文字圖層。文字僅會與 Y 軸向的中心線進行配對，避免干擾。
typeName	string	–	（選填）指定族群類型名稱（例如「60x80」）。有填此參數時為「快速模式」，該批次所有樑都用這個型別建立，忽略文字圖層。沒填時為「名稱對應模式」，依文字標注比對類型。

No output schema declared.

No examples provided.

create_column 在指定位置建立柱子 ~94

在指定位置建立柱子。

Input Output Examples

Name	Type	Req	Description
bottomLevel	string	–	底部樓層名稱
columnType	string	–	柱類型名稱（選填）
topLevel	string	–	頂部樓層名稱（選填）
x	number	yes	X 座標（公釐）
y	number	yes	Y 座標（公釐）

No output schema declared.

No examples provided.

create_columns_from_dwg 從 CAD 指定圖層自動建立 Revit 結構柱或建築柱 ~473

從 CAD 指定圖層自動建立 Revit 結構柱或建築柱。會自動：辨識矩形輪廓、建立對應尺寸的族群類型、設定底頂樓層、套用旋轉角度。若指定 familyName，會從該族群的現有類型中依尺寸比對，直接使用原有柱名稱（如 C1、C2）；未指定時自動挑選最適族群並按尺寸建立新類型。執行前建議先呼叫 preview_dwg_columns 確認識別結果。此操作會修改 Revit 模型，無法自動復原，請謹慎使用。

Input Output Examples

Name	Type	Req	Description
columnType	string	–	柱類型：'structural'（結構柱，OST_StructuralColumns）或 'architectural'（建築柱，OST_Columns）。預設為 structural
familyName	string	–	（選填）指定使用的族群名稱，例如「B1_RC柱-矩形」。指定後會從該族群現有類型中依尺寸比對，保留 C1/C2/C3 等原有柱名稱；尺寸無對應時才建立新類型。不指定則自動挑選最適族群。
layerName	string	yes	CAD 圖層名稱，請從 get_dwg_column_layers 回傳的清單中選擇
textLayerName	string	–	（選填）CAD 圖面上標注柱名稱（C1、C2 等）文字所在的圖層名稱。指定後會讀取該圖層的 TEXT/MTEXT 文字，依空間距離將最近的標注對應到每根柱，再以標注文字（如 C1）在 familyName 族群中尋找對應類型。DXF 格式可直接讀取；DWG 格式需安裝 ODA File Converter，未安裝時會回傳 labelReadStatus=no_oda 並附上安裝說明，柱仍會建立但…

No output schema declared.

No examples provided.

create_corridor_dimension 走廊寬度標註 — 自動偵測房間邊界的平行牆對，建立精確的牆到牆尺寸標註 ~106

走廊寬度標註 — 自動偵測房間邊界的平行牆對，建立精確的牆到牆尺寸標註。回傳每個區段的實測寬度與合規判定。

Input Output Examples

Name	Type	Req	Description
roomId	number	yes	走廊房間的 Element ID
viewId	number	yes	要建立標註的平面視圖 ID

No output schema declared.

No examples provided.

create_curtain_panel_type 建立新的帷幕牆面板類型，可指定顏色（HEX）和透明度 ~90

建立新的帷幕牆面板類型，可指定顏色（HEX）和透明度。

Input Output Examples

Name	Type	Req	Description
baseTypeId	number	–	基礎類型 ID（選填）
color	string	yes	面板顏色（HEX 格式，如 '#5C4033'）
typeName	string	yes	新類型的名稱

No output schema declared.

No examples provided.

create_curtain_wall_elevations 批次建立每一道帷幕牆的永久外立面視圖，建立/套用名為「帷幕立面」的視圖樣板，保留 crop box 與 far clip ~484

批次建立每一道帷幕牆的永久外立面視圖，建立/套用名為「帷幕立面」的視圖樣板，保留 crop box 與 far clip depth 可由各視圖自行控制，並回傳方向與 crop 診斷欄位。這個工具建立的是持久成果，不需要 cleanup；除非使用者明確要求清理，AI client 不得呼叫 delete_element 刪除這些 generated views。

Input Output Examples

Name	Type	Req	Description
applyViewTemplate	boolean	–	是否建立/套用視圖樣板，預設 true。
depthMm	number	–	自動深度計算失敗時的 fallback 遠剪裁深度，單位 mm，預設 1200；正常情況會剛好包住帷幕牆所有相關元素，遠端剪裁模式固定為剪裁含線。
dryRun	boolean	–	只回報將建立的視圖，不修改模型，預設 false。
horizontalMarginMm	number	–	crop 左右餘裕，單位 mm，預設 0；剪裁範圍依 elevation view 內目標帷幕元素的 2D 可視範圍計算。
nameSeparator	string	–	樓層與標記之間的分隔字串，預設空字串。
offsetMm	number	–	marker 放在牆外側的距離，單位 mm，預設 1500。
placementViewId	number	–	放置 ElevationMarker 的 ViewPlan ElementId；優先於 placementViewName。
placementViewName	string	–	放置 ElevationMarker 的 ViewPlan 名稱。
scale	number	–	立面視圖比例，預設 50。
verticalMarginMm	number	–	crop 上下餘裕，單位 mm，預設 0；剪裁範圍依 elevation view 內目標帷幕元素的 2D 可視範圍計算。
viewTemplateName	string	–	視圖樣板名稱，預設「帷幕立面」。

No output schema declared.

No examples provided.

create_dependent_views 依據指定的母視圖 ID 與 BoundingBox 邊界，批次建立並裁切從屬視圖 (Dependent View) ~124

依據指定的母視圖 ID 與 BoundingBox 邊界，批次建立並裁切從屬視圖 (Dependent View)。

Input Output Examples

Name	Type	Req	Description
max	object	yes	裁切框最大座標點
min	object	yes	裁切框最小座標點
parentViewIds	array	yes	母視圖的 Element ID 清單
suffixName	string	–	視圖命名後綴 (例如 '-1')。若不指定則自動編號流水號。

No output schema declared.

No examples provided.

create_detail_component_type 指定詳圖項目族群，複製並設定新名稱（圖紙編號-圖紙名稱-詳圖名稱），同時自動填寫詳圖圖號、圖說名稱、詳圖名稱、詳圖編號 ~171

指定詳圖項目族群，複製並設定新名稱（圖紙編號-圖紙名稱-詳圖名稱），同時自動填寫詳圖圖號、圖說名稱、詳圖名稱、詳圖編號等類型參數。

Input Output Examples

Name	Type	Req	Description
detailName	string	yes	詳圖名稱（使用者輸入的新詳圖名稱）
detailNumber	string	–	詳圖編號（選填，預設為 '1'）
familyName	string	–	要複製的基礎詳圖項目族群名稱（選填，若未提供則預設尋找 'AE-圖號'）
sheetNumber	string	yes	目標圖紙編號（如 A101）

No output schema declared.

No examples provided.

create_detail_lines 在視圖上繪製詳圖線（天花板線、有效帶範圍線等），可指定顏色和標籤 ~73

在視圖上繪製詳圖線（天花板線、有效帶範圍線等），可指定顏色和標籤。

Input Output Examples

Name	Type	Req	Description
lines	array	yes	線段陣列
viewId	number	yes	目標視圖的 Element ID

No output schema declared.

No examples provided.

create_dimension 在指定視圖中建立尺寸標註 ~130

在指定視圖中建立尺寸標註。

Input Output Examples

Name	Type	Req	Description
endX	number	yes	終點 X 座標（公釐）
endY	number	yes	終點 Y 座標（公釐）
offset	number	–	標註線偏移距離（公釐）
startX	number	yes	起點 X 座標（公釐）
startY	number	yes	起點 Y 座標（公釐）
viewId	number	yes	要建立標註的視圖 ID

No output schema declared.

No examples provided.

create_dimension_by_bounding_box 使用房間邊界框自動標註房間淨尺寸（保證100%覆蓋率） ~106

使用房間邊界框自動標註房間淨尺寸（保證100%覆蓋率）

Input Output Examples

Name	Type	Req	Description
axis	string	yes	標註軸向：'X' 或 'Y'
offset	number	–	標註線偏移距離 (mm)，默認 500
roomId	number	yes	房間 ID
viewId	number	yes	視圖 ID

No output schema declared.

No examples provided.

create_dimension_by_ray 使用射線偵測 (Ray-Casting) 建立尺寸標註 ~124

使用射線偵測 (Ray-Casting) 建立尺寸標註。從指定原點向正反方向發射射線，偵測牆面並建立標註。

Input Output Examples

Name	Type	Req	Description
counterDirection	object	–	反向射線方向向量 (若未提供則自動取反)
direction	object	yes	正向射線方向向量
origin	object	yes	射線原點 (通常為房間中心)
viewId	number	yes	目標視圖 ID

No output schema declared.

No examples provided.

create_door 在指定的牆上建立門 ~154

在指定的牆上建立門。可指定 sourceElementId 來複製現有門的類型、instance 參數與 facing/hand 朝向。

Input Output Examples

Name	Type	Req	Description
doorType	string	–	門類型名稱（選填）
locationX	number	yes	門在牆上的位置 X 座標（公釐）
locationY	number	yes	門在牆上的位置 Y 座標（公釐）
sourceElementId	number	–	來源門 ID（選填，用於複製其類型、參數與朝向）
wallId	number	yes	要放置門的牆 ID

No output schema declared.

No examples provided.

create_facade_from_analysis 根據分析結果批��建立整面立面 ~82

根據分析結果批次建立整面立面。在牆面前方批次建立多片 DirectShape 面板，支援多種面板類型和排列模式。

Input Output Examples

Name	Type	Req	Description
facadeLayers	object	yes	立面層級定義
wallId	number	–	目標牆的 Element ID

No output schema declared.

No examples provided.

create_facade_panel 建立單片立面面板（DirectShape） ~400

建立單片立面面板（DirectShape）。支援 5 種幾何：curved_panel、beveled_opening、angled_panel、rounded_opening、flat_panel。

Input Output Examples

Name	Type	Req	Description
bevelDepth	number	–	[beveled_opening] 斜切深度（mm）
bevelDirection	string	–	[beveled_opening] 斜切方向
color	string	–	顏色（HEX）
cornerRadius	number	–	[rounded_opening] 圓角半徑（mm）
curveType	string	–	[curved_panel] 曲線類型
depth	number	–	弧深/凹入深度（mm），預設 150
geometryType	string	–	幾何類型
height	number	–	高度（mm），預設 3400
name	string	–	面板名稱
offset	number	–	距牆偏移（mm），預設 200
openingHeight	number	–	[opening] 開口高度（mm）
openingShape	string	–	[rounded_opening] 開口形狀
openingWidth	number	–	[opening] 開口寬度（mm）
positionAlongWall	number	–	沿牆位置（mm）
positionZ	number	–	底部 Z 高度（mm）
thickness	number	–	板厚（mm），預設 30
tiltAngle	number	–	[angled_panel] 傾斜角度（度）
tiltAxis	string	–	[angled_panel] 傾斜軸
wallId	number	–	參考牆的 Element ID
width	number	–	寬度（mm），預設 800

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 7 Aug

Day	Score
27 Jul	24
28 Jul	43
30 Jul	43
31 Jul	5
1 Aug	17
2 Aug	60
3 Aug	60
4 Aug	59
5 Aug	61
6 Aug	61
7 Aug	65