MCP Connector for Revit Documentation

• Live licence discovery. The Bridge gets tool availability from the running plug-in, so a stale Free manifest no longer hides tools from a licensed Pro session. The local manifest remains the fallback when the host cannot be reached.
• Licence enforcement. Improved consistency when licence state changes. Paid operations still require entitlement in the native plug-in; tool discovery does not grant it. Existing signed offline allowances remain supported.
• Tool catalogue. Large live tool lists load correctly, including the new terrain and camera tools.
• Visibility diagnostics. Category searches can find model elements above or below a plan view range without requiring a known element ID. Reports distinguish vertical range, crop and other possible causes; collector membership is not proof that an element is drawn.
• Grid bubbles. Choose the displayed side consistently even when grids were drawn in opposite directions. Swapping checks the saved bubble state without reversing grid geometry.
• Dimensions and links. Clear and overall wall dimensions select the appropriate faces. CAD link reports separate loaded cached geometry from a missing source file. The new Pro link_revit_model tool supports origin or shared positioning.
• PDF scaling. Original-size 100% remains the default. An optional exact zoomPercentage, including 50%, is separate from automatic fit. Title-block registration is retained when it fits; centred fallback and possible clipping are reported. A nominal A1 sheet at exactly 50% is 0.5 mm wider than A3.
• Warnings and approval hints. Optional per-call policies can accept explicitly named warning IDs or roll back instead of waiting for a modal response. Interactive handling remains the default. File and session side effects are reflected in tool annotations.
• Native Toposolids. Create explicit concave boundaries with holes, subdivisions, point edits and sampled pad/batter grading. Revit 2024+ is required, with update-specific checks for point operations. Grading preserves the source by default and does not create native cut/fill or a continuing level association.
• Terrain following. Optional family/group placement, floor shape fitting, straight wall/fence profiles and supported terrain-hosted railing paths. Sampling is bounded; static results do not imply a continuing terrain association.
• Perspective cameras. Create and update eye/target, horizontal field of view and aspect ratio, with verified native readback and separate clipping controls. Optional display settings respect template and API restrictions.

Removal tools preview first and wait for your go-ahead, permissions can be set by person through Group Policy, and tags, spot elevations and geometry reach into linked models

• Removal tools preview first. remove_links, purge_unused, prune_design_options and purge_families list what would go and change nothing on a plain call. The AI is asked to show you the list and wait for your go-ahead before it calls again with dryRun false.
• CAD links and CAD imports. remove_links tells a CAD import from a CAD link. Imports are left alone unless cadImports is set, and can be removed on their own. The preview gives the file each CAD link points to.
• A question in Revit before a removal. An administrator can have Revit ask Allow or Refuse before any tool that deletes, removes, purges or ungroups runs. The question names the tool, the AI app, the model and the elements, and only you can answer it. It is off unless the policy switches it on.
• Permissions by person. The administrator policy is also read from Group Policy, for a computer or for chosen users, so a tool can be blocked for some people and not for others. Where more than one policy applies, the stricter one holds. A Group Policy template is in the install folder, and get_session_info says where each setting came from.
• Revit's warnings in every reply. Whichever tool makes a change, its reply lists the warnings Revit raised, any step that was not saved, and any step saved after your answer in Revit.
• Several Revit sessions. With more than one Revit open, calls go only to the session you choose. list_revit_sessions shows every model each session has open or linked, select_revit_session takes a model by file name, title or path, and every reply names the session it came from.
• Tags in linked models and in more views. tag_elements, tag_elements_in_view and get_tags take linkId to tag and read the elements and rooms of a linked model. The view sweep works in sections, elevations, detail views and drafting views, takes any category that has a tag of its own, and names the tag type it used for each category. Keynote tags show their keynote, where the model already holds one element keynote tag. A leader is optional, with leaderOffset in the model's own units. A tag the view does not draw is taken out and reported.
• Spot elevations and spot coordinates. create_spot_dimensions places them on the top, bottom or nearest surface of an element, in plans, sections, elevations and orthographic 3D views, in the open model or a link. get_spot_dimensions reads them back with the text each one shows.
• Geometry of linked elements. get_element_geometry and get_boundary_curves take linkId and return every point in the open model's coordinates.
• What a view draws. get_elements with a view and get_current_view_elements say where each element lies against the crop region, and get_active_view gives the crop region and the annotation crop. create_text_note and create_dimensions take out and report a note or dimension the view does not draw.
• Material textures and images. get_material_textures lists the image files materials use and which are missing. repath_material_textures points them at where the files are now, remove_missing_material_textures takes off images that cannot be found, and remove_unused_images deletes images nothing uses. The three that change the model preview first.
• API object reader. inspect_api_object reads an element, the document or the active view as the Revit API presents it, property by property, and steps into whatever a property returns. It changes nothing.
• Captured views as pictures. capture_view, capture_family_view and create_family_thumbnail return a picture the AI can look at.
• Parameters that share a name. set_parameter and batch_set_parameters take id: or guid: in place of a name to pick exactly one parameter. A write by name says when more than one parameter has that name and which one was written.
• Tool hints. Every tool that changes the model is marked either as one that only adds or as one that can overwrite or delete, checked tool by tool.
• Smaller changes. export_pdf takes the page orientation of a sheet with a hidden title block from the title block frame, and reports the page sizes of the written PDF. place_area_boundary_lines seats each area inside its traced loop. batch_link_cad at origin puts the link's origin at model height zero when the host view has no level. create_dimensions between two points takes the wall faces spanMode names. create_toposolid_from_dwg counts an elevation offset already given when it advises on heights. divide_parts reports the parts it cut and the parts it left. purge_unused takes only to keep a purge to unused materials (Revit 2024 and later), and on Revit 2022 and 2023 uses Revit's own check for unused families and types. remove_links counts a CAD link as removed once it has gone from the model. The batch parameter tools leave a level's Name to the tools that rename a level. get_grids and get_area_boundaries give millimetres beside feet.
• Connection. When no call can be sent, the bridge says which is the case: Revit is not running, the connector is switched off, or no session is chosen. A timeout and a lost connection are two separate messages.

