Skip to main content
Glama
BIM Viewer MCP Server

BIM Viewer MCP Server

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

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

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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 draw block to the draw_clearance viewer command to show the zones (green clear, red intruded); this tool does NOT change the view by itself.

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 mode and rule fields say which, and the all-around mode is labeled as NEC-derived guidance rather than the literal front-only rule.

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": {...}}. clear is None when no rule is defined for the category.

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

NameDescription
highlight_in_viewerStart a request to find and highlight something in the 3D viewer.

Resources

Contextual data attached and managed by the client

NameDescription
server_infoHow to drive the BIM viewer through this server's tools.

TDQS

A4.2/5.0

Scored across 12 tools

Disambiguation5/5

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.

Naming Consistency4/5

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.

Tool Count5/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues