Load an IFC file from the given path. Returns model_id for subsequent queries.

List all IFC models currently loaded in memory.

Unload an IFC model from memory to free resources.

Get the full spatial hierarchy: Project > Site > Building > Storey > Space.

Get the spatial containment chain for an element (Space > Storey > Building > Site).

Get elements of a given IFC type (e.g. IfcWall, IfcDoor). Supports pagination via limit/offset.

Get full details for a single element by its GlobalId.

Search elements with optional filters: IFC type, name substring, pset_name (must own this pset), property_name/property_value (property within that pset or any pset). Supports pagination via limit/offset.

Get all property sets (Psets) for an element as {pset_name: {prop_name: value}}.

Get all quantity sets for an element as {qset_name: {quantity_name: value}}.

Get material information for an element. Returns {name, layers, category} — layers is a list of {name, thickness} for layered assemblies, or None for simple materials.

Get element counts by IFC type, storey names, schema version, and total count.

Get the bounding box (min/max XYZ and dimensions) of an element in project coordinates.

Get the world-space placement of an element: insertion point (XYZ) and orientation axes (X/Y/Z unit vectors). Useful for position, rotation, and aim direction of elements like luminaires.

Get the local-space bounding box of an element (no world transform applied). Returns min/max XYZ and dimensions in the element's own coordinate system. Use for mounting axis prediction and recessed fixture detection.

Get the body mapping matrix for an element with IfcMappedItem geometry. Returns: has_mapped_item, body_mapping_matrix (4x4), world_transform (OPM × body mapping), world_transform_determinant, is_mirrored (det<0 means Y-negation needed). Essential for detecting baked rotations in luminaire imports.

Get property sets split by source: instance-level psets vs type-level psets. Use to determine whether a property was overridden at instance level or inherited from the type.

Look up an element by its integer IFC entity label (#NNN from the STEP file). Returns the same response as get_element_by_id. Use to cross-reference import log output like '[OK] #16535 LightGraphix...' directly against MCP queries.

Get the representation structure of an element without tessellating geometry. Returns representation type, identifier, and items with IfcMappedItem details (mapping_target_is_identity, mapping_target_matrix). Use to detect baked rotations before geometry extraction.

Batch query for multiple elements by GlobalId. include options: 'entity_label', 'placement', 'property_sets', 'local_bbox'. Default: ['entity_label', 'placement']. Avoids individual round-trips for files with 200+ fixtures.