Revit's warnings and errors are yours to answer, and the warning fixers leave grouped elements alone

• Revit asks you, not the AI. When a tool's change makes Revit raise a warning or an error, Revit shows its own message and waits for your answer, as it does when you make the change by hand. The AI cannot answer it. The reply says whether the step was saved.
• Warning fixers leave groups alone. The off-axis fixers, resolve_duplicate_instances, resolve_multiple_rooms_same_region and resolve_multiple_areas_same_region skip anything inside a group and list it with the group's name, to be changed in Edit Group mode.
• Warnings are reported. Every reply lists the warnings Revit raised while the tool ran, with the elements they name.
• Area boundary lines keep their dimensions. resolve_off_axis_area_boundary no longer removes dimensions attached to a line. removeConstraints is off by default. When on, only locked dimensions and constraints are removed, and each one is listed.
• Plain words for what a tool does. deep_purge says that single_instance_detail_groups ungroups detail groups placed only once, leaving the linework, and counts them as ungrouped. The room and area fixers say that every action except the default deletes, and list only what was deleted. A move, rotate or delete refused inside a group now points to edit_in_group.

Exact tagging, detail lines and wires, stairs, railings and ramps, MEP sizes and fittings, geometry read back as true curves, dialogs the AI can read and answer, sessions and documents chosen by name, an administrator policy with an audit log, and a model review export

• Tagging by element. tag_elements tags exact elements by ID in any view, including assembly views, each with its own tag type, head position and leader, and leaves alone an element that already carries that tag type. Switches and other electrical devices, wires, rebar and embeds can be tagged. get_tags reads the text each tag shows, its type, host, head and leader, and flags blank and orphaned tags. tag_elements_in_view keeps each tag inside the view's crop region.
• Detail and model lines. create_detail_lines draws lines, arcs and circles in a view with a line style and rounded corners; modify_detail_lines moves ends, redraws arcs, changes the style and fillets two lines; create_model_lines draws the same shapes as real 3D lines on one level or on every level.
• Wires, sizes and fittings. create_wires draws electrical wires through points and onto a device's connector. get_mep_sizes and add_mep_sizes read and extend pipe and conduit size tables; get_routing_preferences and set_routing_preferences read and set the fittings each type routes with; create_flex_duct_or_pipe, add_mep_insulation_lining, cap_mep_open_ends and set_mep_system_type finish a run.
• Stairs, railings and ramps. create_stairs builds a native stair from straight and spiral runs; create_railing, edit_railing_path and edit_railing_type place, re-route and configure railings, with the path, rails and extents read back; create_ramp makes a straight ramp with optional railings. create_hosted_sweep adds fascias, gutters and slab edges; edit_curtain_grid sets grid lines and mullions; create_framing_openings cuts beam openings; edit_floor_boundary reshapes a floor in place; duplicate_element_type makes a new type with its parameters set.
• Geometry as it is. get_element_geometry returns vertices, edges and faces in millimetres, and get_boundary_curves returns sketch boundaries and location curves as true lines, arcs, ellipses and splines. get_view_cut_planes and move_view_cut_plane read and move where a section or elevation cuts. get_reference_planes, create_project_reference_planes and set_datum_3d_extents cover reference planes and the 3D extents of grids and levels. get_bounding_boxes and get_element_by_id take fullPrecision for unrounded values.
• Family editor. Dimensions and locks to a family level, sketch locks on sweeps, blends and revolves, and radius, diameter and angular dimensions through create_family_dimension. create_boolean_solid makes one solid from two forms and join_family_geometry joins solids. A void that removes nothing is reported as failed, flex_family reports a size the rig cannot reach, and new families are kept in a working folder rather than on the Desktop.
• Dialogs. A call that Revit holds behind one of its own dialogs is answered with the dialog's title, text and buttons instead of timing out, and a call made while a dialog is open is refused naming it. get_open_dialog reads the dialog and press_dialog_button presses the button you choose. Renaming a level through rename_elements, renumber_datums or set_parameter no longer stops on Revit's prompt: viewsFollowLevel decides whether the plans follow, and the reply lists the views renamed.
• Sessions and documents. With more than one Revit open, list_revit_sessions shows each session with the model it has in front and select_revit_session switches by process or by model, and start_revit_session starts an installed Revit release when none is running. If the chosen session closes, calls fail and say so rather than moving to another Revit. Every tool takes an optional document naming the open model to act on. undo and redo report which steps ran. create_model makes a new project from a template, save_document and save_as report the file as it is on disk, and open_model with checkOnly says whether a long open has finished.
• Administrator policy and audit log. An administrator can switch packs off and block or allow named tools for every user of a computer, alongside the existing read-only lock; the connector dialog shows what is locked. An audit log, off unless an administrator turns it on, keeps one line per tool call - time, user, computer, model, AI app, tool, whether it reads or writes, the outcome and the start of its arguments - with a copy to a folder the administrator names. Both need Pro. Two ready-made views of the log are under Power BI Dashboards.
• Model review export. export_model_review saves a snapshot of the open model, or of every model in a folder, as tables for Power BI or any other reporting tool: warnings and Performance Adviser results with their Element IDs, model checker figures and element counts. Each run adds a snapshot, so trends build up over time. A ready-made Power BI dashboard charts them.
• Tool hints. Every tool is marked as read-only or not, and as destructive or not, so an AI app that asks for approval before each call can let reads through.
• Fixes and smaller changes. Sections are created on Revit 2022, 2023 and 2024 by create_views, create_element_sections and create_section_by_room. mirror_elements no longer removes a hosted door or window, and takes flipHosted to flip it in place. place_family_instances and place_families_from_excel correct a family that doubles its height above the level. divide_parts divides an element again after a first division. A blank DWG, DXF or PDF export is reported as failed, and DWG and DXF replies carry an entity count. export_pdf takes fitToPage. batch_link_cad reports each link's level and height and takes originZMm or levelName. create_walls and create_floor take units in millimetres, and create_floor takes openings. create_filled_region subtracts holes from the area it reports. attach_walls and join_geometry read the result back off the model before reporting success. set_parameter reports a change Revit rolled back as a failure, and a parameter name a tool does not know is reported rather than ignored. capture_view can frame chosen elements, a rectangle or the current viewport.
• Connection. The bridge never repeats a call whose outcome it could not confirm: it says so, and get_bridge_recovery shows what to check first. "Empty response from Revit" is replaced by a plain statement of what is wrong.

