BIM Viewer MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Controls a live Autodesk Platform Services (APS) 3D BIM viewer for a mechanical (MECH) building model. Tools highlight elements and rooms, isolate a set, move the camera, and reset the view. Elements and rooms are addressed by their durable Revit UniqueId (the viewer's externalId), never by transient numeric ids. A plain highlight never moves the camera; only zoom_to changes the view.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| highlight_elementsA | Highlight a set of building elements in the 3D viewer, in place. The elements are colored where they stand; the camera does NOT move. Invalid or duplicate ids are dropped. Use this to show an answer visually; use zoom_to afterward only if the user asks to zoom. |
| highlight_roomsA | Draw translucent volumes for a set of rooms/spaces in the viewer. The room volumes are added in place; the camera does NOT move. Invalid or duplicate ids are dropped. |
| isolateA | Isolate a set of elements: show only them and hide the rest. A stronger focus than highlight_elements — everything outside the set is hidden. The camera does NOT move. Call reset to restore the full model. |
| zoom_toA | Move the camera to frame a room or a set of elements. This is the only tool that changes the view — use it only when the user asks to zoom in on something. Provide a room via space_external_id, or a set of elements via external_ids. A room takes precedence if both are given. To frame a room it must already be highlighted (highlight_rooms). |
| resetA | Reset the viewer to a clean state showing the whole building. Clears any element highlights, room volumes, and camera focus. Safe to call at any time; idempotent. Returns: {"applied": bool}. |
| find_elementsA | Find building elements by a cost criterion; return their externalIds. Use this to answer cost questions, then pass the returned external_ids to highlight_elements (to show them in place) or isolate. This tool does NOT change the view by itself. Examples: - Ten most expensive: metric='replacement_cost', op='top', limit=10 - Over $50,000: metric='replacement_cost', op='gt', value=50000 - Highest maintenance: metric='maintenance_cost', op='top', limit=5 Returns: {"metric": str, "count": int, "elements": [{external_id, asset_type, description, metric_value}]}. |
| find_by_categoryA | Find building elements by category; return their externalIds. Use this to answer category/level/room questions (e.g. "air terminals on Level 2", "the cooling tower", "the water-source heat pumps"), then pass the returned external_ids to highlight_elements (to show them in place) or isolate. This tool does NOT change the view by itself. Examples: - Air terminals on Level 2: category='air_terminals', level='Level 2' - The cooling tower: category='cooling_tower' - Heat pumps: category='heat_pumps' Returns: {"category": str, "count": int, "elements": [{external_id, asset_type, description, level_name, room_name}]}. |
| find_nearestA | Find the elements physically closest to a reference element. Use this to answer proximity questions (e.g. "what's the nearest transformer to this panel?", "which air terminals are closest to the cooling tower?"), then pass the returned external_ids to highlight_elements or zoom_to. This tool does NOT change the view by itself. Distance is the true 3D gap between bounding boxes in feet: 0 means the elements overlap or touch, and elements on different floors are correctly far apart. Examples: - Nearest transformer to a panel: reference_external_id=, category='transformers' - Five closest anything: reference_external_id=, limit=5 Returns: {"reference_external_id": str, "count": int, "elements": [{external_id, asset_type, description, level_name, distance_ft}]} ordered nearest first. |
| find_extremeA | Find the most-extreme element(s) by position or size. Use this to answer superlative questions (e.g. "the largest piece of equipment", "the northmost air handler", "the smallest transformer"), then pass the returned external_ids to highlight_elements or zoom_to. This tool does NOT change the view by itself. For largest/smallest, each element carries its volume_cuft. For compass directions the answer is simply which element is most extreme. Examples: - Largest equipment: op='largest' - Northmost air handler: op='northmost', category='air_handlers' - Three smallest fans: op='smallest', category='fans', limit=3 Returns: {"op": str, "count": int, "elements": [{external_id, asset_type, description, level_name, volume_cuft?}]} ranked most-extreme first. |
| find_in_roomA | Find the tracked assets that sit inside a room's 3D volume. Use this to answer room-contents questions (e.g. "what equipment is in room 54?", "the receptacles in the electrical room"), then pass the returned external_ids to highlight_elements or isolate. This tool does NOT change the view by itself. Membership is by true 3D containment: an asset's bounding-box center must fall inside the room footprint AND within its floor-to-ceiling band, so assets on other floors are correctly excluded. Examples: - Everything in room 54: room_number='54' - Just the receptacles: room_number='54', category='receptacles' Returns: {"room": {external_id, room_name, room_number, level_name}, "count": int, "elements": [{external_id, asset_type, description, level_name}]}. |
| find_clearanceA | Check an electrical panel's NEC 110.26 working clearance in 3D. Use this to answer "is the working space in front of this panel clear?"
The backend builds the code-required clearance zone(s) in true 3D and
reports whether anything intrudes. Pass the returned Target the panel either by external_id or by a description substring that must resolve to exactly one panel. If the description matches none or several, the result says so — ask the user to clarify. The check is directional (projected off the panel's working face) when
the panel is mounted on a wall or column, and an honest all-around
maintenance-access check when the panel is freestanding — the Example: - By id: external_id= - By name: description="circuit breaker switchboard" Returns:
{"external_id", "asset_type", "description", "mode", "rule",
"mounting_surface", "clearance": {"zones": [...]},
"intruders": [{external_id, asset_type, description}],
"clear": bool|None, "draw": {...}}. |
| find_workordersA | Count or cost-total maintenance work orders under fixed filters. Use this for work-order / maintenance questions, e.g. "how many work orders on Level 2", "open work orders", "high-priority work orders on the 1st floor that service the heat pumps", "how much have we spent on HVAC work orders". All filters are optional and combine with AND. Examples: - Work orders on Level 1: level='Level 1' - Open work orders: status='OPEN' - High-priority WSHP on Level 1: level='Level 1', asset_category='heat_pumps', priority='high' - HVAC maintenance spend: failure_class='HVAC', measure='cost' Returns (count): {"measure": "count", "filters": {...}, "count": int, "breakdown_by_status": {status: int}}. Returns (cost): {"measure": "cost", "filters": {...}, "count": int, "total_cost": float, "total_labor_hours": float, "avg_cost": float}. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| highlight_in_viewer | Start a request to find and highlight something in the 3D viewer. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| server_info | How to drive the BIM viewer through this server's tools. |
TDQS
Scored across 12 tools
Each tool has a clearly distinct role: highlight/isolate/zoom/reset are separate viewer actions, and the find_* tools split cleanly by criterion (cost, category, proximity, extreme, room containment, clearance, work orders). Descriptions repeatedly clarify when to use one over another, so an agent should not confuse them.
Most names follow a predictable snake_case verb-first pattern: highlight_elements, highlight_rooms, find_elements, find_by_category, find_nearest, etc. The only minor deviations are single-verb tools like isolate and reset, plus zoom_to, but the overall convention remains readable and consistent.
Twelve tools is well within a reasonable range for a BIM viewer assistant, and each tool appears to earn its place by covering a distinct query or viewer action. There is neither obvious bloat nor a suspiciously thin surface.
The surface covers the core BIM viewer workflow well: multiple discovery/query tools, visualization actions (highlight, isolate, zoom), reset, clearance checking, and work-order querying. Minor gaps exist, such as no obvious list_rooms/list_categories or get_element_details helper, but agents can largely work around them.