Skip to content
Back to search

horizun-revit-mcp

Open-source MCP for Autodesk Revit 2023–2027. Downloadable Windows installer with runtime included; no Git or .NET SDK required. Typed BIM automation, families and model verification.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/HorizunGroup/horizun-revit-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/HorizunGroup/horizun-revit-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/horizungroup--horizun-revit-mcp/badge.svg)](/listings/horizungroup--horizun-revit-mcp)

HTML

<a href="/listings/horizungroup--horizun-revit-mcp"><img src="/api/listings/horizungroup--horizun-revit-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**[Download the Windows installer](https://github.com/HorizunGroup/horizun-revit-mcp/releases/latest)**

- Requires **Windows x64, Revit 2023–2027 and an MCP client**. - Setup includes the server runtime and matching Revit add-ins. **No Git, Visual Studio or .NET SDK is needed.** - Close Revit before running Setup. - Public releases are intentionally **unsigned**. SHA-256 checks verify the downloaded bytes; they do not authenticate a Windows publisher. Windows and Revit may show a publisher warning. See the [unsigned release policy](CODE-SIGNING-POLICY.md).

1. Open the release above and download `horizun-mcp-<version>-setup.exe` and `SHA256SUMS.txt` from **Assets**. The source ZIP is for development. 2. Verify the hash using the [installation guide](docs/INSTALL.md), then run Setup. 3. Complete your client's connection step:

| Client | Final connection step | |---|---| | **Codex / Claude Code** | Let Setup's helper register after the client closes, then reopen it. | | **Claude Desktop** | Install the `.mcpb` delivered to **Documents\Horizun-Revit-MCP** from **Settings → Extensions**, then restart Claude Desktop. | | **ChatGPT Work** | Complete the Secure MCP Tunnel setup for the installed server. | | **Other stdio clients** | Register the installed executable using its full path. |

4. Start Revit, open a document and ask your client to call `horizun_health`. Confirm the active document and loaded version.

**Claude Desktop needs the extension installation inside the app.** Setup puts the package and illustrated instructions in the Documents folder above. Drag the package onto the Extensions page or use **Advanced settings → Install extension**. The extension connects to the installed server; it does not replace Setup. See [client instructions and recovery](docs/CLIENTS.md).

Installation video: Claude Desktop Free

