5 min read Updated May 2026

MCP Connector Pro Documentation

Complete guide to installing, configuring, and using MCP Connector Pro - 120+ MCP tools across 9 packs, additive to the 36 free read-only tools, driven by Claude Desktop, Cursor, or Claude Code.

Supported Revit Versions

• Revit 2022
• Revit 2023
• Revit 2024
• Revit 2025
• Revit 2026
• Revit 2027

AI Applications

• Claude Desktop
• Cursor
• Claude Code
• Any MCP stdio client

Installation

Enabling MCP Connector Pro

After installation, click the MCP Connector Pro button in the Add-Ins tab to open the connector dialog. Toggle Enable MCP to start the connection.

The dialog shows the status of detected AI applications:

• Ready (Running) - The AI application is detected and the MCP server is active
• Not Detected - The AI application is not currently running

Configuration

MCP Connector Pro includes one-click auto-configuration for supported AI applications. Click the MCP Connector Pro button in the Add-Ins tab to open the configuration dialog.

Claude Desktop

Click Configure Claude Desktop to automatically update your Claude Desktop configuration. The config file is located at:

Cursor

Click Configure Cursor to automatically update your Cursor MCP configuration. The config file is located at:

Claude Code & other MCP clients

MCP Connector Pro exposes a standard MCP stdio server, so it also works with Claude Code and any other MCP-compatible client. Point your client at the MCP Connector Pro server command shown in the connector dialog.

Pro Tool Packs

MCP Connector Pro adds 120+ MCP tools across 9 packs, additive to the 36 free read-only tools listed further below. Every tool name shown is the exact identifier exposed to your AI client.

Annotation Pack

Place and manage dimensions, tags, and text across one view or many - then audit them for clashes.

Tool	Description
auto_dimension_grids	Auto-create linear dimension strings for orthogonal grids across plan and elevation views, with segment and overall dimensions.
auto_dimension_levels	Auto-create vertical dimension strings for levels in elevation views, placed on either side and excluding interior elevations.
create_dimensions	Create linear dimensions in a view between element references or between two explicit points.
get_dimension_types	List dimension types in the document, optionally filtered by style, returning ID, name, and style type.
tag_elements_in_view	Tag every instance of selected categories - rooms, doors, windows, walls, equipment, and more - across one or more views.
check_annotation_clashes	Detect overlapping dimensions, tags, and text notes, and optionally auto-reposition clashing tags to resolve overlaps.
align_annotations	Align or distribute tags, text notes, and dimensions in the active view to the selection bounds.
toggle_grid_bubbles	Show, hide, or toggle grid bubble heads per end and per view, addressed by screen position or grid end label.
remove_annotations_in_view	Delete dimensions, tags, and text notes from one or more views, with session-only scoping and dry-run preview.

Views & Sheets Pack

Build out the documentation set - create views and sheets, place and align viewports, manage templates, scope boxes, and sheet sets.

