Skip to main content
Glama

IFCX MCP

A Model Context Protocol server for creating IFC5 / IFCX building information models through AI assistants.

You don't interact with this server directly. You connect it to an MCP client such as Claude Code, Claude Desktop, or any other MCP-compatible client, and then use natural language to author BIM models.

The project targets the IFCX examples and tooling style used in the IFC5 development work: alpha JSON .ifcx, post-alpha tiered index.ifcx with NDJSON tables, and zipped post-alpha .ifcx packages.

What It Can Do

The server keeps IFCX drafts in memory while it is running. A client can then drive the model through a normal authoring flow:

  1. Create a model with standard IFCX imports and provenance.

  2. Add Project > Site > Building > Storey > Space.

  3. Create reusable type nodes, such as wall, window, and pipe segment types.

  4. Create element occurrences and attach them to the spatial tree.

  5. Instantiate occurrences from types.

  6. Attach mesh, BRep, curve, and procedural geometry hints.

  7. Use richer authoring factories for walls from axes, windows with voids, pipe networks with ports, and storey grids.

  8. Add material, PBR material data, current IFC5 standard properties, classifications, bSDD references, and georeferencing.

  9. Create patch layers and explain their effect.

  10. Validate references, cycles, mesh indices, IFClite IFCX parsing, and IDS rules.

  11. Preview a viewer-shaped tree and export glTF / Three.js preview artifacts.

  12. Write alpha JSON, tiered IFCX, or zipped post-alpha IFCX.

  13. Dry-run or perform a layer-version publish to an IFCX layer API.

Related MCP server: bSDD MCP Server

Install

git clone https://github.com/louistrue/ifcx-mcp.git
cd ifcx-mcp
npm install
npm run build

MCP Client Configuration

Add the server to your MCP client using stdio transport. Change the path to wherever you cloned the repository.

Claude Code (~/.claude/settings.json or project .mcp.json):

{
  "mcpServers": {
    "ifcx": {
      "command": "node",
      "args": ["/path/to/ifcx-mcp/dist/server.js"]
    }
  }
}

Claude Desktop (claude_desktop_config.json): same format.

The server starts automatically when the MCP client launches.

For local development without an MCP client:

npm run dev

Usage Guide

Once the server is connected to your MCP client, you author models through natural language. The AI assistant translates your requests into the appropriate tool calls.

Creating a Model

"Create an IFCX model called Campus"

Initializes an in-memory draft with standard IFC imports and provenance tracking.

Building Spatial Structure

"Add a project with a site, a building called HQ, and two storeys: Ground Floor at 0m and First Floor at 3.5m"

Creates the full IfcProject > IfcSite > IfcBuilding > IfcBuildingStorey hierarchy.

Adding Elements

"Create a concrete wall type with 200mm thickness, then place exterior walls around a 20x12m rectangle on the ground floor"

You can work at different levels of detail:

  • Low-level — create a type, then elements, then attach geometry separately.

  • Rich factories — create walls from axis lines, windows with automatic void cutting, pipe networks with distribution ports, or storey grids, all in one step.

Attaching Geometry

Four geometry representations are supported:

  • Mesh — vertices and face indices (triangulated surfaces).

  • Procedural — extrude, sweep, revolve, or boolean hints.

  • BRep — OCCT BREP or STEP AP242 payloads.

  • Curves — polylines, arcs, circles, B-splines, or composite curves.

Adding Metadata

"Classify all walls as Uniclass Ss_25_10_30 and resolve via bSDD"

  • Materials with optional PBR data (roughness, metalness, color).

  • Classifications (CCI, NL-SfB, Uniclass) with live bSDD resolution.

  • Georeferencing via EPSG codes or WKT.

  • Patch layers for delta/change tracking over a base model.

Validating

"Validate my model"

Runs a multi-stage pipeline: schema validation, composition checks, reference integrity, geometry sanity, and adapter-level IFClite/IFCX-core checks. You can also run IDS validation and convert issues into BCF topics.

For export checks, use ifcx_validate_ifc5_compliance. That tool validates the sanitized IFC5 alpha output shape against the current IFC5 development schema/import conventions. The older ifcx_validate_viewer_compatibility name is kept as an alias for existing clients, but the buildingSMART viewer is not treated as the target spec.