Sustainability pack, schedules with a house style placed on sheets, filled and masking regions, a legend builder, and drawing reissue in one call

• Sustainability pack (11 tools). Carbon factors stored on materials with set_material_carbon_data and read back with get_material_carbon_data; calculate_embodied_carbon and get_element_material_breakdown give a deterministic figure per element and per material; find_carbon_hotspots, compare_construction_carbon, create_carbon_analysis_view, create_carbon_schedule and export_carbon_report (xlsx or csv) present it; calculate_glazing_ratio and calculate_existing_retention cover the fabric checks. Quantities are scoped the way a Revit schedule scopes them: main model plus primary design options, elements present at the end of the last phase, with includeDemolished and includeNonPrimaryOptions as opt-ins, and every reply says what was counted. get_material_quantities uses the same scope.
• Schedules with a house style. create_schedule and modify_schedule take headerImage (a logo in its own row above the title), headerStyle (background, text colour, font, size, bold, alignment and border line style for the title row and the column heading rows), headerRows (insert, write, merge, clear and delete rows in the header), units per column (the Format Unit button: unit, accuracy, symbol, trailing zeros, digit grouping), phase and phaseFilter, split into segments, and striped rows with both colours and a sheet-only switch. Reading a schedule back now lists its header rows, units, phase and segments.
• Schedules on sheets. place_views_on_sheets places schedules, which Revit refuses as viewports, one instance per segment side by side, and reports the drawn size. Views and schedules sit inside the title block's drawing area, read from the block's own border lines and title column, with the sheet size taken from the placed title block rather than the family's parameters, so imperial blocks without them no longer lay out as A1.
• Filled and masking regions. create_filled_region draws project loops with holes, view-frame outlines, a crop band hugging chosen sides of the crop, and regions in a family; fill by type name, by a colour that creates a solid type, or as a masking region, across many views in one call. build_legend makes chip-and-label legends from a view's filters or from custom entries.
• Drawing reissue. reissue_sheets duplicates a set of sheets with their views and detailing as a new issue: renumber by rule, suffix sheet and view names, set status parameters on the sheet or title block, strip inherited revisions and clouds, and stamp one new revision, with a dry run and one undo step per call. update_revision edits, issues, unlocks or deletes a revision and delete_revision_clouds clears clouds by view, sheet or revision. duplicate_sheets falls back to duplicating with detailing when Revit refuses the with-views option.
• Smaller changes. Cell border line styles are accepted with or without Revit's angle brackets. attach_walls needs Revit 2026 or later and says so on 2025 instead of failing.

Paste aligned across views and projects, background documents, true dimension lines, schedule editing, datum tools, and survey placement that refuses rather than shifts

• Paste aligned to selected views. The new copy_view_elements copies view-specific elements at the same position into other views or sheets - a callout's detail lines into its drafting view, a generic annotation stamp onto a list of sheet numbers - and into another open project, creating the drafting view or legend there when it is missing. Sketch internals are filtered out, a mixed set falls back per category and per element, and the rename notice Revit raises on a cross-project paste is captured instead of left in a dialog.
• Background documents. save_document saves any open document in place; save_as and close_document take a documentTitle; activate_document lists the open documents and brings one to the front.
• The dimension line itself. Every dimension read now carries dimensionLineMm (start, end, direction) and the text positions, separate from the bounding box that also spans the witness lines and text. The distance between two dimension lines is now the real distance, and move_elements shifts a line by a vector.
• Linked openings in elevation. auto_dimension_openings_in_elevation takes linkId, so every auto-dimension tool now works on a loaded link.
• Schedules edited, not just created. modify_schedule adds, removes and reorders fields, sets headings, column widths, hidden columns, alignment, totals and min/max, per-column bold, font, size and colour, grouped column headers, filters, sorting, appearance, title/header/body text styles, combined-parameter columns and the name, and reads a schedule back. create_schedule takes the same blocks. A filter on a Level, Phase or Type field now takes the element's name. Formula and percentage fields and conditional formatting are not exposed by the Revit API and are said so in the tool.
• Grids and levels. set_datum_extents switches heads between 3D and 2D per end across many views; set_datum_leaders adds the jog to a grid or level head; assign_scope_box puts grids, levels and reference planes into a scope box; create_radial_grids makes arc and spoke grids about a centre; renumber_datums renames grids by position and levels by elevation without name collisions.
• Rooms. set_room_extents sets upper limit, limit offset and base offset in bulk and the computation height of levels; resolve_room_volume_overlap reads Revit's "Room volumes overlap" warnings and caps the lower room at the upper room's base.
• Survey placement. create_toposolid_from_dwg matches the file's linework to the imported linework on the same entities and only accepts a fit that agrees to within 10 mm; anything else is refused with the numbers rather than shifted. The boundary is the convex hull of the accepted points, lifted to survey level, so Revit no longer drops hull points, and the result reports retained and lost points. manage_shared_coordinates acquires from a linked DWG. export_dwg reports file size and entity count and flags a blank export.
• Annotation clashes. check_annotation_clashes measures a dimension by its line and text, not its witness lines, and tests door tags against the door's swing.

Practice template tools, a Parts pack, nested-family placement, and title block labels copied from a master