Tool	Description
create_sheets	Create one or more sheets with a title block, optionally placing views at given positions.
create_batch_sheets	Create multiple sheets in bulk with auto-incrementing numbers, prefixes, suffixes, and zero-padding.
duplicate_sheets	Duplicate existing sheets, optionally copying their views onto the new sheets.
delete_sheets	Delete sheets by name or number (or all except a keep-list), preserving the active sheet.
create_views	Create floor plans, reflected ceiling plans, and 3D views with level, scope box, scale, and template options.
delete_views	Delete views, by default keeping views placed on sheets and the active view; templates and schedules optional.
rename_views	Rename views by stripping copy/duplicate suffixes or rewriting from a per-view-type naming template.
create_room_elevations	Create interior elevations, 3D views, plans, and RCPs for selected rooms, optionally laying them out on sheets.
create_section_by_room	Auto-create longitudinal and transverse section views centred on each selected room.
create_element_sections	Create front, back, left, right, and top section views oriented to selected elements.
create_workset_views	Create a 3D view per workset, isolating each workset's visibility, in workshared models.
place_views_on_sheets	Place views on sheets with auto-layout that sizes viewports to prevent overlaps.
layout_sheet_viewports	Rearrange existing viewports on a sheet using grid, row, column, or auto layouts to avoid overlaps.
align_viewports	Align viewport positions across target sheets to match a chosen reference sheet.
adjust_viewport_title_line	Adjust viewport title-line length to match the title text width or a fixed length across sheets.
renumber_viewport_detail_numbers	Renumber viewport detail numbers with zero-padding, ordered by position, name, or existing number.
apply_view_template	Apply or remove a view template across specified views, view types, or name-matched views.
copy_view_setup	Copy scale, template, detail level, display style, discipline, phase, and crop from one view to others.
copy_view_filter	Copy view filters and their graphic overrides from a source view to target views.
orient_view_to_elements	Orient and zoom the active 3D view onto specified elements, setting a section box around them.
batch_fill_sheet_parameters	Set parameters across multiple sheets using literals, formulas, view-derived values, and scale calculations.
capture_view	Capture the active or named view as a PNG image so a vision-capable AI can inspect the model.
analyze_visibility	Diagnose why elements are not visible in a view, checking categories, filters, phases, view range, and more.
get_view_types	List view family types, levels, title blocks, scope boxes, and existing view names for the project.
get_view_filters	List view filters applied to a view, with their visibility state, graphic overrides, and rules.
get_title_block_info	List project, sheet, and title block parameters usable as naming placeholders in export tools.
manage_sheet_sets	Manage sheet sets: list, create, delete, rename, add or remove sheets, and export to PDF.
get_scope_boxes	List scope boxes with their extents and optionally the views each is applied to.
create_scope_box	Create a scope box by duplicating an existing one, optionally offset and renamed.
apply_scope_box	Apply a scope box to specified views so their crop follows the box.
remove_scope_box	Clear a scope box from views or delete the scope box element from the model.

Modelling Pack

Author core building geometry from coordinates and room boundaries - grids, levels, floors, roofs, ceilings, finishes, and skirting.

Tool	Description
create_grids	Create horizontal and vertical grid lines with named labels, uniform or variable spacing, and a chosen origin.
create_levels	Create levels at given elevations, optionally auto-generating each level's floor plan view.
create_floor	Create a floor from a closed polygon of boundary points on a chosen level and floor type.
create_roof	Create a footprint roof from a closed polygon of boundary points on a chosen level and roof type.
create_ceiling	Create a ceiling from a closed polygon of boundary points on a chosen level and ceiling type.
create_ceilings_from_rooms	Create ceilings inside selected rooms from their boundaries, set at a height offset above each room's level.
create_room_finishes	Create floor and wall finishes inside rooms from their boundaries, with optional joining to structural walls.
place_skirting_in_rooms	Place wall-sweep skirting along the base of room-bounding walls on the interior face, cut at openings.
copy_element	Copy an element by a translation vector, optionally producing multiple equally spaced copies.
get_room_boundaries	Return a room's boundary loops and segments with start/end points, lengths, and bounding element details.
get_wall_sweep_types	List available wall sweep types (cornices) for skirting, baseboards, and mouldings, with ID, name, and family.

Data Pack

Read and write element parameters at scale, with full Excel round-trip and intelligent renumbering.

Tool	Description
set_parameter	Set one parameter value on a single element, auto-detecting storage type and rejecting read-only parameters.
batch_set_parameters	Set one parameter to the same value across many elements in a single transaction, reporting per-element results.
find_replace_parameter	Find and replace text parameter values across a category using exact, contains, starts/ends-with, or regex modes.
match_element_properties	Copy parameter values from a source element to target elements - all writable parameters or a named subset.
get_parameters_for_category	List parameters on a category's elements with name, storage type, and instance/type level, for discovering valid names.
renumber_elements	Renumber elements by view reading order, selection, or path, with level/building prefixes and zero-padding.
import_parameters_from_excel	Write parameter values from an .xlsx file onto elements matched by an ElementId column, skipping blanks and read-only fields.
export_parameters_to_excel	Export element parameters to an .xlsx file, one row per element, ready for editing and re-import.