Previewing

"Show me a preview of the model"

Returns a viewer-shaped tree and scene summary. You can also export:

  • glTF — scene.gltf + scene.bin for any 3D viewer.

  • Three.js — self-contained index.html you can open in a browser.

Exporting

"Write the model in tiered format to ./output/"

Three output formats are available: alpha JSON (single .ifcx), tiered (index.ifcx + NDJSON tables), and zipped post-alpha (.ifcx ZIP package).

Planning

"Plan a model for a hospital wing with mechanical systems"

The planner analyzes your intent and returns a step-by-step authoring plan with IDs, layers, types, geometry tiers, and an ordered tool-call recipe — without modifying any draft.

Typical Conversation

You: Create an IFCX model for a small school campus

You: Add a site, one building with 2 storeys (ground at 0m, first at 4m)

You: Create a concrete wall type, then place exterior walls
     around a 20x12m rectangle on the ground floor

You: Add 4 windows evenly spaced on the south wall

You: Add a DHW pipe network running east-west at ceiling level

You: Classify all walls as Uniclass Ss_25_10_30 and resolve via bSDD

You: Add georeferencing for Zurich (EPSG:2056)

You: Validate the model and show me any issues

You: Export a Three.js preview so I can check it in the browser

You: Write the final model in tiered format to ./output/

Things to Know

  • Everything is in-memory. Export your model before stopping the server.

  • Session IDs identify drafts. You can have multiple models open at once.

  • bSDD lookups are cached locally in .ifcx-mcp-cache/bsdd/.

  • Publishing is safe by default — dry-run mode unless you explicitly pass dryRun: false.

  • Ask to "list my drafts" or "show the model tree" at any time to see current state.

Tools

Drafts

  • ifcx_capabilities Report the available IFCX and IFClite adapter capabilities.

  • ifcx_plan_model Plan an authoring run from natural-language or structured intent. It returns IDs, layers, imports, types, elements, geometry tiers, schemas, write targets, and an ordered tool-call recipe. It does not mutate a draft.

  • ifcx_create_model Create an empty IFCX alpha draft with standard IFCX imports and provenance.

  • ifcx_list_drafts List drafts currently held by the running server process.

IFC Structure

  • ifcx_create_spatial_structure Create a project/site/building/storey tree, optionally with a space.

  • ifcx_create_type Create a reusable type node, for example IfcWallType, IfcWindowType, or IfcPipeSegmentType.

  • ifcx_create_element Create an element occurrence with class, name, recognized IFC5 properties, material, placement, and an optional parent attachment. Legacy properties and quantity inputs are normalized into direct bsi::ifc::prop::* attributes when the current schema supports them.

  • ifcx_instantiate_type Create an occurrence that inherits from an existing type node.

Geometry

  • ifcx_create_geometry_mesh Create a body node from points and faceVertexIndices, then attach it to an owner element.

  • ifcx_create_geometry_proc Create a procedural geometry hint, such as extrude, sweep, revolve, or boolean.

  • ifcx_create_geometry_brep Attach an OCCT BREP or STEP AP242 BRep payload to a node.

  • ifcx_create_geometry_curve Attach a polyline, arc, circle, B-spline, or composite curve payload to a node.

Rich Factories

  • ifcx_create_wall_from_axis Create a wall occurrence from a start/end axis, including direct IFC5 length/height properties, mesh body, material, and optional type inheritance.

  • ifcx_create_window_with_void Create a window occurrence and a procedural void hint tied to its host wall.

  • ifcx_create_pipe_network_with_ports Create a pipe sweep with start/end IfcDistributionPort nodes.

  • ifcx_create_storey_grid Create an IfcGrid with X/Y curve axes attached to a storey.

Metadata Layers

  • ifcx_create_material Add material and optional PBR material data to a node.

  • ifcx_create_classification_layer Attach CCI, NL-SfB, bSDD, or other classification references.

  • ifcx_resolve_bsdd_classification Resolve IFC/bSDD classification data from cache, from live bSDD when allowLive: true, or as a deterministic offline URI.

  • ifcx_create_georeference_layer Add EPSG coordinate attributes and optional WKT CRS text.

  • ifcx_create_patch_layer Create a delta layer over an existing draft. The patch imports the base draft ID and contains only the requested changes.