**[Connect Revit to Claude Desktop Free — watch the installation tutorial](https://www.youtube.com/watch?v=3kp-we7MIvk)** is a Spanish-language guide published by Horizun Hub to installing and connecting Horizun Revit MCP with the free Claude Desktop plan. Follow the Setup and `.mcpb` steps above; the [client guide](docs/CLIENTS.md#claude-desktop) provides the written instructions.

Optional PowerShell bootstrap

This downloads the release installer, checks its hash and runs Setup quietly. `-AllowUnsigned` acknowledges the publisher status described above. The same client-specific final steps still apply; use `-Interactive` for the wizard.

$s = irm https://raw.githubusercontent.com/HorizunGroup/horizun-revit-mcp/main/install-release.ps1; & ([scriptblock]::Create($s)) -AllowUnsigned

The script is fetched from `main`; its checksum check applies to the downloaded Setup. You can download and inspect the script first. See [installation options](docs/INSTALL.md).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 652 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Horizun Revit MCP — model, document, coordinate and deliver in Revit
  2. **Made in Colombia 🇨🇴 by Horizun Group.**
  3. Horizun Revit MCP is a free, open-source Windows MCP server and Revit add-in for
  4. **Autodesk Revit 2023–2027**. Its complete catalog contains **125 tools** <!--inventory:tools-->
  5. with **481 named suboperations and dispatch modes** <!--inventory:operations-->
  6. for architectural and structural modeling, MEP, parametric families, drawings,
  7. CAD-to-BIM, model audits, quantities, Excel, Power BI and exports.
  8. Use natural-language objectives in your MCP client to create new BIM content,
  9. inspect existing models and carry out multi-step production workflows. Typed
  10. changes include rehearsal, explicit targets and post-commit verification;
  11. owner-enabled Python extends the bridge to task-specific Revit API automation.
  12. The downloadable Windows installer includes the server runtime and Revit add-ins.
  13. **English** · **[Español](README.es.md)**
  14. [![ci](https://img.shields.io/github/actions/workflow/status/HorizunGroup/horizun-revit-mcp/ci.yml?branch=main&label=ci&logo=githubactions&logoColor=white)](https://github.com/HorizunGroup/horizun-revit-mcp/actions/workflows/ci.yml) [![codeql](https://img.shields.io/github/actions/workflow/status/HorizunGroup/horizun-revit-mcp/codeql.yml?branch=main&label=codeql&logo=github)](https://github.com/HorizunGroup/horizun-revit-mcp/actions/workflows/codeql.yml) [![release](https://img.shields.io/github/v/release/HorizunGroup/horizun-revit-mcp?label=release&color=0696D7)](https://github.com/HorizunGroup/horizun-revit-mcp/releases/latest) [![Revit 2023–2027](https://img.shields.io/badge/Revit-2023%E2%80%932027-0696D7)](#install) [![MCP registry](https://img.shields.io/badge/MCP%20registry-io.github.HorizunGroup%2Fhorizun--revit--mcp-6E56CF)](https://registry.modelcontextprotocol.io/) [![license Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE) [![GitHub stars](https://img.shields.io/github/stars/HorizunGroup/horizun-revit-mcp?label=GitHub%20stars)](https://github.com/HorizunGroup/horizun-revit-mcp/stargazers)
  15. **[Download](https://github.com/HorizunGroup/horizun-revit-mcp/releases/latest)** ·
  16. **[Watch the demo](https://www.youtube.com/watch?v=tlFs5p3EM4M)** ·
  17. [What's new in 4.0](#whats-new-in-40-built-for-small-models) ·
  18. [Install with Claude Desktop Free](#installation-video-claude-desktop-free) ·
  19. [All tools](#complete-tool-catalog) · [Suboperations](#suboperations-and-modes) ·
  20. [Release evidence](#tested-in-revit-published-release-evidence) · [Install](#install)
  21. ## What's new in 4.0: built for small models
  22. Every tool an MCP server lists is sent to the model in every conversation. 4.0
  23. cuts that cost without removing a single capability, so cheaper and faster
  24. models (Claude Haiku, free plans, local models) can drive Revit.
  25. | What the model receives at the start | Tools listed | `tools/list` tokens (approx.) |
  26. |---|---:|---:|
  27. | Before 4.0: the full catalog | 125 | ~105 000 |
  28. | 4.0 default on a new install: `esencial` profile | 14 | ~18 100 |
  29. | `esencial` + `HORIZUN_SCHEMA_MODE=compact` | 14 | ~4 400 |
  30. | `local` toolset + `compact` (for local models) | 11 | ~3 850 |
  31. - **Tool profiles:** a new install starts with the `esencial` profile. Every other tool stays callable through `horizun_list_tools` (search in Spanish or English), `horizun_call_tool` and `horizun_activate_toolset`, which opens one more toolset for the session. Role profiles: `consulta`, `modelado`, `documentacion`, `auditoria`, `completo`. An upgrade keeps the full list. See [tool profiles](docs/CLIENTS.md#tool-profiles-a-shorter-list-at-the-start-of-every-session).
  32. - **Compact schemas:** `HORIZUN_SCHEMA_MODE=compact` shows short descriptions and only the common arguments; exact schemas are still served on demand.
  33. - **Measured, not estimated:** in a 27-task battery on an English Revit, Claude Haiku completed 26 of 27 tasks with 58 % fewer input tokens. qwen3:8b over Ollama completed 12 of 27 with 71–78 % fewer: local 8B models work for simple tasks, not yet for full production. See [small and local models](docs/CLIENTS.md#small-and-local-models) and the [measurements](docs/diagnostico-modelos-pequenos.md).
  34. No tool was removed or renamed and no required argument was added; the 4.0 number marks the new default experience.
  35. ## What's new in 3.0
  36. - **Steel:** typed reinforcement rules now cover bars crossing hosts, anchorage, laps, sections, slabs, foundations, walls, columns, couplers, crossing order and post-commit geometry audit. `horizun_read_schedule` reads vector PDF or DWG schedule cards and refuses ambiguous rows. See the [steel capability matrix](docs/plans/acero-3.0-matriz.md).
  37. - **Interoperability:** `horizun_exchange` emits and verifies `horizun.exchange/0` manifests, carries model identity, and checks review correction plans before and after applying them. See [tool details](docs/TOOLS-EXTENDED.md).
  38. - **Schema on demand:** `full` remains the default. Set `HORIZUN_SCHEMA_MODE=facade` per client to expose health and three server-side discovery/call tools, which retrieve exact schemas as needed. The measured reduction in `tools/list` size has not yet been paired with a completed agent comparison. See [client setup](docs/CLIENTS.md) and [measurements](docs/plans/lazy-schema-3.0.md).
  39. - **Local toolset:** `HORIZUN_TOOLSETS=local` narrows the advertised typed surface for short-context clients while preserving the permission gate. The schema mode and toolset are independent.
  40. For existing installations, follow [Migration to 3.0](docs/MIGRATION-3.0.md): protocol 3 requires the server and add-in to be updated together. [Release notes](docs/plans/release-notes-3.0.0.md) summarize the release.
  41. ## Product at a glance
  42. | Surface | What is available | Inspect it |
  43. |---|---|---|
  44. | MCP entry points | **125 tools** <!--inventory:tools-->, including **46 read-only** <!--inventory:reads--> and **79 with possible effects** <!--inventory:writes--> | [Generated inventory](docs/inventory.json) and full catalog below |
  45. | Internal actions | **481 named suboperations and dispatch modes** <!--inventory:operations--> inside multi-operation tools | Exact selector values below |
  46. | Revit coverage | 2023, 2024, 2025, 2026 and 2027 | Five matching add-ins and versioned live reports |
  47. | New model content | 26 element kinds; parametric RFA authoring; structural and MEP planning | [Creation and family reference](docs/FAMILY-AUTHORING.md) |
  48. | Drawings and deliverables | 24 view/sheet actions, 10 annotation actions, native schedules and sheet layout | [Planimetry production](docs/PLANIMETRY-PRODUCTION.md) |
  49. | Export targets | PDF, DWG, DGN, DWFx, IFC, NWC, FBX, gbXML, COBie, RFA families, images and schedule CSV | `horizun_export` |
  50. | Verified release example | 1,230 passed probe executions across five Revit years in **v1.3.3** | [Published reports](#tested-in-revit-published-release-evidence) |
  51. | Installation | Windows Setup with runtime included; no Git, Visual Studio or .NET SDK for end users | [Client-specific final steps](docs/CLIENTS.md) |
  52. Counts describe the complete product surface. The active permission profile and
  53. tool packs determine which tools a particular session exposes; the measured
  54. 70/79/80-tool profiles are explained below.
  55. ## What's new in 2.1
  56. Every item below is part of this release, was built with the same verified-write contract
  57. (rehearse, token, apply, re-read) and, where a fixture exists, was measured live in Revit.
  58. The detail of each one is in the [CHANGELOG](CHANGELOG.md).
  59. **New tools and new ways to build**
  60. 1. **Light-gauge framing, `horizun_framing`** — studs, tracks, kings, jacks, headers, sills, cripples and blocking inside a wall layer, and suspended-ceiling framing, from a detail spec the MCP client reads from an image or DWG (prompt `framing-from-detail`).
  61. 2. **Curtain-method framing** — the same framing modeled with Curtain Walls and flat Sloped Glazing layers (stud mullions, fixed-distance grids, hangers to the floor above), for teams that work that way.
  62. 3. **Exploding multilayer walls with openings** — `horizun_split_multilayer_walls` now converts walls that host doors, windows and nested components: the carrier keeps its identity and its inserts, and every layer becomes its own wall.
  63. 4. **COBie 2.4 workbook** — `horizun_export format=cobie`: Facility, Floor, Space, Zone, Type, Component and System sheets, re-read cell by cell, with `deliverable_ready` and a finding for every missing required value.
  64. 5. **New element kinds** — sprinkler, flex pipe, flex duct, space, area and area boundary in `horizun_create_elements`; rooms and spaces for every empty circuit (`placement=all_enclosed`); toposolids (Revit 2024+).
  65. 6. **Sketch editing without losing the element** — `edit_sketch` for floors, ceilings and openings keeps the id and the hosted data.
  66. **MEP and clash resolution**
  67. 7. **Automatic MEP routing** — `horizun_mep_routing route`: an orthogonal 3-D path around physical elements and links, with segments and elbows re-read at every junction.
  68. 8. **Gravity slopes** — `slope`: a pipe run to a target grade from a fixed end, every connection re-read.
  69. 9. **Hangers** — `hangers`: a caller family at spaced stations under the structure above (host or link).
  70. 10. **Openings and sleeves for clashes** — `horizun_resolve_clash propose_opening / apply_opening` cuts walls, floors, roofs and ceilings or places a sleeve family when a move cannot fix the clash.
  71. 11. **Clashes against links and connected runs** — moves are checked against every loaded link, and a connected pipe-elbow-pipe network moves as one rigid body (`run_shift`).
  72. 12. **System analysis** — `horizun_plan_mep system_analysis` reads the critical path, pressure loss, flow and velocity Revit computed.
  73. **Coordination, CDE and openBIM**
  74. 13. **ACC Issues** — `horizun_cde_cloud issues_list / issue_create / issue_update`, as the signed-in user, idempotent by an external key and read back after every write.
  75. 14. **Navisworks round trip** — readiness and preparation of the 3D views Navisworks reads, and status suggestions from the coordination ledger.
  76. 15. **BCF from any tool** — Navisworks, ACC, Solibri or BIMcollab topics (BCF 2.1/3.0) resolved by IFC GUID or authoring-tool id.
  77. 16. **ISO 19650 information management** — project context (`project-intake`), information containers across WIP/Shared/Published/Archived, and IFC delivery proved against IDS, Pset mapping and georeference.
  78. 17. **Synchronize with central** — `horizun_document_session sync_with_central`, off by default and enabled only by the machine owner in Revit; relinquish all, keep borrowed or none, verified after the sync.
  79. 18. **Shared coordinates, point clouds and scan deviation** — `acquire_coordinates`, point cloud links and `scan_deviation` of model faces against a scan, with coverage measured.
  80. **Verification you can see**
  81. 19. **Spatial check after every write** — overlaps, blocked doors, duplicates and MEP through structure are reported with the write; `horizun_verify_changes` returns an image with the changed elements highlighted.
  82. 20. **Before/after snapshots** — `snapshot / compare_to` with the same camera and a red diff mapped back to the elements written.
  83. 21. **Equipment clearance zones** — `clearance_rules` check working-space zones against host and links.
  84. 22. **Egress travel distance** — `horizun_code_check` with Revit's path of travel, reported as a lower bound or `not_decidable` with the reason.
  85. 23. **Energy readiness** — `energy_readiness` builds and rolls back the energy model and reports enclosure, constructions and window-to-wall ratio.
  86. **Documentation, quantities and exchange**
  87. 24. **More export formats** — DWG for many views or sheets in one job, gbXML, DGN, DWFx and loaded families to `.rfa`, each file read back.
  88. 25. **Finishes by room** — `horizun_quantities room_finishes`: wall, floor and ceiling faces per room or space, by material, with openings deducted.
  89. 26. **Budget export to BC3** — `horizun_budget_compare export_bc3` (FIEBDC-3) from the takeoff and the caller's prices.
  90. 27. **Sheets and views** — `renumber_sheets` with collisions checked first, and `set_view_display` fixes detail level or discipline citing the audit finding.
  91. 28. **Structural analytical model and loads** — `horizun_query_structure analytical` and `loads`, grouped by load case.
  92. 29. **Power BI coordination dashboard** — a `.pbip` example over the coordination ledger.
  93. 30. **A smaller tool list** — `tools/list` is about 64 KB smaller without removing a tool, argument or operation, so clients load it faster.
  94. ## Watch a real workflow: PDF plans to a Revit model
  95. [![Watch the Horizun demo: PDF plans to a Revit model with AI](https://i.ytimg.com/vi/tlFs5p3EM4M/hqdefault.jpg)](https://www.youtube.com/watch?v=tlFs5p3EM4M)
  96. **[PDF plans → Revit model with AI — watch on YouTube](https://www.youtube.com/watch?v=tlFs5p3EM4M)**
  97. is a published Spanish-language demonstration from the Horizun Hub channel.
  98. It presents a PDF-to-Revit workflow driven by an AI client. PDF interpretation
  99. belongs to the client/model; Horizun supplies the operations executed in Revit.
  100. The separate typed DWG workflow below reads CAD geometry and versioned rules.
  101. ## What you can build and deliver
  102. ### Architectural, structural and MEP modeling
  103. `horizun_create_elements` accepts dependency-aware batches of levels, grids,
  104. walls, floors, ceilings, roofs, rooms, family instances, structural beams and
  105. columns, beam systems, wall foundations, ducts, pipes, conduit, cable trays,
  106. fittings, inline accessories, MEP systems, openings, shafts, room separators,
  107. profile walls, displacement sets and supported stairs.
  108. The suboperation table lists all 26 creation kinds and five fitting choices.
  109. `horizun_transform_elements` handles moves, copies, rotations, wall joins,
  110. type/curve changes and tag placement. `horizun_manage_system_types` supports
  111. compound material-layer structures and MEP junction preferences.
  112. Structural and MEP planners produce requests that use these same creation tools.
  113. ### New parametric families, including MEP connectors
  114. `horizun_create_family` creates a new `.rfa` from an installed `.rft`: parameters,
  115. formulas, named types, solid/void extrusions, blends, revolutions, sweeps and
  116. swept blends; reference planes and labeled dimensions; supported nested families;
  117. and pipe, duct, electrical, conduit or cable-tray connectors. Save and optional
  118. project load are verified. `horizun_family_apply` edits existing family data with
  119. a geometry invariant. [RFA examples and template scope](docs/FAMILY-AUTHORING.md).
  120. ### Drawings, automated annotation and sheet production
  121. Build floor/ceiling/structural/area plans, sections, elevations, callouts, drafting
  122. and 3D views. Manage templates, phases, crops, view ranges and scope boxes; create,
  123. duplicate and populate sheets; place schedules and align viewports. Annotation
  124. tools support text, tags, linear/angular/radial/diameter/arc-length dimensions
  125. and spot elevation/coordinate/slope labels.
  126. Plan dimensions and tags from explicit criteria, inspect geometric references,
  127. create 2D details, audit planimetry, apply cited corrections and pack sheet zones.
  128. `horizun_plan_views` and the `deliverable-production` prompt coordinate delivery
  129. stages and approval state. [Drawing workflows](docs/PLANIMETRY-PRODUCTION.md).
  130. ### DWG to BIM, with traceable revision updates
  131. Inspect DWG instances, layers and curves. Supply a versioned requirement set to
  132. map drawing content into an ordered BIM plan. Rehearse and apply the plan through
  133. typed tools, with source fingerprints and provenance attached to created elements.
  134. Audit the model against the drawing; plan and apply later DWG revisions while
  135. identifying manual model edits that need review.
  136. These are seven dedicated CAD tools, listed individually below.
  137. [DWG-to-BIM examples](docs/DWG-TO-BIM.md).
  138. ### Audits, coordination, quantities and data exchange
  139. Query the host and loaded links using category, family/type, level, parameter and
  140. spatial filters. Scan model health, audit supplied requirements and make verified
  141. parameter corrections. Coordinate clashes with persistent findings, assignment,
  142. decisions and model-measured resolution. Plan reinforcement, apply supported
  143. reinforcement requests and audit their results.
  144. Produce material takeoffs, compare them against an Excel budget baseline, read
  145. or append XLSX rows without Excel/COM, push approved data to Power BI and export
  146. verified deliverables. [Quantities](docs/QUANTITIES-AND-BUDGET.md),
  147. [Power BI](docs/POWER-BI.md), [audit starter](docs/QUICK-START-BIM.md).
  148. ### Specialized model transformations and terrain
  149. Separate wall or slab layers, split floors by loops, rectangularize supported
  150. wall geometry, ungroup with origin tracking and regroup by a parameter. Transfer
  151. slab elevations, embed floors in toposolids and grade terrain with breaklines and
  152. specified slopes. Wall-layer decomposition preserves the core wall's identity
  153. and hosted elements. Bundled recipe tools use shipped Python for geometry under
  154. host-controlled rehearsal, transactions and their declared readback checks;
  155. arbitrary client-generated Python has a separate permission/evidence contract.
  156. ## Install
  157. **[Download the Windows installer](https://github.com/HorizunGroup/horizun-revit-mcp/releases/latest)**
  158. - Requires **Windows x64, Revit 2023–2027 and an MCP client**.
  159. - Setup includes the server runtime and matching Revit add-ins.
  160. **No Git, Visual Studio or .NET SDK is needed.**
  161. - Close Revit before running Setup.
  162. - From v4.0.1 Setup and every binary it installs are **signed** by HORIZUN GROUP
  163. S.A.S. (Certum), so Windows Smart App Control lets the server and the add-ins
  164. load. SHA-256 checks verify the downloaded bytes. Revit asks once to
  165. **Always Load** an add-in from a new publisher. See the [signing policy](CODE-SIGNING-POLICY.md).
  166. 1. Open the release above and download `horizun-mcp-<version>-setup.exe` and
  167. `SHA256SUMS.txt` from **Assets**. The source ZIP is for development.
  168. 2. Verify the hash using the [installation guide](docs/INSTALL.md), then run Setup.
  169. 3. Complete your client's connection step:
  170. | Client | Final connection step |
  171. |---|---|
  172. | **Codex / Claude Code** | Let Setup's helper register after the client closes, then reopen it. |
  173. | **Claude Desktop** | Install the `.mcpb` delivered to **Documents\Horizun-Revit-MCP** from **Settings → Extensions**, then restart Claude Desktop. |
  174. | **ChatGPT Work** | Complete the Secure MCP Tunnel setup for the installed server. |
  175. | **Other stdio clients** | Register the installed executable using its full path. |
  176. 4. Start Revit, open a document and ask your client to call `horizun_health`.
  177. Confirm the active document and loaded version.
  178. **Claude Desktop needs the extension installation inside the app.** Setup puts
  179. the package and illustrated instructions in the Documents folder above. Drag
  180. the package onto the Extensions page or use **Advanced settings → Install extension**.
  181. The extension connects to the installed server; it does not replace Setup.
  182. See [client instructions and recovery](docs/CLIENTS.md).
  183. ### Installation video: Claude Desktop Free
  184. [![Install Horizun Revit MCP with Claude Desktop Free](https://i.ytimg.com/vi/3kp-we7MIvk/hqdefault.jpg)](https://www.youtube.com/watch?v=3kp-we7MIvk)
  185. **[Connect Revit to Claude Desktop Free — watch the installation tutorial](https://www.youtube.com/watch?v=3kp-we7MIvk)**
  186. is a Spanish-language guide published by Horizun Hub to installing and connecting
  187. Horizun Revit MCP with the free Claude Desktop plan. Follow the Setup and `.mcpb`
  188. steps above; the [client guide](docs/CLIENTS.md#claude-desktop) provides the written instructions.
  189. ### Optional PowerShell bootstrap
  190. This downloads the release installer, checks its hash and runs Setup quietly.
  191. `-AllowUnsigned` is only needed for an old release with an unsigned Setup (before
  192. v3.0.2); for a signed Setup it changes nothing. The same
  193. client-specific final steps still apply; use `-Interactive` for the wizard.
  194. ```powershell
  195. $s = irm https://raw.githubusercontent.com/HorizunGroup/horizun-revit-mcp/main/install-release.ps1; & ([scriptblock]::Create($s)) -AllowUnsigned
  196. ```
  197. The script is fetched from `main`; its checksum check applies to the downloaded
  198. Setup. You can download and inspect the script first. See [installation options](docs/INSTALL.md).
  199. ## Complete tool catalog
  200. Every named MCP tool is listed here, grouped by the work it performs. These groups
  201. are a reading aid; session **tool packs** are the configurable sets implemented
  202. in [ToolPacks.cs](src/Horizun.Revit/Core/ToolPacks.cs). Descriptions are maintained
  203. in [the bilingual catalog](docs/readme-catalog.json); counts and membership are
  204. checked against the server-generated [inventory](docs/inventory.json).
  205. The [detailed tool reference](docs/TOOLS.md) documents arguments and limitations.
  206. <!-- BEGIN TOOL CATALOG -->
  207. ### Connection, documents and background jobs
  208. | Tool | Capability |
  209. |---|---|
  210. | `get_document_info` | Inspect the open document's identity and element counts. |
  211. | `horizun_document_session` | Inspect, open, save, save-as and close documents, or create a blank project from a template, through explicit session operations. |
  212. | `horizun_file_info` | Read RVT/RFA headers, version and worksharing metadata without opening or upgrading them. |
  213. | `horizun_health` | Report bridge health, active document, version, commit and Python runtime state. |
  214. | `horizun_job_status` | Read progress and recovery state while Revit is busy or after a process restart. |
  215. | `horizun_open_document` | Open a model with checks for version upgrades and workshared central files. |
  216. | `horizun_relinquish_all` | Release owned worksharing elements and report remaining ownership. |
  217. | `horizun_repair_memory` | Report and recover durable state this bridge keeps when a record is unreadable. |
  218. | `horizun_save_document` | Save and inspect the resulting file's timestamp and size. |
  219. | `horizun_selection_exchange` | Read what a person selected in Revit, and offer a set back for them to select. |
  220. | `horizun_submit_job` | Submit long-running Revit operations with a persistent job identifier. |
  221. | `horizun_target` | Select the Revit instance to control when multiple sessions or years are open. |
  222. ### Model queries, audits and correction
  223. | Tool | Capability |
  224. |---|---|
  225. | `horizun_apply_corrections` | Rehearse and apply supported audit corrections with per-result verification. |
  226. | `horizun_apply_ifc_plan` | Carry out an IFC plan through typed commands that rehearse and re-read their own work. |
  227. | `horizun_audit_access` | Report what this bridge is allowed to do on this machine and who decided it. |
  228. | `horizun_audit_model` | Evaluate supplied model requirements with findings, coverage and prevention-gate evidence. |
  229. | `horizun_capture_view` | Export the active or named view as an image for visual review by the client. |
  230. | `horizun_verify_changes` | Check what the last write changed for spatial conflicts and return an image with them highlighted. |
  231. | `horizun_delete_verified` | Delete explicit IDs or purge unused content; preview cascades and verify removals. |
  232. | `horizun_list_elements` | List and paginate elements across the host and loaded Revit links with model identity. |
  233. | `horizun_model_scan` | Measure model health, warnings, worksets, links, families, views and cleanup candidates. |
  234. | `horizun_navigate` | Select elements, clear selection, zoom and open views. |
  235. | `horizun_plan_from_ifc` | Plan Revit elements from an IFC file under a declared mapping, without importing it. |
  236. | `horizun_query_model` | Filter by category, type, level, parameters and spatial bounds; project fields and return grouped or compact summaries. |
  237. | `horizun_validate_ids` | Check a model against an IDS specification and report each requirement it fails. |
  238. | `horizun_query_classification` | Read the keynote and assembly-code tables, their use in the model, missing and unused codes, and families' lookup tables. |
  239. | `horizun_model_diff` | Snapshot models and compare deliveries: added, deleted and changed elements with parameters, a coloured view, a plain summary and quality history. |
  240. | `horizun_code_check` | Check the model against declarative requirement sets, including Colombian accessibility, egress and lighting rules, with not_decidable instead of guesses. |
  241. | `horizun_undo` | List and undo the last verified Horizun batch, refusing when the model or file changed since. |
  242. ### Model creation, parameters and families
  243. | Tool | Capability |
  244. |---|---|
  245. | `horizun_bind_shared_param` | Bind shared parameters to categories and inspect group-variation behavior. |
  246. | `horizun_copy_between_documents` | Copy elements between open documents, keeping identity and reporting what was substituted. |
  247. | `horizun_create_elements` | Create levels, grids, walls, slabs, roofs, rooms, family instances, structural members, MEP runs, openings and stairs in typed batches. |
  248. | `horizun_create_family` | Create new parametric RFA files: solid/void forms, parameters, formulas, types, nested families and MEP connectors; optionally load them. |
  249. | `horizun_family_apply` | Apply family edits in a transaction with a geometry invariant and rollback on drift. |
  250. | `horizun_manage_materials` | Read, create and assign materials and their appearance and identity data. |
  251. | `horizun_manage_system_types` | Duplicate system types; edit parameters, wall/slab/roof/ceiling layer structures and MEP junction preferences. |
  252. | `horizun_set_keynote` | Assign keynote values with the affected instance/type scope made explicit. |
  253. | `horizun_transform_elements` | Move, copy, rotate, pin, change types or curves and adjust tag heads/leaders over explicit targets. |
  254. | `horizun_write_params_verified` | Write parameter values in batches and re-read each requested value. |
  255. | `horizun_manage_parameters` | Read the full binding map, create and bind shared parameters, rebind or remove bindings, and manage Global Parameters. |
  256. | `horizun_manage_curtain` | Read and edit curtain grids: grid lines, mullions and panel types, re-measured after each change. |
  257. | `horizun_slab_shape` | Edit floor and roof shape: points, split lines and vertex elevations, with a reset. |
  258. | `horizun_create_railing` | Create railings on stairs or ramps, or from a sketched path on a level. |
  259. | `horizun_manage_phases` | Read phases, filters and design options; set element phases and create or edit phase filters. |
  260. | `horizun_manage_assemblies_parts` | Create, divide, exclude and dissolve parts; create assemblies with their views and disassemble them. |
  261. | `horizun_manage_styles` | Read and set object styles, subcategories, line styles, line patterns and fill patterns. |
  262. | `horizun_manage_units` | Read and set project units, Project Information and the base and survey points (with explicit consent). |
  263. ### Drawings, dimensions, sheets and schedules
  264. | Tool | Capability |
  265. |---|---|
  266. | `horizun_manage_views` | Create and configure plans, sections, elevations, callouts, 3D views, sheets, viewports and schedule placements. |
  267. | `horizun_plan_views` | Plan room views and deliverable sets; track delivery status, approvals and invalidation. |
  268. | `horizun_query_planimetry` | Inspect sheets, views, placements, annotations and drawing references with geometry and coverage. |
  269. | `horizun_audit_planimetry` | Audit drawing requirements and return cited findings for correction. |
  270. | `horizun_fix_planimetry` | Correct cited view, sheet, title-block, viewport, schedule and crop findings. |
  271. | `horizun_pack_sheets` | Place views and schedules within supplied sheet zones and check resulting placements. |
  272. | `horizun_plan_annotations` | Plan automatic tags and dimensions for grids, levels, curtain walls and openings using explicit criteria. |
  273. | `horizun_annotate` | Create text, tags, linear/angular/radial/diameter/arc-length dimensions and spot elevations, coordinates or slopes. |
  274. | `horizun_get_dimension_references` | Discover geometric references that can be used in dimension requests. |
  275. | `horizun_query_dimensions` | Inspect existing dimensions, segments, references and measured values. |
  276. | `horizun_edit_dimensions` | Apply supported dimension edits and verify the resulting dimension state. |
  277. | `horizun_query_detail_2d` | Read a view's detail geometry, line styles, region types and placeable symbols. |
  278. | `horizun_detail_2d` | Create detail lines/arcs/polylines, filled/masking regions and components in verified atomic batches. |
  279. | `horizun_manage_revisions` | Create and update drawing revision records. |
  280. | `horizun_create_schedule` | Create a native schedule with selected fields, sorting and optional linked elements. |
  281. | `horizun_manage_schedules` | Create, duplicate and configure schedules, material takeoffs, sheet/view lists, revision schedules and keynote legends. |
  282. | `horizun_list_schedules` | List schedules and inspect fields, linked-file settings and displayed dimensions. |
  283. | `horizun_get_schedule_data` | Read displayed schedule cells with explicit row/column bounds and truncation information. |
  284. ### CAD / DWG to BIM and revision updates
  285. | Tool | Capability |
  286. |---|---|
  287. | `horizun_apply_cad_plan` | Build the plan through typed commands; verify source hashes and stamp created elements with CAD provenance. |
  288. | `horizun_apply_cad_update` | Apply supported revision changes and preserve provenance for the next update. |
  289. | `horizun_audit_cad_model` | Compare the drawing against the model using provenance, geometry and measured differences. |
  290. | `horizun_cad_connect` | Build the joins a drawing declares, placing the fitting each junction needs and verifying it. |
  291. | `horizun_cad_extract` | Extract CAD geometry and, with a readable source DWG, text; plan detail transfer with measured gaps. |
  292. | `horizun_cad_networks` | Derive the network a drawing describes: which ends meet, what belongs between them and which stay open. |
  293. | `horizun_cad_review` | Report what a conversion could not settle, with the evidence for each held candidate. |
  294. | `horizun_cad_symbols` | List the block symbols a drawing defines and where each one is placed. |
  295. | `horizun_cad_unit_instances` | Find repeated units in a drawing and the transform that places each occurrence. |
  296. | `horizun_manage_cad_links` | List, add, reload and repoint CAD links with measured state. |
  297. | `horizun_plan_cad_update` | Plan changes between DWG revisions while identifying manual model edits that need review. |
  298. | `horizun_plan_from_cad` | Interpret a DWG using supplied versioned rules and return a dependency-ordered BIM plan with omissions and provenance. |
  299. | `horizun_query_cad` | Inspect DWG instances, layers, curve geometry, profiles and readable coverage. |
  300. ### Structure, reinforcement, MEP and coordination
  301. | Tool | Capability |
  302. |---|---|
  303. | `horizun_acc_upload_status` | Read Desktop Connector log evidence of ACC folder assignment for local files. |
  304. | `horizun_apply_reinforcement` | Apply supported reinforcement plans with typed checks and verification. |
  305. | `horizun_audit_reinforcement` | Audit reinforcement against supplied requirements and report coverage. |
  306. | `horizun_clash` | Detect scoped clashes, plan supported penetrations and record coordination findings. |
  307. | `horizun_connect_mep` | Connect or disconnect named MEP connectors, refusing to close a visible gap by moving geometry. |
  308. | `horizun_coordination` | Track coordination findings, assignments, decisions, evidence and model-detected resolution or regression. |
  309. | `horizun_manage_links` | Manage Revit links and screen linked-view candidates with explicit uncertainty. |
  310. | `horizun_plan_mep` | Plan pipe/duct routes and fittings; inspect networks through actual connector connectivity. |
  311. | `horizun_read_schedule` | Read reinforcement schedule sheets (vector PDF, DWG entities) into bar rows and named self-checks, and propose beam cards as a requirement set keyed by mark; refuse what cannot be read. |
  312. | `horizun_plan_reinforcement` | Plan reinforcement from supplied host and reinforcement requirements. |
  313. | `horizun_plan_structure` | Plan columns at grid intersections and beams along consecutive grid crossings. |
  314. | `horizun_query_structure` | Inspect members, hosts, cover, rebar, reinforcement systems, connections and quantities. |
  315. | `horizun_structural_connections` | Read and apply structural connection types between framing elements. |
  316. | `horizun_mep_routing` | Read and edit routing preferences and catalogue sizes, resize MEP runs to catalogue sizes and plan sizes by flow. |
  317. | `horizun_electrical` | List panels and circuits, create circuits, assign panels, add or remove elements and create panel schedules. |
  318. | `horizun_resolve_clash` | Propose and apply the smallest safe move for MEP clashes, proved by re-detecting and rolled back if anything new clashes. |
  319. | `horizun_federation_check` | Check that each federated model holds only its disciplines, its expected links and coherent shared coordinates. |
  320. ### Layers, groups and terrain
  321. | Tool | Capability |
  322. |---|---|
  323. | `horizun_split_floor_loops` | Split a floor by sketch loops while carrying height offsets. |
  324. | `horizun_split_multilayer_walls` | Separate wall layers while retaining the original core wall identity and its hosted elements. |
  325. | `horizun_framing` | Build light-gauge stud framing inside a wall layer and suspended-ceiling framing (mains, furring, perimeter, hangers to the structure) from a detail spec, verified, readable and removable. |
  326. | `horizun_split_multilayer_slabs` | Separate floor/ceiling material layers with profile preservation and per-slab rollback. |
  327. | `horizun_rectangularize_walls` | Decompose supported orthogonal wall geometry into rectangular fragments. |
  328. | `horizun_ungroup_and_mark` | Ungroup model groups while recording each member's source group. |
  329. | `horizun_regroup_by_param` | Rebuild model groups from a supplied grouping parameter. |
  330. | `horizun_copy_slab_elevations` | Transfer a shaped floor surface onto explicit destination floors. |
  331. | `horizun_embed_floors_in_toposolid` | Embed floor outlines and elevations into a toposolid. |
  332. | `horizun_grade_toposolid_around_floors` | Grade terrain around floors with offsets, breaklines and specified side slopes. |
  333. | `horizun_manage_groups` | Manage groups, find duplicates, preview annotations and preserve pattern placement. |
  334. | `horizun_manage_worksets` | List, create and rename worksets, move elements between them and set per-view visibility. |
  335. ### Quantities, Excel, Power BI and deliverables
  336. | Tool | Capability |
  337. |---|---|
  338. | `horizun_quantities` | Measure volumes and material takeoffs with units, grouping and model provenance. |
  339. | `horizun_budget_compare` | Compare model quantities against an Excel baseline; optionally write approved Excel/Power BI outputs. |
  340. | `horizun_catalog_lookup` | Resolve items from a supplied catalog with leaf-status and file-hash provenance. |
  341. | `horizun_excel_read_rows` | Read XLSX rows, types and cached formula values without Excel or COM. |
  342. | `horizun_excel_write_rows` | Append XLSX rows (or start a new workbook), keep a backup in the Horizun state folder and re-read written cells without Excel or COM. |
  343. | `horizun_power_bi_push` | Send rows to a Power BI push semantic-model table with durable replay protection and destination receipts. |
  344. | `horizun_export` | Export PDF, DWG, IFC, NWC, FBX, images and schedule CSV with output-file verification. |
  345. | `horizun_link_schedule` | Import MS Project, Primavera or CSV schedules, link activities to elements, write dates and colour a 4D status view. |
  346. ### Composable workflows and custom API automation
  347. | Tool | Capability |
  348. |---|---|
  349. | `horizun_execute_plan` | Compose up to 100 typed actions with dependencies, prior-result references and TransactionGroup rollback. |
  350. | `horizun_execute_python` | Run client-generated Python against the Revit API, including preflight and script-supplied evidence; owner opt-in required. |
  351. | `horizun_promote_script` | Promote a verified script to a named procedure so it stops being ad-hoc code. |
  352. | `horizun_request_python_access` | Show an owner-approval request in Revit for custom Python execution. |
  353. | `horizun_run_procedure` | Run a named, versioned procedure that this machine has stored, with its own consent. |
  354. ### ISO 19650 information management and openBIM delivery
  355. | Tool | Capability |
  356. |---|---|
  357. | `horizun_project_context` | Validate, question and draft the project's ISO 19650 context: appointment, EIR/BEP/MIDP, CDE states, naming, delivery; register its models by strong identity evidence. |
  358. | `horizun_exchange` | Wrap a cross-app hop in a verified horizun.exchange/0 manifest, check one before consuming it, and reconcile a review's correction plan. |
  359. | `horizun_information_container` | Name, seal, verify, inspect and transition information containers across WIP, Shared, Published and Archived folders. |
  360. | `horizun_deliver_ifc` | Export an IFC and prove it: IDS on the file, property-set mapping coverage, georeference, BCF of failures and a sealed container. |
  361. | `horizun_cde_cloud` | Read a cloud CDE (Autodesk Construction Cloud or an OpenCDE server) by state and cross it against the MIDP, read-only. |
  362. <!-- END TOOL CATALOG -->
  363. ## Suboperations and modes
  364. A named MCP tool can dispatch many actions. For example, creating a wall, a pipe
  365. and a stair are choices under `horizun_create_elements`; creating a section and
  366. placing a schedule are different actions under `horizun_manage_views`.
  367. The table contains **481 named suboperations and dispatch modes** <!--inventory:operations-->
  368. across 26 multi-operation tools. A choice is counted once per tool, selector
  369. property and value, including nested selectors. Repeated `oneOf` schema paths
  370. are deduplicated. Some selectors refine another action: these numbers describe
  371. the exposed operation vocabulary, not 208 additional top-level tools.
  372. <!-- BEGIN SUBOPERATIONS -->
  373. | Tool | Selector | Named suboperations and modes |
  374. |---|---|---|
  375. | `horizun_document_session` | `operation` | `open`, `save`, `save_as`, `close`, `inspect`, `sync_with_central`, `new_project` |
  376. | `horizun_repair_memory` | `operation` | `list`, `advice`, `observe`, `remedy`, `quarantine`, `release` |
  377. | `horizun_selection_exchange` | `operation` | `publish`, `read`, `clear`, `capabilities` |
  378. | `horizun_audit_model` | `operation` | `save`, `save_as`, `sync_with_central`, `export`, `publish`, `close_with_save`, `batch_open_close` |
  379. | `horizun_verify_changes` | `operation` | `check`, `snapshot`, `compare_to` |
  380. | `horizun_delete_verified` | `mode` | `ids`, `purge_unused` |
  381. | `horizun_navigate` | `operation` | `select`, `clear_selection`, `zoom`, `select_and_zoom`, `open_view` |
  382. | `horizun_validate_ids` | `operation` | `precheck`, `validate` |
  383. | `horizun_query_classification` | `operation` | `keynote_table`, `assembly_code`, `family_lookup_tables`, `unused_codes`, `missing_codes` |
  384. | `horizun_model_diff` | `operation` | `snapshot`, `list`, `compare`, `colorize`, `explain`, `record_quality`, `quality_trend` |
  385. | `horizun_code_check` | `operation` | `check`, `travel_distance`, `energy_readiness`, `headroom` |
  386. | `horizun_undo` | `operation` | `list`, `undo_last` |
  387. | `horizun_create_elements` | `kind` | `level`, `grid`, `wall`, `floor`, `ceiling`, `roof`, `room`, `family_instance`, `sprinkler`, `structural_framing`, `structural_column`, `duct`, `pipe`, `conduit`, `cable_tray`, `flex_pipe`, `flex_duct`, `fitting`, `wall_opening`, `slab_opening`, `beam_system`, `wall_foundation`, `accessory_inline`, `mep_system`, `shaft`, `room_separator`, `space`, `area`, `area_boundary`, `wall_profile`, `displacement`, `stairs`, `toposolid` |
  388. | `horizun_create_elements` | `fitting` | `elbow`, `union`, `transition`, `tee`, `takeoff`, `cross` |
  389. | `horizun_create_family` | `kind` | `extrusion`, `blend`, `revolution`, `sweep`, `swept_blend`, `pipe`, `duct`, `electrical`, `conduit`, `cable_tray`, `symbolic`, `model` |
  390. | `horizun_manage_materials` | `operation` | `create`, `duplicate`, `update` |
  391. | `horizun_transform_elements` | `operation` | `wall_join`, `move`, `copy`, `rotate`, `mirror`, `pin`, `unpin`, `change_type`, `change_type_by_rule`, `realign_wall_sketch`, `set_curve`, `move_tag_head`, `set_tag_leader`, `array_linear`, `array_radial`, `rename_level`, `edit_sketch` |
  392. | `horizun_manage_parameters` | `operation` | `list_bindings`, `create_shared`, `create_project`, `rebind`, `remove_binding`, `global_list`, `global_create`, `global_set`, `global_delete` |
  393. | `horizun_manage_curtain` | `operation` | `read`, `add_grid_line`, `remove_grid_line`, `set_mullions`, `set_panel_type` |
  394. | `horizun_manage_curtain` | `mode` | `add`, `remove` |
  395. | `horizun_slab_shape` | `operation` | `read`, `add_point`, `add_split_line`, `modify_subelement`, `reset_shape` |
  396. | `horizun_manage_phases` | `operation` | `list`, `element_status`, `set_element_phases`, `create_phase_filter`, `edit_phase_filter`, `rename_phase`, `create_phase`, `assign_design_option` |
  397. | `horizun_manage_assemblies_parts` | `operation` | `list`, `create_parts`, `divide_parts`, `exclude_parts`, `restore_parts`, `dissolve_parts`, `create_assembly`, `assembly_views`, `disassemble` |
  398. | `horizun_manage_styles` | `operation` | `list_object_styles`, `set_object_style`, `create_subcategory`, `list_line_styles`, `create_line_style`, `list_line_patterns`, `create_line_pattern`, `list_fill_patterns`, `create_fill_pattern` |
  399. | `horizun_manage_units` | `operation` | `read`, `set`, `project_information`, `base_points` |
  400. | `horizun_manage_views` | `operation` | `create_floor_plan`, `create_ceiling_plan`, `create_structural_plan`, `create_area_plan`, `create_3d`, `create_drafting`, `create_section`, `create_elevation`, `create_callout`, `duplicate_view`, `apply_template`, `set_phase`, `assign_scope_box`, `set_view_range`, `set_crop`, `set_annotation_crop`, `create_sheet`, `create_placeholder_sheet`, `convert_placeholder_sheet`, `duplicate_sheet`, `place_view`, `place_schedule`, `set_viewport_type`, `align_viewports`, `create_filter`, `apply_filter`, `color_by_value`, `set_element_overrides`, `hide_elements`, `isolate_elements`, `reset_temporary`, `set_category_visibility`, `create_legend`, `place_legend_component`, `edit_filter`, `order_filters`, `explain_graphics`, `create_template`, `set_template_controls`, `sheet_set_list`, `sheet_set_create`, `sheet_set_update`, `sheet_set_delete`, `renumber_sheets`, `create_perspective`, `set_sun_study` |
  401. | `horizun_manage_views` | `mode` | `center`, `center_x`, `center_y`, `left`, `right`, `top`, `bottom` |
  402. | `horizun_plan_views` | `operation` | `room_views`, `deliverable_set`, `delivery_open`, `delivery_status`, `delivery_record`, `delivery_approve`, `delivery_invalidate` |
  403. | `horizun_query_planimetry` | `mode` | `inventory`, `sheets`, `views`, `placements`, `annotations`, `references` |
  404. | `horizun_fix_planimetry` | `operation` | `set_view_template`, `set_view_scale`, `rename_view`, `rename_sheet`, `place_title_block`, `move_viewport`, `move_schedule`, `clear_element_override`, `set_crop`, `set_view_display` |
  405. | `horizun_plan_annotations` | `operation` | `auto_tags`, `intent_dimension`, `dimension_set`, `auto_dimension_grids`, `auto_dimension_levels`, `auto_dimension_curtain_walls`, `auto_dimension_openings` |
  406. | `horizun_annotate` | `operation` | `text`, `tag`, `dimension`, `angular_dimension`, `radial_dimension`, `diameter_dimension`, `arc_length_dimension`, `spot_elevation`, `spot_coordinate`, `spot_slope` |
  407. | `horizun_query_detail_2d` | `mode` | `resources`, `elements` |
  408. | `horizun_detail_2d` | `operation` | `create_detail_line`, `create_detail_arc`, `create_detail_polyline`, `create_filled_region`, `create_masking_region`, `place_detail_component`, `place_symbol`, `set_line_style` |
  409. | `horizun_manage_revisions` | `operation` | `create_revision`, `update_revision` |
  410. | `horizun_manage_schedules` | `operation` | `create`, `duplicate`, `rename`, `add_fields`, `remove_fields`, `set_field`, `set_filters`, `set_sorting`, `set_options` |
  411. | `horizun_manage_schedules` | `kind` | `material_takeoff`, `sheet_list`, `view_list`, `revision_schedule`, `keynote_legend` |
  412. | `horizun_cad_connect` | `fitting` | `direct`, `elbow`, `tee`, `cross`, `transition`, `none` |
  413. | `horizun_manage_cad_links` | `operation` | `list`, `add`, `reload`, `repoint` |
  414. | `horizun_query_cad` | `mode` | `instances`, `layers`, `geometry`, `coverage`, `profile`, `blocks` |
  415. | `horizun_connect_mep` | `operation` | `connect`, `disconnect` |
  416. | `horizun_coordination` | `operation` | `list`, `update`, `export`, `import`, `import_navisworks`, `show`, `evidence`, `navisworks_readiness`, `prepare_navisworks`, `navisworks_status` |
  417. | `horizun_manage_links` | `operation` | `list`, `visible_elements`, `unload`, `reload`, `pin`, `unpin`, `add`, `add_instance`, `change_path`, `acquire_coordinates`, `scan_deviation` |
  418. | `horizun_manage_links` | `kind` | `rvt`, `point_cloud`, `ifc` |
  419. | `horizun_plan_mep` | `operation` | `route_run`, `network_census`, `system_analysis` |
  420. | `horizun_plan_mep` | `kind` | `pipe`, `duct` |
  421. | `horizun_plan_structure` | `operation` | `columns_on_grid_intersections`, `beams_along_grids` |
  422. | `horizun_query_structure` | `mode` | `members`, `hosts`, `covers`, `rebar`, `reinforcement_systems`, `connections`, `coverage`, `quantities`, `analytical`, `loads`, `reconcile`, `bending_schedule`, `parse_notation`, `compare_bars`, `steel_review` |
  423. | `horizun_mep_routing` | `operation` | `read`, `set_rules`, `add_sizes`, `remove_sizes`, `resize`, `slope`, `size_by_flow`, `route`, `hangers` |
  424. | `horizun_mep_routing` | `kind` | `pipe`, `duct`, `conduit`, `cable_tray` |
  425. | `horizun_mep_routing` | `action` | `add`, `remove`, `move` |
  426. | `horizun_electrical` | `operation` | `list_panels`, `list_circuits`, `create_circuit`, `assign_panel`, `add_to_circuit`, `remove_from_circuit`, `panel_schedule` |
  427. | `horizun_resolve_clash` | `operation` | `propose`, `apply`, `propose_opening`, `apply_opening` |
  428. | `horizun_framing` | `operation` | `wall`, `ceiling`, `read`, `remove` |
  429. | `horizun_manage_groups` | `operation` | `list`, `find_duplicates`, `annotation_report`, `create`, `add_members`, `remove_members`, `rename_type`, `duplicate_type`, `swap_type`, `change_group_type`, `set_group_level`, `place_group`, `ungroup`, `convert_to_link` |
  430. | `horizun_manage_worksets` | `operation` | `list`, `create`, `rename`, `move_elements`, `set_default`, `visibility` |
  431. | `horizun_quantities` | `mode` | `volume`, `takeoff`, `room_finishes`, `carbon` |
  432. | `horizun_budget_compare` | `operation` | `compare`, `export_bc3` |
  433. | `horizun_catalog_lookup` | `operation` | `leaf`, `search`, `bsdd_search`, `bsdd_search_dictionary`, `bsdd_class`, `bsdd_property`, `bsdd_dictionaries` |
  434. | `horizun_link_schedule` | `operation` | `import`, `match`, `write`, `status_view` |
  435. | `horizun_execute_plan` | `kind` | `plan`, `section`, `elevation` |
  436. | `horizun_promote_script` | `operation` | `list`, `show`, `propose`, `review`, `approve`, `activate`, `deactivate`, `source`, `resolve`, `invocation` |
  437. | `horizun_run_procedure` | `operation` | `start`, `advance`, `decide`, `record`, `reconcile`, `status`, `abandon` |
  438. | `horizun_project_context` | `operation` | `schema`, `validate`, `questions`, `draft`, `elicit`, `ids_from_loin`, `integrations`, `register_model`, `resolve_model` |
  439. | `horizun_exchange` | `operation` | `emit`, `verify`, `correction_plan_check`, `correction_plan_reverify` |
  440. | `horizun_exchange` | `kind` | `coordination.ledger`, `coordination.status`, `quantities.rows`, `schedule.element_4d`, `model.element_lineage`, `receipt` |
  441. | `horizun_information_container` | `operation` | `name`, `stamp`, `verify`, `inspect`, `transition`, `transmittal`, `record_review`, `register` |
  442. | `horizun_cde_cloud` | `operation` | `list_projects`, `list_states`, `inspect`, `versions`, `issues_list`, `issue_create`, `issue_update` |
  443. <!-- END SUBOPERATIONS -->
  444. Other typed options include the seven `horizun_export.format` values:
  445. `pdf`, `dwg`, `ifc`, `nwc`, `fbx`, `image`, `schedule_csv`. The schema inventory
  446. also records **1653 enumerated argument occurrences** <!--inventory:enumerated_variants-->
  447. across all properties and paths; that figure includes configuration choices and
  448. repeated paths, so it is not used as a tool count.
  449. ## Extensibility, permissions and tool discovery
  450. **Compose new workflows:** `horizun_execute_plan` connects up to 100 typed actions
  451. using prior results and named dependencies, with TransactionGroup rollback.
  452. Task-specific project standards, catalogs and CAD interpretation rules are inputs.
  453. **Extend to custom Revit API work:** an owner may enable `horizun_execute_python`
  454. for client-generated Python, including the standard library, preflight and
  455. structured script evidence. The Python ON/OFF grant persists until revoked.
  456. Python results remain self-reported with `host_verified: false`.
  457. The following profiles were measured against the same **1.3.3** server binary
  458. in isolated settings directories using actual MCP `tools/list` calls:
  459. | Profile and packs | Tools announced | Why |
  460. |---|---:|---|
  461. | `safe_write`, all packs, Python off | 70 | Default in-model work; external-effect tools are filtered |
  462. | `full_write`, all packs, Python off | 79 | Adds file/export/document and other external-effect operations |
  463. | `unsafe_code`, all packs, Python enabled | 80 | Complete catalog, including custom Python |
  464. | `safe_write`, `core` only | 4 | Deliberately minimal connection and job-management set |
  465. A session exposing fewer tools can be correctly configured for a narrow task.
  466. Inspect `horizun_health` and the `horizun://security/current-profile` resource
  467. before comparing a session with the complete catalog. Owners control permissions;
  468. an evaluator does not need to enable arbitrary code just to read the catalog.
  469. For clients that support them, the server also offers standard MCP Resources,
  470. Prompts, Completions, logging and durable Tasks. Resources expose the compiled
  471. tool contract, build identity, effective profile and BIM workflow guidance.
  472. Named prompts cover family recipes, room documentation, audits and delivery.
  473. These protocol features and workflow prompts are additional to the tool count.
  474. `tools/list` schemas are abridged; the exact one is `horizun://contract/tools/{tool}`
  475. (or `.../{tool}/{variant}` for one `create_elements` kind or `document_session`
  476. operation), and a failed call that violates it names the failing path and that URI
  477. (with `structuredContent.schema_help` when the reply is structured) ([details](docs/TOOLS-EXTENDED.md#advertised-schemas-and-the-contract)).
  478. Tool packs, compact/summary queries, selected-field projections and durable jobs
  479. help manage context and long-running work. Calls use a bounded 16-slot FIFO
  480. queue; queued work can be cancelled before execution. Long operations expose a
  481. persistent job ID and readable status. [Architecture](docs/ARCHITECTURE.md).
  482. ## Tested in Revit: published release evidence
  483. **v1.3.3**, published on **2026-09-15**, includes live release-gate reports for
  484. the installed server and all five supported Revit years. The reports total
  485. **1,230 passed probe executions**: 246 in each year, with zero failed, unverified
  486. or not-covered probes in that suite. Each report identifies the release commit,
  487. binary hashes and harness. [Release assets](https://github.com/HorizunGroup/horizun-revit-mcp/releases/tag/v1.3.3).
  488. | Revit | Passed | Failed | Unverified | Not covered in this suite | Report |
  489. |---|---:|---:|---:|---:|---|
  490. | 2023 | 246 | 0 | 0 | 0 | [JSON](https://github.com/HorizunGroup/horizun-revit-mcp/releases/download/v1.3.3/live-2023.json) |
  491. | 2024 | 246 | 0 | 0 | 0 | [JSON](https://github.com/HorizunGroup/horizun-revit-mcp/releases/download/v1.3.3/live-2024.json) |
  492. | 2025 | 246 | 0 | 0 | 0 | [JSON](https://github.com/HorizunGroup/horizun-revit-mcp/releases/download/v1.3.3/live-2025.json) |
  493. | 2026 | 246 | 0 | 0 | 0 | [JSON](https://github.com/HorizunGroup/horizun-revit-mcp/releases/download/v1.3.3/live-2026.json) |
  494. | 2027 | 246 | 0 | 0 | 0 | [JSON](https://github.com/HorizunGroup/horizun-revit-mcp/releases/download/v1.3.3/live-2027.json) |
  495. This is one release suite executed across five Revit versions. It is maintainer
  496. evidence for those cases, not 1,230 different features or a comparison against
  497. another product. The [machine-readable evidence index](docs/release-evidence.json)
  498. records the source URLs and hashes. Ongoing GitHub CI checks core/server behavior,
  499. Windows deployment, inventory/documentation consistency and CodeQL.
  500. Public release history starts with
  501. [v0.5.0 on 2026-08-02](https://github.com/HorizunGroup/horizun-revit-mcp/releases/tag/v0.5.0),
  502. includes [v1.0.0 on 2026-08-26](https://github.com/HorizunGroup/horizun-revit-mcp/releases/tag/v1.0.0),
  503. and contains **16 published non-prerelease releases as of 2026-09-15**.
  504. The GitHub stars badge above shows the current community count; the public
  505. [release history](https://github.com/HorizunGroup/horizun-revit-mcp/releases)
  506. and [commit history](https://github.com/HorizunGroup/horizun-revit-mcp/commits/main/)
  507. show maintenance directly.
  508. ## Version and compatibility
  509. | Question | Authoritative source |
  510. |---|---|
  511. | Latest stable download | [GitHub latest release](https://github.com/HorizunGroup/horizun-revit-mcp/releases/latest), including its publication date and assets |
  512. | Version of this source checkout | [Directory.Build.props](Directory.Build.props) |
  513. | Version actually loaded | `horizun_health`: version, commit, Revit year and active document |
  514. | MCP protocol implemented | **2025-11-25**, with earlier revisions listed in [ProtocolNegotiation.cs](src/Horizun.Server/ProtocolNegotiation.cs) |
  515. | Published registry metadata | [Official registry entry](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.HorizunGroup%2Fhorizun-revit-mcp/versions/latest) |
  516. MCP 2026-07-28 support is pending. A recent product release does not imply support
  517. for that protocol revision. Registry snapshots and search extracts may lag;
  518. check the release before choosing a version. Upgrade release installations by
  519. running the new Setup with Revit closed.
  520. ## Scope and further reference
  521. Typed results identify verification, partial outcomes and coverage. Unloaded
  522. links and unsupported API/template/exporter cases are reported explicitly.
  523. Use [TOOLS.md](docs/TOOLS.md) and [family scope](docs/FAMILY-AUTHORING.md) for
  524. operation-specific boundaries. [Benchmark methodology](docs/BENCHMARK.md)
  525. distinguishes historical design scoring from live execution evidence.
  526. [Build from source](docs/BUILDING.md) · [Contribute](CONTRIBUTING.md) ·
  527. [Agent instructions](AGENTS.md) · [LLM summary](llms.txt) ·
  528. [Security](docs/security-model.md) · [Privacy](docs/PRIVACY.md) ·
  529. [Release policy](docs/RELEASE-POLICY.md)
  530. ## Learn to direct it
  531. Horizun Hub teaches, in Spanish, how to direct AI agents in real construction and design work — and how to review what they deliver before you sign it. The course for this MCP is [Opera agentes en Revit](https://horizunhub.com/academia/revit-con-agentes/?utm_source=github&utm_medium=readme&utm_campaign=horizun-revit-mcp): short classes on real construction work, with a verifiable certificate.
  532. New to agents? Level 1 of [Opera agentes de IA desde cero](https://horizunhub.com/academia/agentes-ia-desde-cero/?utm_source=github&utm_medium=readme&utm_campaign=horizun-revit-mcp) is free with an account.
  533. Built in Colombia 🇨🇴 and maintained by Horizun Group as part of
  534. [Horizun Hub](https://horizunhub.com/revit-mcp/?utm_source=github&utm_medium=readme&utm_campaign=revit-mcp). The bridge is organisation-neutral;
  535. project standards and catalogs are supplied as inputs. The optional
  536. [standards pack](standards/README.md) provides editable examples.
  537. **Apache-2.0:** [LICENSE](LICENSE), [NOTICE](NOTICE), [third-party notices](THIRD-PARTY-NOTICES.md).
  538. The Revit API is not redistributed. Autodesk and Revit are trademarks of Autodesk;
  539. this project is not affiliated with, endorsed by or sponsored by Autodesk.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.