• Schedules. The new create_schedule builds regular, key, material takeoff, sheet list, view list, note block and keynote legend schedules. Columns, sorting and filters are named by field, checked against the category's own schedulable fields, and a filter on a measurable field takes a unit ("900 mm") or reads a bare number in the project's display unit.
• Project standards. create_project_parameter makes a shared parameter and binds it to categories, extending an existing binding rather than refusing it, and puts the shared parameter file back where it found it. create_line_pattern, create_line_style, create_legend, manage_keynotes and get_browser_organization cover the rest of a practice template checklist.
• Templates saved as templates. save_as writes a .rte; open_family and close_family take .rft, so a family template is authored and saved as one with no rename afterwards.
• Title blocks per sheet size. create_title_block scaffolds one family per size from the installed templates, reading the sheet extent from the paper-edge linework. Revit has no API for labels, so copy_family_elements copies them from a master title block into every other size with their parameter bindings intact, aligned on a sheet corner.
• Nested families placed, not just loaded. place_nested_family (and place_family_instances with target set to family) places a nested component inside the open family - by point, on a named reference plane, or in a view, following the nested family's own placement type. It works from a background session with no project open. set_family_shared turns a family's Shared flag on so it schedules on its own.
• Library search. find_library_family searches the library places Revit is configured with, plus any folders you add, and loads a single match - refusing to overwrite a loaded family of the same name unless told to.
• Parts. create_parts, divide_parts (by levels, grids and reference planes, or by curves, with a gap), set_parts_excluded, offset_part_faces, merge_parts and set_parts_visibility.
• Assemblies from the start. create_assembly makes the assembly that create_assembly_views needed you to make by hand.
• Multi-category and keynote tags. tag_elements_in_view takes a tagFamily to tag every chosen category with one tag type.
• Fewer tokens for content authors. A Family-pack-only profile now keeps nested placement, so a content author can switch every other pack off - about a sixth of the full tool list.

Gross internal area through phased openings, elevation crops, a fixed sheet anchor, and the linked-model tools

• Gross internal area survives phased openings. Putting a door or window into a wall of a different phase makes Revit generate an infill wall: a real wall carrying the host's whole location line while its solid covers only the opening. place_area_boundary_lines was tracing it as a wall in its own right, laying a second boundary line over the host's and committing a slither of the real area. Walls sharing a centreline now collapse to the one that physically spans it, and every excluded wall comes back with its phase and its span so the trace can be checked
• No more waiting on a dialog nobody can see. An overlap or an unenclosed region used to open Revit's own modal warning behind the call, where it sat until the client gave up. Area boundary work now carries a failure handler: warnings come back as data, errors roll the whole transaction back, and every reply says plainly whether it committed or rolled back
• Loops are checked before anything is written. A closed area loop needs three distinct vertices, a measurable area and no revisited point. Segments that would be drawn on top of one another are refused outright, with their coordinates, because that is what raises the overlap warning. Re-running a scheme needs an explicit existingLines choice instead of quietly stacking a second set of lines, and an area already sitting in the region is kept rather than duplicated
• Elevation and section crops. A project X/Y rectangle cannot say how high to crop an elevation, so both corners landed at the same height and Revit clamped the result to a strip. set_crop_region takes viewLocalMin and viewLocalMax instead, in millimetres across and up the view itself, and reports the crop in both frames along with the far clip
• Sheets stop moving when a title block is hidden. Forcing a paper size centred whatever was currently printing, so hiding the title block re-centred the drawing and moved it. export_pdf now anchors on the title block's own frame, which a graphic override cannot move. Measured across a hidden and visible pair: 0.078 mm, against 15.4 mm before
• Honest visibility counts. The auto-dimension tools were inferring visibility from three dozen speculative checks and reporting dimensions as hidden that were plainly on the drawing. Membership of the view's own element set is now the answer, and the diagnostic engine is only asked why afterwards. Fixes the count across every auto_dimension_* tool
• Say which face to measure. create_dimensions takes a spanMode of clear for the internal span or overall for the external one, so the same two walls no longer answer differently depending on how the request was phrased
• Linked models. manage_links sets a link's reference type between Attachment and Overlay, moves a link instance, and repaths one - which is how a link is swapped for a different model while keeping its position and every instance. get_linked_files reports the reference type and path type alongside each link
• Shared coordinates. The new audit_shared_coordinates answers whether each link is on shared coordinates or reads <Not Shared>, with its offset and rotation from the host origin. The new manage_shared_coordinates acquires a grid from a link, publishes this model's into one, or resets it. Publishing writes into the linked file, so it refuses without an explicit confirmation
• Host families on a linked model. The new place_family_on_linked_face places face-based families on the faces of elements inside a link, without copying the linked geometry in. A point that misses is pulled to the nearest face with the distance reported, and a dry run lists every face's extent so a point can be aimed. Wall-hosted families such as doors and windows cannot host on a linked wall at all, which Revit does not allow, and that is refused with the reason

Slanted and tapered walls, roofs, hosted doors and windows, external elevations, and a batch of fixes

