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

    Free
  • Query 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

    Free
  • Get elements

    Details of up to 50 elements by id: category, family, type, level, name, location, box, host, workset, owner, phase.

    elements_get

    Free
  • Summarise elements

    Counts the elements matching where, grouped by category, family, type, level, workset or a parameter: the context saver.

    elements_summarize

    Free
  • List parameter definitions

    Lists the parameters elements of some categories carry: name, storage, instance or type, shared, read-only.

    parameters_list_definitions

    Free
  • Get parameter values

    Reads parameter values of the target elements as Revit displays them, with units, paged.

    parameters_get

    Free
  • List types

    Lists the types of some categories with their family and how many instances each has.

    types_list

    Free
  • List views

    Lists views (not templates) with their type, level, scale, template and the sheet each is placed on.

    views_list

    Free
  • List sheets

    Lists sheets with number, name, title block, views and revision.

    sheets_list

    Free
  • List levels

    Lists the levels by elevation, and the grids.

    levels_list

    Free
  • Get schedules

    Lists schedules, or reads one schedule's definition (and its rows with data) in the form schedules_update takes.

    schedules_get

    Free
  • List warnings

    Lists Revit's warnings of the document, grouped by type with sample ids, or one row per warning.

    warnings_list

    Free
  • Get the selection

    Reads the elements selected in Revit now, as a table like elements_query.

    selection_get

    Free
  • Capture a view

    Captures a view, or a rectangle of a plan, as a PNG image with a pixel-to-model mapping (modelRect).

    view_capture

    Free
  • Get 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 release
  • List rooms

    Lists rooms with their state (placed, unplaced, not enclosed, redundant), area, point and phase, paged.

    rooms_list

    FreeIn the next release
  • Worksharing 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 release
  • List worksets

    Lists the worksets of the active document, which one is active, and their elements.

    worksets_list

    FreeIn the next release
  • List links and CAD imports

    Lists Revit, IFC and CAD links and CAD imports with their status and placement, paged.

    links_list

    FreeIn the next release
  • Tool 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

    Free
  • Open a view

    Opens a view in Revit, optionally zoomed to fit; changes no element.

    view_open

    FreeIn the next release
  • Calibrate 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 edits
  • Create grids

    Creates straight or arc grid lines in plan, with preview, trial and apply.

    grids_create

    ProNeeds Allow edits
  • Create 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 release
  • Place 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 release
  • Cut openings

    Cuts rectangular wall openings, slab openings from a loop, and shaft openings through levels.

    openings_create

    ProNeeds Allow editsIn the next release
  • Place 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 release
  • Load families

    Loads .rfa families from the folders the person allowed; overwrite reloads families already in the project.

    families_load

    ProNeeds Allow editsIn the next release
  • Create 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 release
  • Place 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 release
  • Place 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 release
  • Place family instances

    Places family instances (furniture, equipment, fixtures, terminals) at points, on levels, hosts or faces.

    elements_place

    ProNeeds Allow editsIn the next release
  • Link files

    Links Revit, IFC and DWG files from the folders the person allowed into the project.

    links_add

    ProNeeds Allow editsIn the next release
  • Create 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 release
  • Create 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 release
  • Create 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 edits
  • Duplicate 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 release
  • Create worksets, move elements

    Creates user worksets and moves elements into an open user workset.

    worksets_set

    ProNeeds Allow editsIn the next release
  • Rename types

    Renames element types, swaps included.

    types_rename

    ProNeeds Allow editsIn the next release
  • Change element types

    Gives the target elements another type of their category.

    elements_change_type

    ProNeeds Allow editsIn the next release
  • Set 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 release
  • Move, rotate or copy elements

    Moves, rotates or copies the target elements.

    elements_transform

    ProNeeds Allow editsIn the next release
  • Import 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 edits
  • Create views

    Creates floor and ceiling plans, sections, 3D and drafting views, or duplicates a view.

    views_create

    ProNeeds Allow editsIn the next release
  • Tag 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 release
  • Create text notes

    Writes text notes into views at given points.

    text_notes_create

    ProNeeds Allow editsIn the next release
  • Apply 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 release
  • Create schedules

    Creates schedules from a category, fields, filters, grouping and sorting, with preview, trial and apply.

    schedules_create

    ProNeeds Allow editsIn the next release
  • Change schedules

    Changes schedule definitions: fields, filters, grouping, sorting and itemize.

    schedules_update

    ProNeeds Allow editsIn the next release
  • Create sheets

    Creates sheets with a title block and places views on them.

    sheets_create

    ProNeeds Allow editsIn the next release
  • Rename and renumber sheets

    Renames and renumbers sheets, swaps included.

    sheets_update

    ProNeeds Allow editsIn the next release
  • Place 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 release
  • Update views

    Renames views and sets their scale, detail level and crop.

    views_update

    ProNeeds Allow editsIn the next release
  • Apply 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 release
  • Create 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 release
  • Create 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 release
  • Create 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 release
  • Create conduits

    Draws straight conduits of a type with diameter, joined at their ends if asked.

    conduits_create

    ProNeeds Allow editsIn the next release
  • Join 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 release
  • Set 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 release
  • Create flex ducts and pipes

    Draws flex ducts and flex pipes through points.

    mep_flex_create

    ProNeeds Allow editsIn the next release
  • Add 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 release
  • Create electrical circuits

    Makes electrical circuits from fixtures, devices and equipment, fed from a panel when given.

    electrical_circuits_create

    ProNeeds Allow editsIn the next release
  • Place 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 release
  • Export 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 release
  • Export 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 edits
  • List 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 release
  • Verify 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 release
  • Show 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 release
  • Check 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 release
  • Purge 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 release
  • Write a plan

    Writes a plan the person reads in Revit before you build: goal, tasks, dependencies, budget.

    plan_set

    FreeIn the next release
  • Update a plan

    Reports progress on a plan: task status, notes, evidence and assignees; can add tasks.

    plan_update

    FreeIn the next release
  • Register an agent

    Registers an agent of this connection (a sub-agent) and returns its secret handle, once.

    agents_register

    FreeIn the next release
  • List 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.