Reporting Pack

Manage revisions and the drawing register, run quantity and finish takeoffs, compare elements, and produce analysis reports.

Tool	Description
create_revision	Create a new revision row in the Sheet Issues/Revisions table with description, date, issuer, visibility, and numbering sequence.
get_revisions	List all revisions in the document with sequence number, date, description, and issued status.
get_sheet_revisions	List sheets with their assigned revisions and current revision details, for drawing issue registers.
get_revision_settings	Report revision settings and available numbering sequences to find the correct sequence ID before creating revisions.
add_revision_to_sheets	Add one or more revisions to selected sheets, by sheet number, ID, or all sheets.
remove_revision_from_sheets	Remove a revision from selected sheets, optionally deleting associated revision clouds and the revision itself.
analyze_drawing_register	Analyse an Excel drawing register template to detect its structure, column mapping, and format before updating.
export_drawing_register	Export sheet revision data to an Excel drawing issue register, using a template or a new standard-format file.
update_drawing_register	Update an Excel drawing register with sheet and revision data, reading ISO 19650 parameters and building dated revision columns.
compare_elements	Compare two or more elements side-by-side, showing parameter differences, matching values, and type variations.
get_material_quantities	Aggregate material volume and area across model elements for takeoff, filtered by category or material and grouped flexibly.
get_room_finishes	Report room finish data including wall, floor, and ceiling finishes, bounding elements, and contained furniture counts.
get_door_handing	Determine each door's hand and swing direction (LH, RH, LHR, RHR), optionally writing the result to a door parameter.
export_warnings_report	Export model warnings to a CSV or JSON health-check report with descriptions, counts, severity, and affected element IDs.
create_chart	Return chart data (bar, donut, stats, or table) for the connected AI client to render from gathered results.

Model Management Pack

Audit, purge, compact, and maintain model health - plus worksharing, links, design options, and file operations.

Tool	Description
audit_model_health	Run a full model health audit: warnings, element counts by category, unplaced rooms, unused families, imported CAD, and file metrics.
audit_parameter_completeness	Report what percentage of elements in a category have given parameters filled, flagging empty ones for BIM compliance and handover.
purge_unused	Purge unused families, types, view templates, filters, materials, patterns, and imported CAD in iterative passes; supports dry-run.
compact_model	Save the model with compaction to reduce file size, reporting before and after sizes; optionally save the compacted copy elsewhere.
strip_model	Clean a model in one pass: remove Revit and CAD links, purge unused elements, and save compact, reporting file-size reduction.
clean_backup_files	Delete Revit backup files (.0001.rvt, .0001.rfa, and so on) from a folder, with recursive scanning and dry-run preview.
close_document	Close the active document, optionally saving first and optionally exiting Revit afterwards.
save_as	Save the active document to a new path, with options for maximum backups, compaction, clearing the transmitted flag, and disabling worksharing.
save_as_cloud_model	Upload the active model to ACC/BIM 360 as a cloud workshared model, making it the new cloud central. Requires account, project, and folder IDs.
open_model	Open a model from cloud (ACC/BIM 360) or local/network path, with options to detach, audit, unload links, and guard against version upgrades.
create_model	Create one or more new Revit projects from an .rte template, save each to disk, and optionally open the last one.
manage_links	Load, unload, reload, remove, or repath linked Revit models, in batches across multiple links.
remove_links	Remove linked files (Revit links, CAD links, or both), unloading and deleting the link types and all their instances.
get_design_options	List every design option set in the model, showing each set's options and which is primary.
prune_design_options	Delete all non-primary design options and their elements, preserving primary geometry with original IDs.
relinquish_all	Relinquish ownership of all worksets and elements without syncing, for detached models saved as a new central.
sync_and_relinquish	Synchronise a workshared model with central and optionally relinquish all worksets, with comment and compaction options.
manage_worksets	Create, rename, or delete worksets in a workshared model, supporting multiple operations in one call.
purge_families	Purge unused families and types, with optional deep purge that opens each family to clean its internal content.
rename_families	Rename families and family types using search-and-replace rules, with scope, type-inclusion, case-sensitivity, and preview options.