Validation And Preview

  • ifcx_validate_created_model Check missing references, repeated path opinions, cycles, missing local schemas, and mesh index sanity. Pass engine: "ifcx-core" or engine: "ifc-lite" to also run the IFClite IFCX parser/adapter.

  • ifcx_validate_ifc5_compliance Check the sanitized alpha export against the current IFC5 development imports and attribute shapes. Standard imported schemas stay imported; local schemas are only required for non-standard extension attributes.

  • ifcx_validate_ids Validate a draft against IDS XML using @ifc-lite/ids. The server builds an IFCX-backed accessor for entity type, properties, classifications, materials, and parents.

  • ifcx_create_bcf_from_validation Convert an IDS validation report into a serializable BCF topic summary using @ifc-lite/bcf.

  • ifcx_preview_created_model Return a composed, viewer-shaped tree plus summary counts and geometry bounds.

Write And Publish

  • ifcx_write_alpha Write a single alpha JSON .ifcx.

  • ifcx_write_tiered Write index.ifcx plus NDJSON attribute tables.

  • ifcx_write_zipped Write a zipped post-alpha .ifcx package containing index.json and NDJSON tables.

  • ifcx_write_bcf_from_ids Validate a draft against IDS XML and write a .bcfzip issue package.

  • ifcx_write_bcf_from_validation Write a .bcfzip issue package from an existing IDS validation report.

  • ifcx_export_preview_gltf Export a simple glTF preview folder with scene.gltf, scene.bin, and preview-manifest.json.

  • ifcx_export_preview_threejs Export a Three.js preview folder with index.html and the glTF scene.

  • ifcx_publish_layer_version Publish a zipped draft to an IFCX layer API. This defaults to dry-run unless dryRun: false is passed.

Layer History

  • ifcx_explain_layer_history Explain which node opinions introduced or overrode children, inherits, and attributes.

  • ifcx_explain_patch_effect Compare a base draft and patch draft, then report added, removed, and changed nodes/attributes.

Some older tool names are kept as aliases while the interface settles, such as ifcx_export_alpha, ifcx_export_tiered, ifcx_add_mesh_geometry, and ifcx_validate_draft.

Resources

The server also exposes MCP resources:

  • ifcx://drafts Current in-memory draft summaries.

  • ifcx://draft/{sessionId}/tree Viewer-shaped composed tree for one draft.

  • ifcx://draft/{sessionId}/scene Scene summary with tree, mesh/procedural counts, and bounds.

Integration Test

The integration test test/mcp-elaborate.test.ts drives the complete authoring workflow through MCP calls. It creates a two-storey model with walls, windows, domestic hot water pipes, ports, mesh geometry, procedural geometry, BRep and curve payloads, a storey grid, material/PBR data, classifications, bSDD resolution, georeferencing, a patch layer, preview resources, glTF/Three.js preview artifacts, and all three IFCX write formats.

npm run test:mcp

Output Formats

Alpha JSON:

model.ifcx

Tiered:

index.ifcx
ifcx.geom.mesh.ndjson
ifcx.geom.brep.ndjson
ifcx.geom.curve.ndjson
ifcx.geom.proc.ndjson
ifcx.semantics.ndjson

Zipped post-alpha:

model-post-alpha.ifcx

Preview:

scene.gltf
scene.bin
preview-manifest.json
index.html

The zipped package contains:

index.json
ifcx.geom.mesh.ndjson
ifcx.geom.brep.ndjson
ifcx.geom.curve.ndjson
ifcx.geom.proc.ndjson
ifcx.semantics.ndjson

BCF:

ids-validation.bcfzip

Publishing

ifcx_publish_layer_version is intentionally conservative.

By default:

{ "dryRun": true }

In dry-run mode it validates the draft and returns the target URL, layer ID, generated version ID, and blob ID, but does not upload.

With dryRun: false, it calls:

