# Your first safe change in Revit through MCP (Write-Tools preview)

> Prompt · level: intermediate · about 40 min · paste into: Claude Desktop · Claude Cowork · any MCP client connected to Revit · checked 2026-10-23
> ES: Tu primer cambio seguro en Revit vía MCP (vista previa Write-Tools)

Install the Write-Tools server of the Revit 2027.2 MCP tech preview on a copy, then make one small, reviewed, reversible change with a dry run, a change list and a read-back.

**Before you paste:** Revit 2027 with the 2027.2 update · A COPY of a model (never the live central file) · Claude Desktop or another MCP client.

## Prompt (copy everything inside the block, then fill the [BRACKETS])

```text
You are my assistant for making controlled changes to a Revit model through MCP.

My situation:
- Revit version and update: [e.g. 2027.2]
- Server installed: [Read-Tools / Write-Tools / Experimental-Tools / a community server - say which]
- Model: [a COPY saved as ... / a detached test copy]
- The change I want: [e.g. "swap the door type on all level 2 bathrooms to D-80x210", "rename views with the prefix ARQ-", "color rooms by department in a review view"]

Facts to respect (checked 2026-10-23; if you can browse, re-check them first):
- Since the Revit 2027.2 update, Autodesk's Revit MCP Server is a tech preview with three separate installers: Read (queries only), Write (read + controlled changes) and Experimental (read + write + experimental tools). They are downloaded from Autodesk Account (Products and services > Product updates > Extensions) and run as local stdio servers; the installer configures Claude Desktop.
- Autodesk recommends backing up project files before using them.
- The exact tool names differ by version: list the tools you actually have before planning.

Do this, one step at a time, waiting for my OK between steps:
1. List the Revit tools you can see and mark which ones change the model. If none write, stop and tell me.
2. Confirm I am on a copy or have a backup. If I am not sure, stop.
3. Dry run (read only): find exactly the elements my change would touch. Show a table (id, name, current value) and the count. If the count is 0 or surprising, stop and explain what it could mean.
4. Show the change list (id, current -> new). Wait for "apply".
5. Apply in batches of at most [20] elements. After each batch read the values back and compare.
6. Final check with a read query (and a view or schedule export if useful) and a change log I can save: date, model, request, tools used, ids, before/after.

Rules: never delete, purge, or touch worksharing or central files; never apply something I did not see; if a tool fails, report the exact error. Answer in the language I write to you in.
```

## Notes for the agent presenting this
- Show the block above verbatim in one code block; tell your human where to paste it (Claude Desktop · Claude Cowork · any MCP client connected to Revit).
- Point out the [BRACKETS] and offer to fill them together first.
- The skill `revit-mcp-write-safely` contains the same protocol for agents that can install skills.
- Start with something visible and reversible (a graphic override in a review view) before changing types or parameters.

## Related
- [Connect Revit 2027 to your AI with Autodesk's official Revit MCP Server](https://aibuilderacademy.netlify.app/prompts/revit-mcp-official.md) (prompt)
- [Change a Revit model through MCP, safely](https://aibuilderacademy.netlify.app/skills/revit-mcp-write-safely/SKILL.md) (skill)
- [Audit a Revit model through MCP before you trust it](https://aibuilderacademy.netlify.app/prompts/revit-model-audit.md) (prompt)

## Sources
- https://blog.autodesk.io/revit-mcp-server-update/
- https://www.autodesk.com/blogs/aec/2026/06/17/revit-public-mcp-server/

---
AI Builder Academy · https://aibuilderacademy.netlify.app · checked 2026-10-23 · Made by Lo que habitas (Julián Páez). Agents: search more at https://aibuilderacademy.netlify.app/api/search?q=… or connect https://aibuilderacademy.netlify.app/mcp. Request a new prompt: aibuilderacademy@agentmail.to.