Warnings Pack

Automated resolvers for Revit's most common warning types - fix every warning matching a pattern in a single call.

Tool	Description
resolve_duplicate_marks	Fix duplicate instance Mark warnings by clearing or renumbering marks, with filters, patterns, and batched processing.
resolve_duplicate_type_marks	Fix duplicate Type Mark warnings by clearing or renumbering type marks, with configurable patterns and numbering scope.
resolve_duplicate_instances	Fix identical-instances-in-the-same-place warnings by deleting duplicates, keeping either the original or the newest element.
resolve_off_axis_walls	Fix slightly-off-axis wall warnings by snapping walls to the nearest clean angle, with filters and join handling.
resolve_off_axis_grids	Fix slightly-off-axis grid warnings by snapping grids to the nearest clean angle.
resolve_off_axis_lines	Fix slightly-off-axis warnings for model and detail lines by snapping them to the nearest clean angle.
resolve_off_axis_sketch_lines	Fix slightly-off-axis sketch line warnings on floors, ceilings, and walls with edited profiles by snapping boundary lines.
resolve_off_axis_reference_planes	Fix slightly-off-axis reference plane warnings by snapping reference planes to the nearest clean angle.
resolve_off_axis_room_separation	Fix slightly-off-axis room separation line warnings by snapping the lines to the nearest clean angle.
resolve_off_axis_area_boundary	Fix slightly-off-axis area boundary line warnings by snapping the lines to the nearest clean angle.
resolve_overlapping_walls	Fix overlapping wall warnings by deleting exact duplicates, zeroing offsets on stacked walls, joining adjacent walls, or flagging for review.
resolve_wall_room_separation_overlap	Fix wall-and-room-separation-line overlap warnings by deleting redundant lines or smart-trimming those extending beyond the wall.
resolve_walls_attached_miss_targets	Fix walls-attached-but-missing-targets warnings by detaching the walls from their top and/or bottom attachments.
resolve_joined_not_intersecting	Fix joined-but-do-not-intersect warnings by unjoining the highlighted elements.
resolve_multiple_rooms_same_region	Fix multiple-rooms-in-the-same-enclosed-region warnings by selecting or deleting redundant rooms by a chosen rule.
resolve_multiple_areas_same_region	Fix multiple-areas-in-the-same-enclosed-region warnings by selecting or deleting redundant areas by a chosen rule.
select_warning_elements	Select and isolate elements that have warnings, optionally creating a dedicated 'Warnings Review' 3D view, filterable by warning type.

Coordination Pack

Run clash detection between disciplines and linked models, manage MEP penetrations, and set up dedicated review views.

Tool	Description
check_model_interferences	Detect clashes between two sets of element categories and report each clashing pair with its location.
detect_mep_penetrations	Detect MEP services from linked models penetrating walls, floors, ceilings, and roofs, grouping them into sized openings.
create_mep_openings	Place rectangular or circular opening family instances at penetration locations, sized automatically.
cut_mep_openings	Cut native rectangular openings directly into wall and floor hosts at penetration points, without placing a family.
create_clash_review_view	Create or return a dedicated isometric 3D 'Clash Review' view and return its ID.
frame_clash_in_section_box	Size the Clash Review view's section box around a clashing element pair, with margin, and activate the view.
export_clash_report	Write clash results to a CSV file and return the row count and written path.
get_elements_by_proximity	Find elements within a radius of a point or element, returning them sorted by distance with an optional category filter.
get_bounding_boxes	Return min, max, centre, and dimensions of element bounding boxes in millimetres, optionally view-specific.