PUT  {baseUrl}/ifcx-api/upload/{blobId}
POST {baseUrl}/ifcx-api/layers/{layerId}/versions

Only use live publishing against an API endpoint you control.

Development

npm run check
npm run test
npm run test:mcp
npm run build

npm run test tests the authoring kernel directly.

npm run test:mcp builds the project, starts the MCP server over stdio with the SDK client transport, and drives the complete authoring workflow through MCP calls.

Project Layout

src/server.ts                         MCP server and tool/resource registration
src/ifcx-authoring/authoring-session.ts
src/ifcx-authoring/alpha-builder.ts
src/ifcx-authoring/tiered-builder.ts
src/ifcx-authoring/element-factories.ts
src/ifcx-authoring/geometry-factories.ts
src/ifcx-authoring/advanced-geometry.ts
src/ifcx-authoring/rich-factories.ts
src/ifcx-authoring/planner.ts
src/ifcx-authoring/preview-exporter.ts
src/ifcx-authoring/layer-history.ts
src/ifcx-authoring/validation-pipeline.ts
src/ifcx-authoring/patch-builder.ts
src/ifcx-authoring/writers.ts
src/adapters/bsdd-adapter.ts
src/adapters/ifc-lite-adapter.ts
src/adapters/ifcx-core-adapter.ts
test/authoring.test.ts
test/mcp-elaborate.test.ts

