Revit MCP guide · Use it
What it can do
Every tool the add-in gives an assistant, in plain words, by what it is for. Free or Pro is marked on each.
How to read this list
A “tool” is one thing the assistant can ask Revit to do. You never call them yourself: you ask in plain words and the assistant picks. The name in small letters is what you will see in the conversation and in the Activity window.
- Free tools read the model, or change only what is on screen (the selection, the open view). They work without a key.
- Pro tools change the model. Each also needs the permission shown, which you set per document in Revit. See Free and Pro and Permissions and safety.
- In the next release means the tool is built and being tested, and is not in the installer you can download today. It is listed so you can plan, not so you can rely on it.
The published installer has 20 tools. A further 64 are in the next release. This list is copied from the add-in’s own catalogue (revision cbaa764aaa4a), so it cannot name a tool the add-in does not have.
The tools
Read the model14 available, 6 in the next release
Revit status
Revit processes, open documents, active view, permission, licence, tool packs, budgets and the last changes: call it first.
revit_status
FreeQuery elements
Finds model elements by category, scope, view, level, family, type or parameter rules, as a paged table; saveAs keeps the result as a set.
elements_query
FreeGet elements
Details of up to 50 elements by id: category, family, type, level, name, location, box, host, workset, owner, phase.
elements_get
FreeSummarise elements
Counts the elements matching where, grouped by category, family, type, level, workset or a parameter: the context saver.
elements_summarize
FreeList parameter definitions
Lists the parameters elements of some categories carry: name, storage, instance or type, shared, read-only.
parameters_list_definitions
FreeGet parameter values
Reads parameter values of the target elements as Revit displays them, with units, paged.
parameters_get
FreeList types
Lists the types of some categories with their family and how many instances each has.
types_list
FreeList views
Lists views (not templates) with their type, level, scale, template and the sheet each is placed on.
views_list
FreeList sheets
Lists sheets with number, name, title block, views and revision.
sheets_list
FreeList levels
Lists the levels by elevation, and the grids.
levels_list
FreeGet schedules
Lists schedules, or reads one schedule's definition (and its rows with data) in the form schedules_update takes.
schedules_get
FreeList warnings
Lists Revit's warnings of the document, grouped by type with sample ids, or one row per warning.
warnings_list
FreeGet the selection
Reads the elements selected in Revit now, as a table like elements_query.
selection_get
FreeCapture a view
Captures a view, or a rectangle of a plan, as a PNG image with a pixel-to-model mapping (modelRect).
view_capture
FreeGet element geometry
Reads geometry of the target elements: location, box, boundary, connectors and faces, in mm from a base, paged.
elements_geometry
FreeIn the next releaseList rooms
Lists rooms with their state (placed, unplaced, not enclosed, redundant), area, point and phase, paged.
rooms_list
FreeIn the next releaseWorksharing state of elements
Shows per element who holds it, whether you borrowed it, and whether it is out of date with the central model.
worksharing_status
FreeIn the next releaseList worksets
Lists the worksets of the active document, which one is active, and their elements.
worksets_list
FreeIn the next releaseList links and CAD imports
Lists Revit, IFC and CAD links and CAD imports with their status and placement, paged.
links_list
FreeIn the next releaseTool help
Full description, schema, examples and error codes of up to 3 tools, or the tool index of a pack, also one that is off.
tool_help
FreeIn the next release
Select and look1 available, 2 in the next release
Set the selection
Selects the target elements in Revit and can zoom to them; the model does not change.
selection_set
FreeOpen a view
Opens a view in Revit, optionally zoomed to fit; changes no element.
view_open
FreeIn the next releaseCalibrate a drawing to the model
Fits a drawing to the model by control points and check dimensions, and keeps the frame creation tools take.
coordinates_calibrate
FreeIn the next release
Model: levels, grids, walls, floors, rooms and more2 available, 13 in the next release
Create levels
Creates levels at given elevations, with preview, trial and apply.
levels_create
ProNeeds Allow editsCreate grids
Creates straight or arc grid lines in plan, with preview, trial and apply.
grids_create
ProNeeds Allow editsCreate walls
Creates walls along lines in plan, each of a wall type on a level up to a level or a height, with preview, trial and apply.
walls_create
ProNeeds Allow editsIn the next releasePlace doors and windows in walls
Places doors, windows and other wall-hosted family types into existing walls, at a point or a distance along the wall.
hosted_place
ProNeeds Allow editsIn the next releaseCut openings
Cuts rectangular wall openings, slab openings from a loop, and shaft openings through levels.
openings_create
ProNeeds Allow editsIn the next releasePlace rooms
Places rooms at points on a level, or one in every enclosed region of a level, with names and numbers.
rooms_place
ProNeeds Allow editsIn the next releaseLoad families
Loads .rfa families from the folders the person allowed; overwrite reloads families already in the project.
families_load
ProNeeds Allow editsIn the next releaseCreate in one batch
Runs several creation calls as ops of one call, later ops naming earlier items: one preview, one trial, one apply, one undo entry.
model_batch
ProNeeds Allow editsIn the next releasePlace areas
Places areas of an area scheme at points in its area plans, or in every region of their boundary lines.
areas_place
ProNeeds Allow editsIn the next releasePlace an underlay
Places a PDF page or an image from an allowed folder in a plan view, behind the model, to compare with it.
underlay_place
ProNeeds Allow editsIn the next releasePlace family instances
Places family instances (furniture, equipment, fixtures, terminals) at points, on levels, hosts or faces.
elements_place
ProNeeds Allow editsIn the next releaseLink files
Links Revit, IFC and DWG files from the folders the person allowed into the project.
links_add
ProNeeds Allow editsIn the next releaseCreate floors
Creates floors from an outer loop and holes, of a floor type on a level, with preview, trial and apply.
floors_create
ProNeeds Allow editsIn the next releaseCreate roofs
Creates footprint roofs from a loop, with sloped edges and an overhang, with preview, trial and apply.
roofs_create
ProNeeds Allow editsIn the next releaseCreate ceilings
Creates ceilings from an outer loop and holes, at a height above a level, with preview, trial and apply.
ceilings_create
ProNeeds Allow editsIn the next release
Change what is already there1 available, 7 in the next release
Set parameter values
Writes parameter values of the target elements (values, patterns, copies), preview then apply; scope type changes every instance.
parameters_set
ProNeeds Allow editsDuplicate types
Makes new types as copies of existing ones, each with a new name and new type parameter values.
types_duplicate
ProNeeds Allow editsIn the next releaseCreate worksets, move elements
Creates user worksets and moves elements into an open user workset.
worksets_set
ProNeeds Allow editsIn the next releaseRename types
Renames element types, swaps included.
types_rename
ProNeeds Allow editsIn the next releaseChange element types
Gives the target elements another type of their category.
elements_change_type
ProNeeds Allow editsIn the next releaseSet wall, floor and roof layers
Sets the layers of wall, floor and roof types; every instance changes, so the person confirms in Revit.
types_set_structure
ProNeeds Allow edits and deletesIn the next releaseMove, rotate or copy elements
Moves, rotates or copies the target elements.
elements_transform
ProNeeds Allow editsIn the next releaseImport CAD drawings
Imports DWG and DXF drawings from the folders the person allowed into a view.
cad_import
ProNeeds Allow editsIn the next release
Views, sheets, schedules and annotation1 available, 11 in the next release
Override graphics in a view
Overrides colour, transparency, halftone or visibility of the target elements in one view, or clears the overrides.
graphics_override
ProNeeds Allow editsCreate views
Creates floor and ceiling plans, sections, 3D and drafting views, or duplicates a view.
views_create
ProNeeds Allow editsIn the next releaseTag elements in views
Tags the target elements in views at Revit's default place, leaving elements already tagged there.
tags_place
ProNeeds Allow editsIn the next releaseCreate text notes
Writes text notes into views at given points.
text_notes_create
ProNeeds Allow editsIn the next releaseApply a view filter to views
Adds a view filter to views with overrides, making the filter when it does not exist yet.
filters_apply
ProNeeds Allow editsIn the next releaseCreate schedules
Creates schedules from a category, fields, filters, grouping and sorting, with preview, trial and apply.
schedules_create
ProNeeds Allow editsIn the next releaseChange schedules
Changes schedule definitions: fields, filters, grouping, sorting and itemize.
schedules_update
ProNeeds Allow editsIn the next releaseCreate sheets
Creates sheets with a title block and places views on them.
sheets_create
ProNeeds Allow editsIn the next releaseRename and renumber sheets
Renames and renumbers sheets, swaps included.
sheets_update
ProNeeds Allow editsIn the next releasePlace views on sheets
Places views on existing sheets, one viewport each, at given paper points or the sheet's centre.
sheets_place_views
ProNeeds Allow editsIn the next releaseUpdate views
Renames views and sets their scale, detail level and crop.
views_update
ProNeeds Allow editsIn the next releaseApply view templates
Assigns or clears view templates on views, or makes templates from views.
view_templates_apply
ProNeeds Allow editsIn the next release
MEP: ducts, pipes, trays, conduits and circuits0 available, 11 in the next release
List MEP curve types
Shows what duct, pipe, cable tray or conduit types can do before drawing: shape, sizes, fittings, system types.
mep_catalog
FreeIn the next releaseCreate ducts
Draws straight ducts of a duct type and system type on a level, joined at their ends if asked, with preview, trial and apply.
ducts_create
ProNeeds Allow editsIn the next releaseCreate pipes
Draws straight pipes of a pipe type and system type, with diameter and slope, joined at their ends if asked.
pipes_create
ProNeeds Allow editsIn the next releaseCreate cable trays
Draws straight cable trays of a type with width and height, joined at their ends if asked.
cable_trays_create
ProNeeds Allow editsIn the next releaseCreate conduits
Draws straight conduits of a type with diameter, joined at their ends if asked.
conduits_create
ProNeeds Allow editsIn the next releaseJoin MEP connectors
Joins MEP connectors with elbows, tees, crosses, transitions, unions, takeoffs or directly; breakRuns any breaks others' runs.
mep_connect
ProNeeds Allow editsIn the next releaseSet MEP run sizes
Sets one size on existing ducts, pipes, cable trays and conduits and says whether each connected fitting follows.
mep_size_set
ProNeeds Allow editsIn the next releaseCreate flex ducts and pipes
Draws flex ducts and flex pipes through points.
mep_flex_create
ProNeeds Allow editsIn the next releaseAdd insulation or lining
Adds insulation or lining of a thickness to ducts, pipes and their fittings and accessories.
mep_insulation_add
ProNeeds Allow editsIn the next releaseCreate electrical circuits
Makes electrical circuits from fixtures, devices and equipment, fed from a panel when given.
electrical_circuits_create
ProNeeds Allow editsIn the next releasePlace spaces
Places MEP spaces at points on a level, or one in every enclosed region of a level.
spaces_place
ProNeeds Allow editsIn the next release
Export0 available, 3 in the next release
Export views
Exports sheets and views to pdf, dwg or png files in a folder the person allowed.
export_views
ProNeeds Allow editsIn the next releaseExport a table
Exports a schedule, or an element query, to a csv or xlsx file in a folder the person allowed.
export_table
ProNeeds Allow editsIn the next releaseExport IFC
Exports the model, or what a 3D view shows, to an IFC file in a folder the person allowed.
export_ifc
ProNeeds Allow editsIn the next release
Review and undo what the assistant did1 available, 4 in the next release
Revert a change
Lists this session's changes, or reverts one change, whole or by refs or ops, as one undo step.
changes_revert
ProNeeds Allow editsList the change log
Reads the document's change log, newest first, kept across Revit sessions, with what was undone or never saved.
changes_list
FreeIn the next releaseVerify a change against its intent
Compares what a creation made with what it intended: position, type, level, host, size, and what is missing.
changes_verify
FreeIn the next releaseShow before and after of changes
Shows before and after of one change, or of every change of this session since a point.
changes_diff
FreeIn the next releaseCheck the model
Reads the model's health in one call: warnings, open MEP ends, duplicates, overlaps, rooms, hosts, clashes, housekeeping.
model_check
FreeIn the next release
Delete and purge0 available, 2 in the next release
Delete elements
Deletes the target elements and what Revit deletes with them, after a preview and the person's confirmation in Revit.
elements_delete
ProNeeds Allow edits and deletesIn the next releasePurge unused
Purges what Revit lists as unused, after a preview by category and the person's confirmation in Revit.
purge_unused
ProNeeds Allow edits and deletesIn the next release
Plans and several assistants0 available, 5 in the next release
Read the plans
Reads the document's plans: goals, tasks, their states, assignees and evidence.
plan_get
FreeIn the next releaseWrite a plan
Writes a plan the person reads in Revit before you build: goal, tasks, dependencies, budget.
plan_set
FreeIn the next releaseUpdate a plan
Reports progress on a plan: task status, notes, evidence and assignees; can add tasks.
plan_update
FreeIn the next releaseRegister an agent
Registers an agent of this connection (a sub-agent) and returns its secret handle, once.
agents_register
FreeIn the next releaseList the agents
Lists the agents working in this Revit with their role, state and what they write.
agents_list
FreeIn the next release
Something here wrong, or missing? Write to info@lavart.ai.