Issue Pack

Export the model for sharing, handover, or coordination - PDF, DWG, IFC, NWC, images, and data, with parameter-based naming.

Tool	Description
export_pdf	Export sheets to PDF with parameter-based naming, colour and quality controls, and an optional single combined file.
export_dwg	Export views or sheets to DWG or DXF with layer mapping standards, line scaling, units, and property overrides.
export_ifc	Export the model to IFC with full option coverage: version, property sets, mapping tables, and header metadata.
export_nwc	Export the model to NWC for Navisworks with full option coverage, including scope, conversion, and faceting controls.
export_view_image	Export a view to a PNG or JPG image at a chosen pixel size and quality.
export_schedule	Export a schedule view to a CSV file, optionally including column headers.
export_room_data	Export rooms with chosen parameters to CSV or JSON, filtered by level or phase; returns inline if no path is given.
clean_for_transmit	Multi-pass pre-issue model cleaner: purge unplaced rooms, scope boxes, hidden elements, design options, and stray views, plus workset hygiene.

Free Read-Only Tools

These 36 read-only tools ship with the free MCP Connector and are included in Pro. They query and read model data without making any changes.

Document & Session Tools

These tools provide information about the current Revit session and document.

Tool	Description
ping	Test connection to Revit
get_session_info	Get Revit version, username, memory usage
get_document_info	Get document title, path, project info, phases
get_document_warnings	Get all document warnings with severity filter
get_linked_files	Get linked RVT, CAD, IFC files

Element Query Tools

Query and retrieve information about elements in the Revit model.

Tool	Description
get_elements	Query elements by category, family, type, level
get_element_by_id	Get detailed element info by ID
get_element_parameters	Get all parameters for an element
get_element_count	Count elements by category
search_elements	Search for elements by text across names, type names, family names, marks, and comments
get_parameter_values_by_category	Read a specific parameter value across all elements in a category

View Tools

Tools for working with views, sheets, and visibility settings.

Tool	Description
get_views	List views (floor plans, sections, elevations, 3D, etc.)
get_active_view	Get current active view details
set_active_view	Switch active view by ID or name
get_current_view_elements	Get visible elements in active view
get_sheets	List all sheets with viewport info
hide_isolate_elements	Hide, isolate, or reset element visibility
reset_temporary_hide_isolate	Reset temporary hide/isolate state in the active view

Selection Tools

Tool	Description
get_selected_elements	Get currently selected elements
select_elements	Set selection by element IDs
clear_selection	Clear current selection
save_selection_set	Save current selection as a named set
recall_selection_set	Recall, list, or delete selection sets

Family Tools

Tool	Description
get_categories	Get all categories
get_families	Get loaded families by category
get_family_types	Get types for a family

Project Tools

Tools for accessing project-level information.

Tool	Description
get_levels	Get all levels with elevations
get_grids	Get all grids
get_phases	Get project phases
get_worksets	Get worksets (workshared docs)
get_rooms	Get rooms with area, volume, boundaries
get_project_units	Get project unit settings
get_room_areas	Get room area summary grouped by level, department, or room name

Schedule Tools

Tool	Description
get_schedules	List all schedules
get_schedule_data	Get schedule data as structured JSON

Utility Tools

Tool	Description
calculate	Math calculations

Troubleshooting

Connection Issues

If Claude Desktop or Cursor cannot connect to Revit:

• Ensure Revit is running and has a document open
• Restart your AI application after configuring
• Check that the Bridge executable is not blocked by antivirus
• Try running the ping tool to test connectivity

Tools Not Appearing

If MCP tools are not visible in your AI application:

• Verify the configuration file was updated correctly
• Restart your AI application completely (not just refresh)
• Check the MCP server logs for errors

Frequently Asked Questions

Changelog