• Slanted and tapered walls. create_walls takes a crossSection of slanted or tapered with the angles per wall or shared, and the new set_wall_cross_section changes existing walls and can set the doors and windows they host to follow the lean. Dimensions to a leaning wall reference its cut line, gross internal area traces follow the real face at the level, and hosted placement takes a hostOrientation of match. Draw exterior walls clockwise: the exterior face sits to the left of the drawing direction and the lean, taper and door facing follow it
• Attach top and base in batch. The new attach_walls attaches the top or base of any set of walls to a roof, floor, ceiling, toposolid or wall, finding the nearest one above or below each wall when no target is named, and detaches on request. Revit 2025 and later
• Native roofs. create_roof builds footprint roofs again on every roof type, with slope (rise over run) and slopeEdges for mono-pitch, dual-pitch and hipped roofs, overhang for eaves, baseOffset, a units parameter, and a read-back of every edge's slope and the roof's elevation range. A roof type name that matches nothing is an error listing the types, never a silent substitute
• Hosted doors, windows and rooflights. place_family_instances and place_families_from_excel place wall-hosted families on the nearest wall to each point, or an explicit hostElementId, with sillHeightMm, flipHand and flipFacing, and report the host and the sill each instance ended up with
• External elevations and sections. create_views creates elevations from a marker at originMm in a plan view, one direction or all four on one marker, and sections from a start and end point with depth and height
• Dimensions between walls. create_dimensions references wall side faces perpendicular to the dimension, runs the line through linePoint, refuses two references that resolve to the same wall, and names the element and face behind every reference
• PDF paper size honoured. export_pdf applies paperSize at 100% centred, and every export reports the sheet outline, the page it produced and why, with a warning when a hidden title block leaves the sheet with no size
• Faithful sheet duplication. duplicate_sheets carries sheet-level text, lines, regions, legends and schedules, viewport types and label positions, and title block parameters, and reports anything it could not copy
• Gross internal area on any wall direction. place_area_boundary_lines picks the inside or outside face from the enclosed side of the loop rather than the wall's drawn direction, warns on mixed loops, and returns the traced loops with vertices, perimeter and area for checking
• Room preview matches placement. auto_place_rooms dry run reads the same plan topology the placement uses and reports a read failure instead of zero regions
• Unit-safe room export. export_room_data writes the room Name and Number from their own parameters and quantities in the project's display units with the unit in the column header
• Discovery. ping and get_session_info report the connector version, edition, tool count and unit conventions
• Grok Build. One-click setup for xAI's Grok Build CLI alongside Claude Desktop, ChatGPT / Codex, Cursor and GitHub Copilot
• Fixes. A JSON-encoded string in a walls, types or boundaryPoints array is parsed, and anything else is named per item instead of failing the call or returning an empty failure list

Wall types from the spec, a model checker, and material assets

• New tool: create_compound_types. Wall, floor, roof and ceiling types from a spec build-up in one call: give it the layers (function, material, thickness, exterior first) and it duplicates a base type, replaces the stack, creates any material the project lacks, and reports the result per type. Revit's layer rules are checked before the type is built and explained per layer when they bite - membrane layers must be 0 mm thick, and outside the core the layers must step up in priority as they move outward (Structure, Substrate, Thermal/Air, Finish 1, Finish 2) - with a fixShellOrder option that reorders or re-functions the layers for you
• Vertically compound walls can be edited. Every wall type in Revit reports as vertically compound, so edit_compound_structure was refusing all of them. It now only stops when the type carries split regions, sweeps or reveals, tells you what it would drop, and replaces the structure only with your say-so. Layers can be set in full, re-ordered, re-functioned and given a priority; wall sweeps and reveals survive a layer change and can be added to a type; and wallPositionImpact plus keepFace show which face of every wall would move and pin the one you choose, on edits, type updates and change_element_type
• New tool: rename_compound_types. Rename types to a naming standard from a template with tokens for category, function, structural material, width and layer stack. Dry run shows every old and new name; get_compound_structure with listAll audits every type in one call
• New tool: model_checker_report. A model review in one call - views, sheets, warnings with a critical count, imports and links, families, text, groups, materials, Performance Adviser rules, unused views, import line patterns, empty elevation markers and the Area and Volume Computations setting - written to an .xlsx with a history row for Power BI. set_area_volume_computation switches Areas only / Areas and Volumes and the area basis
• New tools: set_material_properties and get_material_properties. Thermal and physical assets (isotropic or orthotropic), identity fields and custom parameters such as an embodied carbon factor, read and written singly or in batch, with an .xlsx export and a scan for materials missing an asset
• New tool: override_dimensions_by_value. Every dimension under, over or between given values coloured across a view, a sheet or every view, and cleared again
• New tool: copy_from_link. Elements of a category, or chosen ids, copied from a loaded link into the host model in place. Host types win on a name clash, and Revit's own "renamed to avoid conflicts" notices no longer roll the copy back
• New tool: create_family_types. One type per finish or size in the open family, with parameter values converted by their own units, materials by name and identity fields filled. Family authoring also gained straight profile segments that snap onto an axis in create_revolve and create_extrusion, reference planes whose extents match in every view, and a colour-only fallback in create_material when no appearance asset matches
• Sheet annotation batch. set_viewport_type and get_viewport_types switch every viewport on chosen sheets to No Title or Title w Line in one call; align_annotations works per sheet and per view, measures tags the way the ribbon does on Revit 2025 and later, and can align in columns so notes on the other side of a detail stay put; adjust_viewport_title_line fits and aligns title lines to the measured label; renumber_viewport_detail_numbers orders by position in rows
• Fixes. close_document with save off no longer saves; auto_dimension_grids keeps its stack inside an elevation's crop; imperial projects can give thicknesses and offsets in inches and fractions; purge_unused and deep_purge reach the open family session

Two new tools, and Codex everywhere

• New tool: create_fill_pattern. Model and drafting fill patterns, named as you specify. Ask for a sized preset - herringbone, chevron, running bond, stack bond, basketweave, hexagon, lines or crosshatch, all in millimetres - or draw the pattern in any view, put a rectangle round it to mark the repeat tile, select the lines and turn the drawing into a pattern: angles are snapped to the nearest repeating angle and every correction is reported, drafting patterns come out at the drawn size via the view scale, and flips, rotation and a scale multiplier are there when you need them. Import from a .pat file (or search a whole folder of them by name), and every pattern comes back as .pat text you can save or export straight to a file
• New tool: paint_opening_reveals. Paint the jamb, head and sill faces inside window and door openings across many walls in one call - scope by wall IDs, a wall type name or the current selection, choose which faces, dry-run to count the faces first, and strip it all off again with removePaint
• Startup fix for recent Codex builds. Newer ChatGPT / Codex releases read the tool list strictly and refused a draft-specification field the Bridge included, failing the whole connection at startup with "Unexpected response type". The field is gone. The Bridge also now answers the handshake immediately and looks for the Revit session in the background, so a client that starts its first conversation quickly still sees every tool
• One-click setup covers Codex everywhere. The dialog entry is now ChatGPT / Codex: it detects ChatGPT Desktop, the Codex app, the Codex CLI and the Codex extension for VS Code - and when Codex runs inside WSL, the connector writes the WSL-side configuration too, so the tools appear there without any manual editing