The src/ifcx/* files are compatibility re-exports for early imports. New code should import from src/ifcx-authoring.

Status

This is early implementation work. It already creates valid draft structures and writes the current target formats, but the authoring vocabulary will keep expanding as the IFCX examples and layer API mature.

Available Tools

73 tools
ifcx_add_layer_to_stackifcx_add_layer_to_stackD

Add a draft session to a federated layer stack.

Inputs: stackId (required), sessionId (required), name, position.

ifcx_add_mesh_geometryifcx_add_mesh_geometryD

Alias for ifcx_create_geometry_mesh.

Inputs: sessionId (required), ownerPath (required), points (required), faceVertexIndices (required), +4 more.

ifcx_add_procedural_geometryifcx_add_procedural_geometryD

Alias for ifcx_create_geometry_proc.

Inputs: sessionId (required), ownerPath (required), operation (required), parameters (required), +2 more.

ifcx_add_spatial_structureifcx_add_spatial_structureD

Alias for ifcx_create_spatial_structure.

Inputs: sessionId (required), projectName, siteName, buildingName, +7 more.

ifcx_apply_changesetifcx_apply_changesetC

Apply a changeset to its target draft session.

Inputs: changeSetId (required).

ifcx_begin_changesetifcx_begin_changesetC

Begin an IFCX mutation changeset for patch-like editing.

Inputs: sessionId (required), name.

ifcx_bind_materialifcx_bind_materialC

Bind a USD-style material path to a node.

Inputs: sessionId (required), path (required), materialPath (required).

ifcx_build_spatial_indexifcx_build_spatial_indexB

Build a simple AABB spatial index for mesh bodies in a session or federated stack.

Inputs: sessionId, stackId, cellSize.

ifcx_capabilitiesifcx_capabilitiesA

Report installed IFCX/IFClite adapter capabilities.

Inputs: no named parameters.

ifcx_changeset_add_opinionifcx_changeset_add_opinionC

Add an attribute, child, or inherit opinion to a changeset.

Inputs: changeSetId (required), path (required), attributes, children, +1 more.

ifcx_compose_federatedifcx_compose_federatedC

Compose a federated layer stack with source tracking and conflict detection.

Inputs: stackId (required).

ifcx_compose_stageifcx_compose_stageC

Compose one draft as an ECS-style stage with resolved inheritance.

Inputs: sessionId (required).

ifcx_compose_world_transformifcx_compose_world_transformC

Compose the transform chain and translation for a node.

Inputs: path (required), sessionId, stackId.

ifcx_create_bcf_from_validationifcx_create_bcf_from_validationC

Convert an IDS validation report into BCF topics using IFClite BCF.

Inputs: report (required), projectName.

ifcx_create_classification_layerifcx_create_classification_layerC

Attach CCI/NL-SfB/bSDD-style classification references.

Inputs: sessionId (required), targets (required), layerName.

ifcx_create_elementifcx_create_elementC

Create typed element occurrence with class, name, current IFC5 standard properties, material, and parent placement.

Inputs: sessionId (required), ifcClass (required), parentPath, childName, +8 more.

ifcx_create_geometry_brepifcx_create_geometry_brepC

Create a BRep body tier reference such as OCCT BREP or STEP AP242 and attach it.

Inputs: sessionId (required), ownerPath (required), format (required), data (required), +5 more.

ifcx_create_geometry_curveifcx_create_geometry_curveC

Create curve geometry such as polyline, arc, circle, bspline, or composite curve and attach it.

Inputs: sessionId (required), ownerPath (required), curveType (required), childName, +7 more.

ifcx_create_geometry_meshifcx_create_geometry_meshC

Create mesh body node from points/indices and attach it.

Inputs: sessionId (required), ownerPath (required), points (required), faceVertexIndices (required), +7 more.

ifcx_create_geometry_procifcx_create_geometry_procC

Create procedural geometry hint such as extrusion/sweep/revolve/boolean.

Inputs: sessionId (required), ownerPath (required), operation (required), parameters (required), +2 more.

ifcx_create_georeference_layerifcx_create_georeference_layerC

Generate EPSG/WKT georeference attributes like the IFCX georeference example.

Inputs: sessionId (required), targetPath (required), epsg32760, epsg4326, +2 more.

ifcx_create_layer_stackifcx_create_layer_stackC

Create an IFCX federated layer stack for USD-style composition.

Inputs: stackId, name.

ifcx_create_materialifcx_create_materialC

Add material or PBR material layer to a target node.

Inputs: sessionId (required), targetPath (required), material (required).

ifcx_create_modelifcx_create_modelB

Create empty IFCX/IFC5 model with standard imports and provenance.

Inputs: id (required), author, dataVersion, application, +2 more.

ifcx_create_patch_layerifcx_create_patch_layerC

Propose a delta layer over an existing draft model.

Inputs: sessionId (required), changes (required), id.

ifcx_create_pipe_network_with_portsifcx_create_pipe_network_with_portsD

Create a pipe sweep with start/end distribution ports.

Inputs: sessionId (required), parentPath (required), points (required), diameter (required), +6 more.

ifcx_create_spatial_structureifcx_create_spatial_structureC

Create project/site/building/storey/space tree.

Inputs: sessionId (required), projectName, siteName, buildingName, +7 more.

ifcx_create_storey_gridifcx_create_storey_gridC

Create a storey grid with X/Y curve axes.

Inputs: sessionId (required), storeyPath (required), xAxes (required), yAxes (required), +4 more.

ifcx_create_typeifcx_create_typeC

Create reusable type node, e.g. wall type, window type, pipe segment type.

Inputs: sessionId (required), ifcClass (required), path, typeName, +2 more.

ifcx_create_wall_from_axisifcx_create_wall_from_axisC

Create a wall occurrence from an axis with direct IFC5 length/height properties, mesh body, material, and type inheritance.

Inputs: sessionId (required), parentPath (required), axis (required), thickness (required), +7 more.

ifcx_create_window_with_voidifcx_create_window_with_voidC

Create a window occurrence plus a procedural void hint attached to its host.

Inputs: sessionId (required), hostPath (required), width (required), height (required), +8 more.

ifcx_detect_conflictsifcx_detect_conflictsC

Detect child, inherit, and attribute opinion conflicts in a session or stack.

Inputs: sessionId, stackId.

ifcx_detect_geometry_collisionsifcx_detect_geometry_collisionsC

Detect AABB mesh collisions and overlap volumes for a session or federated stack.

Inputs: sessionId, stackId.

ifcx_evaluate_lensifcx_evaluate_lensC

Evaluate lens rules against a session or federated stage.

Inputs: lens (required), sessionId, stackId.

ifcx_explain_layer_historyifcx_explain_layer_historyB

Explain provenance, overrides, and opinions for all nodes or one target path.

Inputs: sessionId (required), targetPath.

ifcx_explain_patch_effectifcx_explain_patch_effectC

Explain how a patch draft changes a base draft.

Inputs: baseSessionId (required), patchSessionId (required).

ifcx_export_alphaifcx_export_alphaD

Alias for ifcx_write_alpha.

Inputs: sessionId (required), outputPath, standalone, includeAuthoringMetadata.

ifcx_export_ifc5_bridgeifcx_export_ifc5_bridgeC

Export a sanitized IFC5/IFCX alpha JSON through the IFClite bridge path.

Inputs: sessionId (required), outputPath, standalone.

ifcx_export_ifc_stepifcx_export_ifc_stepC

Export a draft subset to IFC4 STEP using IFClite create.

Inputs: sessionId (required), outputPath.

ifcx_export_preview_gltfifcx_export_preview_gltfC

Export a simple glTF preview artifact from draft mesh geometry.

Inputs: sessionId (required), outputDir.

ifcx_export_preview_threejsifcx_export_preview_threejsC

Export a Three.js preview folder with glTF geometry from the draft.

Inputs: sessionId (required), outputDir.

ifcx_export_tieredifcx_export_tieredD

Alias for ifcx_write_tiered.

Inputs: sessionId (required), outputDir.

ifcx_import_ifc_stepifcx_import_ifc_stepB

Import IFC STEP metadata into a new IFCX draft using IFClite parser.

Inputs: inputPath (required), modelId, author.

ifcx_instantiate_typeifcx_instantiate_typeC

Create occurrence inheriting from a type node.

Inputs: sessionId (required), typePath (required), parentPath, childName, +1 more.

ifcx_list_draftsifcx_list_draftsB

List in-memory draft sessions.

Inputs: no named parameters.

ifcx_list_layer_stacksifcx_list_layer_stacksA

List IFCX federated layer stacks.

Inputs: no named parameters.

ifcx_plan_modelifcx_plan_modelA

Plan an IFCX authoring flow from natural-language or structured intent without mutating a draft.

Inputs: intent, modelId, author, storeys, +6 more.

ifcx_preview_created_modelifcx_preview_created_modelC

Compose and return viewer-shaped tree/scene summary.

Inputs: sessionId (required).

ifcx_publish_layer_versionifcx_publish_layer_versionB

Upload created zipped IFCX to /ifcx-api/layers/{layerId}/versions after validation. Dry-run by default.

Inputs: sessionId (required), baseUrl (required), layerId (required), versionId, +2 more.

ifcx_query_nodesifcx_query_nodesC

Query composed IFCX ECS nodes by class, attribute, property, material, classification, or text.

Inputs: sessionId, stackId, ifcClass, attributeName, +8 more.

ifcx_query_relationshipsifcx_query_relationshipsC

Return parents, children, and inheritance edges for a composed node.

Inputs: path (required), sessionId, stackId.

ifcx_query_spatial_pathifcx_query_spatial_pathC

Return the composed parent chain from root to a node.

Inputs: path (required), sessionId, stackId.

ifcx_raycast_sceneifcx_raycast_sceneC

Raycast against mesh AABBs and return sorted hit candidates.

Inputs: origin (required), direction (required), sessionId, stackId, +1 more.

ifcx_reorder_layersifcx_reorder_layersC

Reorder a federated layer stack by session IDs, strongest first.

Inputs: stackId (required), sessionIds (required).

ifcx_resolve_bsdd_classificationifcx_resolve_bsdd_classificationC

Resolve bSDD or IFC class classifications from live bSDD or the local cache.

Inputs: ifcClass, uri, query, apiBase, +2 more.

ifcx_resolve_conflictifcx_resolve_conflictC

Apply a chosen conflict resolution opinion to a draft session.

Inputs: sessionId (required), path (required), kind (required), key (required), +1 more.

ifcx_resolve_geometry_tierifcx_resolve_geometry_tierC

Resolve one generated geometry/semantics tier table from a draft.

Inputs: sessionId (required), tier (required).

ifcx_roundtrip_alphaifcx_roundtrip_alphaC

Roundtrip a draft through the installed IFCX adapter parser.

Inputs: sessionId (required).

ifcx_set_transformifcx_set_transformC

Set a USD-style xform transform attribute on a node.

Inputs: sessionId (required), path (required), transform (required).

ifcx_set_visibilityifcx_set_visibilityC

Set USD-style visibility on a node.

Inputs: sessionId (required), path (required), visible (required).

ifcx_spatial_summaryifcx_spatial_summaryC

Build simple bounds and collision summary for stage mesh geometry.

Inputs: sessionId, stackId.

ifcx_toggle_layerifcx_toggle_layerC

Enable or disable one layer in a federated layer stack.

Inputs: stackId (required), sessionId (required), enabled (required).

ifcx_validate_created_modelifcx_validate_created_modelC

Schema validation, composition validation, missing references, geometry sanity, and optional real adapter validation.

Inputs: sessionId (required), engine.

ifcx_validate_draftifcx_validate_draftD

Alias for ifcx_validate_created_model.

Inputs: sessionId (required), engine.

ifcx_validate_idsifcx_validate_idsC

Validate a draft against IDS XML using IFClite IDS and the IFCX draft accessor.

Inputs: sessionId (required), idsXml (required), locale, createBcf.

ifcx_validate_ifc5_complianceifcx_validate_ifc5_complianceC

Validate the sanitized alpha export against the current IFC5 development schema/import conventions.

Inputs: sessionId (required), standalone, includeAuthoringMetadata.

ifcx_validate_tier_tablesifcx_validate_tier_tablesC

Validate generated tier table counts for a draft.

Inputs: sessionId (required).

ifcx_validate_viewer_compatibilityifcx_validate_viewer_compatibilityD

Alias for ifcx_validate_ifc5_compliance; retained for existing clients.

Inputs: sessionId (required), standalone, includeAuthoringMetadata.

ifcx_write_alphaifcx_write_alphaD

Write single JSON .ifcx.

Inputs: sessionId (required), outputPath, standalone, includeAuthoringMetadata.

ifcx_write_bcf_from_idsifcx_write_bcf_from_idsC

Validate a draft against IDS XML and write a BCF zip with validation topics.

Inputs: sessionId (required), idsXml (required), outputPath, projectName.

ifcx_write_bcf_from_validationifcx_write_bcf_from_validationC

Write a BCF zip from an existing IDS validation report.

Inputs: sessionId (required), report (required), outputPath, projectName.

ifcx_write_tieredifcx_write_tieredD

Write index.ifcx + NDJSON tables.

Inputs: sessionId (required), outputDir.

ifcx_write_zippedifcx_write_zippedC

Write zipped post-alpha .ifcx via TS SDK-style JSZip packaging.

Inputs: sessionId (required), outputPath.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.5/5.0

    Scored across 73 tools

    Disambiguation3/5

    Many tools have clear distinct purposes, but the presence of numerous aliases (e.g., ifcx_add_mesh_geometry for ifcx_create_geometry_mesh) and similar tool names (ifcx_create_model, ifcx_plan_model, ifcx_preview_created_model) may still cause confusion for an agent.

    Naming Consistency4/5

    All tools follow the ifcx_verb_noun pattern with consistent verbs like create, list, export, validate. However, aliases (add vs create, write vs export) break the pattern, and the mixing of 'write' and 'export' for similar actions reduces consistency.

    Tool Count2/5

    With 73 tools, the server is very large. While it covers a broad domain, the number is excessive and likely to overwhelm an agent, making selection difficult. A more focused set or consolidation of related tools would improve coherence.

    Completeness5/5

    The tool surface is extremely comprehensive, covering creation, geometry, spatial structure, changesets, composition, validation, export, query, conflict detection, and more. There are no obvious gaps for the IFCX modeling and collaboration workflow.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to load, query, and analyze IFC building model files, including spatial structures, elements, properties, materials, and geometry.
      20
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that lets users query, validate, convert, and compare IFC/BIM files using natural language. Runs fully locally and integrates with AI agents like Claude.
      8
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI assistants to inspect, create, and report on IFC/BIM files locally, and to open models in a viewer with BCF viewpoint support.
      5
      155 npm
      13
      Apache 2.0