Room elevations that follow the room

• New tool: refit_room_elevations. Revit fits an interior elevation to its room once, when the marker is placed, and never again - resize the room and every elevation stays cropped to the old one. This tool finds the existing elevations for a room (by the marker sitting inside it, or by the view name pattern they were created with) and re-crops them to the room as it is now: width and height to the room, view depth to the furthest wall face. Sheets and viewports are left where they are. Optional crop offsets per side, and a dry run that reports the before and after of every view without changing the model
• Far clip lands on the furthest wall. create_room_elevations used to set the view depth from a single line through the room centre, which on an L-shaped room stopped at the inner corner rather than the far wall. Both tools now sample the depth across the full crop width and clip past the deepest face, with the margin exposed as farClipMargin (300 mm by default)

Two fixes to MEP connection preview and view capture

• connect_mep_elements preview no longer writes to the model. The dry run used to make each connection for real and roll it back. Every rollback queues Revit's own background MEP network calculation on a worker thread, and across a large batch that work could collide with a following read and bring the session down. The preview is now a read-only classification - it measures the connector geometry and names the route it would take, creating nothing. It also flags two pairs in the same batch competing for the same open connector, which the old preview could not see
• capture_view fixed on shaded views. Revit selects the image format from two separate settings, one for hidden line and wireframe views and one for shaded views. Only the first was being set, so a shaded 3D view was written as a JPG while the tool looked for a PNG and reported a failure on a capture that had actually succeeded. Both are now set, and the written file is found whatever Revit named it - which also covers localised view-type names on non-English installs
• A dry run is now a prediction rather than a proof of execution. It reports the route the connection would take, but Revit can still refuse at execution - for example where the routing preferences hold no fitting family for that size. The live run is verified exactly as before, with both connectors read back from the model
• Preview response renamed. connect_mep_elements in dry run now reports routable and notRoutable, where v3.6.0 and v3.6.1 reported connected and failed. The old names read as though the connection had been made, which was never true of a preview. Anything reading the preview response directly needs a small update

Linked-model queries, and point-mode dimensions that snap to datums

• Query tools reach inside loaded Revit links. get_elements and search_elements now take a linkId, so you can find elements inside a linked model and dimension them directly without opening the link as its own document. Link results return their ids inline rather than as an element-set handle, because a handle resolves against the host model and would point at the wrong elements
• Point-mode dimensions now snap to grids and levels. create_dimensions in point mode previously skipped datums entirely - grids and levels carry no location point or curve, so nothing was found at the point given. Datums are now measured against their view-projected curve

MEP and Structural packs, display style control, and text notes

• New MEP pack. Draw ducts, pipes, cable tray and conduit, build duct and piping systems, circuit fixtures to panels, create and re-sync MEP spaces from a linked model's rooms, and read panel schedules. Connection state is read from the model's own connector data rather than inferred from proximity, so check_disconnected_mep and get_mep_connectors report what is actually joined
• New Structural pack. Beams, beam systems, columns, braces and foundations, plus framing coping, slab openings, framing parameter writes, a support check, and analytical model read-out for handoff to analysis
• New tool: set_view_display_style. Display style is a view property rather than a parameter, so set_parameter could never reach it - which also meant 3D views stayed shaded and vector PDF export could not fire
• New tools for text: create_text_note with a leader that must point at an element visible in the view, plus get_text_notes, update_text_notes and find_replace_text
• New tool: purge_families. Purges inside loaded families and reloads them, reporting the file size saved on each
• export_dwg honours format: "dxf", and confirms the file exists on disk before reporting the path
• export_view_image accepts imageWidth as an alias for pixelSize, and reports the path Revit actually wrote rather than the one requested
• set_parameter and batch_set_parameters accept unit suffixes such as "150 mm", and get_parameter_values_by_category gained offset pagination
• tag_elements_in_view covers MEP categories

Units parity, cleaner auto-dimension replace, and on-sheet visibility reporting

• Auto-dimension replace fixed on templated views. All seven auto_dimension_* tools now detect existing dimensions even when the view template hides them, so replace and skip behave correctly instead of leaving an orphan dimension per run
• Visibility reported beside created counts. The auto-dimension tools now report visibleInView with a hiddenReason for each result - what was created in the model and what actually shows on the sheet are both explicit
• get_element_by_id units parity. Full unit labels, metric twins and rounded values matching get_elements, plus the element's bounding box in millimetres
• fit_room_tags reporting split. stillNotFitting becomes stillTooBig and outsideTheirRoom, separating tags too large for their room from tags sitting outside it
• get_bounding_boxes measures view-specific annotations in their owning view, and a missing box now says the element exists and names its category instead of returning an empty result

Working with groups, viewport alignment that lines the drawing up, and reference plane setout

• Groups become a first-class workflow. Five new tools: get_groups (inventory of group types, instances and members), create_group, edit_in_group (move, retype or delete elements inside a group in one atomic call - the legal ungroup, modify, regroup loop handled for you, with the type name preserved and an option to push the edit to every instance), place_group_instances and swap_group_type
• Clear guidance instead of dead ends on grouped elements. Move, rotate, mirror, delete and type-change tools now explain exactly why a group member is blocked and which route works, naming the containing group - no more misleading unpin advice or unanswerable Revit dialogs
• align_viewports rebuilt. Viewports match their originals by view name, then detail number, then position - so sheets with several views of the same type pair correctly - and matched pairs align by the drawing content itself, so crop or annotation differences cannot shift the layout. View titles come along too
• New tool: set_reference_plane_extents. Set reference planes to one length or match a selected plane, with alignEnds to line parallel planes up into a single band - and it finds a view each plane is visible in by itself
• New tool: copy_view_templates. Copy view templates between two open models in one call, filters and settings included
• Saved Positions support (Revit 2026+). New manage_view_positions tool - list, create, capture a viewport's layout, and assign positions so Revit itself enforces the layout across sheets. create_sheets and align_viewports understand position-controlled views instead of fighting them, and sheet placement is measured from the title block corner in millimetres or inches
• delete_elements now protects group members: deleting one removes it from every instance of the group, so it asks for explicit confirmation first
• ungroup_elements reliably deletes emptied group types when asked

Dimension into linked models, and every write verified

• Dimension to linked models. All seven dimension tools can now reference elements inside loaded Revit links. create_dimensions takes an {elementId, linkId} pair per reference, and the auto_dimension_* tools take a linkId - so a structural grid or an MEP element in a link can be dimensioned from the host model
• Verified writes. Every write tool now checks its own work after Revit commits, reporting what was requested against what was actually created - a silent partial failure is no longer possible
• Dimensions now use the project's default dimension style instead of the first type found
• New tool: set_crop_region - set a view's crop to a rectangle in project coordinates, the way to plan one building out of several
• New tool: fit_room_tags - make room tags fit their rooms by rotating them, dropping to a smaller type, or pushing them onto a leader, with the action taken reported per tag
• auto_dimension_rooms gains sidePreference to control which side of the room the strings land on
• place_views_on_sheets now accepts a sheetId, so views can be placed on an existing sheet directly
• Wrong parameter names now fail loudly with a suggestion of the nearest valid name, instead of being silently ignored
• CSV exports now write a UTF-8 byte order mark, so they open correctly in non-English versions of Excel
• Measurements in tool responses now carry explicit unit labels

Tool pack toggles, area plans, and batch family authoring

• New Tool Packs section in the connection dialog: enable only the packs you need, so your AI client sees a smaller, sharper tool list. Changes apply live in supporting clients - no restart needed
• New tools: get_areas and get_area_boundaries - read area schemes, placed areas and their boundary loops. Included in the free tier
• New tools: create_area_scheme, place_area_boundary_lines and place_areas in Modelling - trace a level's exterior walls at the inside face, outside face or centreline for gross and net internal area plans, close the loops, and place an area in each
• New tools: move_elements, rotate_elements and mirror_elements in Modelling - batch move by a millimetre offset, rotate about any axis, and mirror about a named reference plane or any origin-and-normal plane, in projects and in the family editor. Model one raked leg, mirror it, get all four
• Batch family authoring: create_revolve, create_extrusion, add_family_parameter and create_material now accept arrays - several solids, parameters or materials in one call, with per-item results. Parameters are created in order, so a formula can reference one defined earlier in the same call
• New tools: delete_elements and rename_elements - delete or rename elements, views and materials by ID, so the AI can correct its own work cleanly
• New tool: set_family_element_visibility - choose which detail levels each piece of family geometry shows at, for example a simple stand-in at Coarse and the full profile at Medium and Fine
• Family editor refinements: labelled dimensions now place themselves clear of the geometry, and imported CAD underlays can be nudged into position after import
• Families created with create_family now save to your Desktop instead of the connector's application data folder, so your work survives an uninstall or upgrade

Bulk family placement from a spreadsheet, and shared licences

• New tool: place_families_from_excel. Place family instances in bulk from an .xlsx or .csv coordinate table, one row per instance. X and Y are the only required columns; Z, Family, Type, Level and Rotation are optional, so one file can place a single family across a site or many different families in a single pass
• Place in project coordinates or in shared survey coordinates, reading Easting and Northing straight from the file, with units in millimetres, centimetres, metres or feet
• New tool: get_coordinate_system. Read the model's project base point, survey point and rotation from true north, and check whether shared coordinates are usable, before placing anything by Easting and Northing
• Reads European spreadsheet exports directly: semicolon separators and decimal commas are detected automatically. Where a value is genuinely ambiguous the tool stops and names it rather than placing everything a hundred times out
• Write any spreadsheet column onto the placed instances as a parameter value, for example Mark or Comments
• Every instance is placed in a single transaction, so one undo straight afterwards removes the whole placement
• Floating licences. A licence can now be shared across a team as a pool of concurrent seats. A seat returns to the pool when that machine closes Revit, so there is no need to deactivate one machine before working on another
• New Licences In Use view under Manage Licence, listing the machines currently using the licence, when each took a seat, and when each was last seen
• Update notifications: the connector now tells you when a newer build is available
• Fixed: an AI client could be reported as configured when the application was not actually installed

Curtain wall dimensioning

• New tool: auto_dimension_curtain_walls. Dimension curtain wall panels in elevation and section views - one chained string reading every panel, a separate dimension per segment, or a dimension across each individual panel, edge to edge
• Measure gridline to gridline, or to the mullion faces for alternating mullion width and clear glass width
• Place strings on any side - top and bottom for panel widths, left and right for panel heights - with overall dimensions and wall-end terminations included
• Set how far per-panel dimensions sit from the panel edge, or leave them running through the middle
• create_dimensions now resolves curtain grid line references, so passing grid line IDs directly works

Family Editor pack, 30 new tools, and multi-conversation connections

• New Family Editor pack: 15 tools for authoring loadable families end to end - create from a template or open an existing family, build a named reference-plane rig, label it with parameters, flex it to prove it, model extrusions and revolves, trace imported CAD drawings, generate clean thumbnails, and load the result into your project
• New tool: place_family_instances. Place loaded family types at given points on a level, with per-placement rotation
• New tools: duplicate_views, find_element_locations, and find_hidden_elements in Views & Sheets - duplicate views in bulk, find every view and sheet that shows an element, and explain why elements are not displaying
• New tool: find_untagged_elements. QA pre-check for untagged doors, windows, rooms, and more before issuing drawings
• New tools: deep_purge and get_element_history in Model Management - targeted cleanup beyond a standard purge, and per-element worksharing history
• New tool: change_element_type. Swap many instances to a different type in one transaction, with a dry-run preview
• New tools: get_compound_structure and edit_compound_structure in Modelling - read and edit the layer build-up of wall, floor, roof, and ceiling types: resize the structural layer, swap materials, add or remove finish layers, all with a dry-run preview and the option to edit a duplicate of the type
• New tools: set_wall_location_line and create_walls in Modelling - change walls' location line (centrelines, finish faces, core faces) and batch-create walls from centreline segments
• New tool: undo. Post Revit's native Undo or Redo, up to 10 steps - revert an unwanted change straight from the chat
• New tools: get_view_template_settings, compare_view_templates, and update_view_template in Views & Sheets - read what a template controls, find inconsistent settings across templates, and fix them in place
• Connection reliability: the connector now serves multiple AI client connections at once - every new ChatGPT Desktop conversation connects instantly, and Claude Desktop and ChatGPT Desktop can drive the same Revit session side by side
• Documentation links across the installer and connector dialog now point at this docs page

Tool accuracy and safety patch

• Example prompts added to every tool in the reference tables - click any prompt to copy it
• create_section_by_room now asks for specific rooms (or an explicit all-rooms confirmation) instead of silently sectioning every room in the model
• create_sheets reports an error listing the available title blocks when a requested title block ID does not resolve, instead of silently substituting the project's first title block
• check_model_interferences now states clearly that clash detection runs within the current model - linked models are listed for context, not clash-tested
• get_session_info now reports the Revit build number, username, and memory usage as documented

One product: free tier plus Pro licence

• The free and Pro editions are unified into a single product: the 37 free read-only tools work out of the box, and a Pro licence key unlocks the full 170+ tool set in place - no separate download, no reinstall
• New Buy Pro Licence and Activate Key buttons in the connection dialog; the dialog title and licence controls follow your tier
• One identity everywhere: the connector registers as AUTOM8LABS_Revit in your AI apps. Upgrading migrates your settings and cleans up the old AUTOM8LABS_Revit_Pro entry from every AI app configuration automatically
• Installed bundles from earlier editions (website Pro and App Store Pro) are removed automatically on upgrade
• Programs and Features entry renamed to "MCP Connector for Revit"

ChatGPT Desktop support and smarter AI app setup

• ChatGPT Desktop is now a fully supported AI app: the Enable MCP toggle configures it automatically alongside Claude Desktop and Cursor
• The setup dialog now shows only the AI apps detected on your machine
• The Microsoft Store build of Claude Desktop is configured automatically - no manual config copying
• More reliable first conversations: the connector now tells the AI it is operating a live Revit session, so requests run as tool calls instead of mock-ups
• Installer improvements: prompts to quit running AI apps before setup, and uninstalling now removes the connector's entries from every AI app configuration

Views, drawing registers, and warning resolvers - 15 new tools

• New tool: create_view_filter. Create rule-based view filters from categories and parameter rules, and apply them to views with visibility and graphic overrides
• New tool: create_view_template. Capture an existing view's settings as a named view template and assign it to views
• New tool: override_element_graphics. Colour, line weight, transparency, and halftone overrides per view, plus colour-coding by parameter value with an auto legend
• New tool: analyze_linked_view_usage. Audit how RVT links display across views, and which linked view each one shows (Revit 2024+)
• New tools: analyze_drawing_register, update_drawing_register, and export_drawing_register. Read your company's own drawing issue-sheet template, then fill it from live sheet and revision data - including non-destructive updates to an already-populated register
• New tools: seven automated resolvers for 'slightly off axis' warnings, covering walls, grids, lines, reference planes, room separation lines, sketch lines, and area boundaries
• New tool: create_toposolid_from_dwg. Build a toposolid straight from a linked CAD survey's contours or spot heights
• Drawing register upgrades: composite document numbers, extra parameter columns, distribution block fill, and multi-worksheet templates
• Fixes across per-sheet revision numbering, linked-view analysis, and toposolid placement

Licensing platform and element sets

• New tool: get_element_set. Page through the element IDs behind the compact element-set handles (ES-xxxx) that query tools return for large result sets
• Query tools now return element-set handles for large result sets, and bulk tools accept them directly
• Moved to the shared AUTOM8LABS licensing platform for more reliable activation and seat management
• Clearer tool descriptions across the export tools

Fixes and new tools

• New tool: create_sheets_from_excel. Build a whole set of sheets in one pass from an Excel drawing register, with sheet number, name, title block, and an optional view and scale per row
• New tool: unhide_elements_in_view. Reveal elements that are permanently hidden in a view, one at a time or all at once
• Orient the active 3D view's section box square-on to a selected wall or face, fitted neatly around it
• Create scope boxes at exact dimensions, from an origin and size or from min and max corners
• Revision tools now fully support per-sheet revision numbering, not just per-project
• More reliable IFC export
• MEP opening tools now resolve their host wall or floor correctly when cutting or placing openings
• Faster model-health audit on large models
• Remove PDF, image, and point-cloud links, not just Revit and CAD links
• More accurate worksharing relinquish reporting, including what still needs a sync
• Smarter file-path handling so exports land where you expect
• Dry-run previews added to more bulk-modify tools
• Reliability fixes across sheet sets, section views, view capture, dimensioning, and room finishes

Coordination and polish

• Added the Coordination pack: clash detection, MEP penetration detection, openings, and dedicated clash review views
• Grew the tool set and refined how the packs are organised
• Reliability and performance improvements across the packs

Initial Release

• 160+ MCP tools across 10 packs, including the 36 free read-only tools
• Create, modify, audit, coordinate, and export
• Supports Claude Desktop, Cursor, and Claude Code