revit-model-mcp 0.3.0__tar.gz

revit_model_mcp-0.3.0/.gitignore

@@ -0,0 +1,43 @@
+# .NET
+[Bb]in/
+[Oo]bj/
+.vs/
+.idea/
+*.user
+*.suo
+*.nupkg
+*.snupkg
+TestResults/
+artifacts/
+/output/
+
+# Build sources are versioned even when a global ignore excludes build folders.
+!/build/
+!/build/**
+/build/**/[Bb]in/
+/build/**/[Oo]bj/
+
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+*.egg-info/
+dist/
+uv.lock
+
+# Local data
+.env
+.env.*
+.DS_Store
+*.rvt
+*.rfa
+*.log
+docs/screenshots/raw/
+
+# Documentation site
+site/

revit_model_mcp-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dinar Sharafutdinov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

revit_model_mcp-0.3.0/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.5
+Name: revit-model-mcp
+Version: 0.3.0
+Summary: MCP access to live Autodesk Revit models, read-only by default with opt-in actions
+Project-URL: Homepage, https://github.com/sharafutdinovdi/revit-model-mcp
+Project-URL: Changelog, https://github.com/sharafutdinovdi/revit-model-mcp/blob/main/CHANGELOG.md
+Project-URL: Repository, https://github.com/sharafutdinovdi/revit-model-mcp
+Project-URL: Documentation, https://github.com/sharafutdinovdi/revit-model-mcp#readme
+Project-URL: Issues, https://github.com/sharafutdinovdi/revit-model-mcp/issues
+Author: Dinar Sharafutdinov
+License-Expression: MIT
+License-File: LICENSE
+Keywords: autodesk,bim,claude,mcp,mcp-server,revit
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.11
+Requires-Dist: mcp>=2.0.0
+Description-Content-Type: text/markdown
+
+# Revit Model MCP server
+
+The Python package exposes Revit tools over MCP stdio, read-only by default.
+Optional actions require `REVIT_MCP_ALLOW_WRITE=1` and a workstation `allow-write` gate.
+It requires Python 3.11 or later and the matching add-in loaded in Revit on Windows.
+
+## Install and run
+
+After the first PyPI release, run the published package with uv:
+
+```sh
+uvx revit-model-mcp
+```
+
+Register the local Windows server with Claude Code:
+
+```sh
+claude mcp add revit-model-mcp -e REVIT_MCP_HOST=local -- uvx revit-model-mcp
+```
+
+For a client on macOS or Linux:
+
+```sh
+claude mcp add revit-model-mcp -e REVIT_MCP_HOST=ssh:revit-host -e REVIT_MCP_REDACT_PATHS=1 -- uvx revit-model-mcp
+```
+
+Replace `revit-host` with an alias from the client's SSH configuration.
+The Windows SSH session must use the same account as Revit or an explicitly shared channel directory.
+
+Claude Desktop uses this entry in `claude_desktop_config.json` on Windows:
+
+```json
+{
+  "mcpServers": {
+    "revit-model-mcp": {
+      "command": "uvx",
+      "args": ["revit-model-mcp"],
+      "env": {
+        "REVIT_MCP_HOST": "local",
+        "REVIT_MCP_REDACT_PATHS": "1"
+      }
+    }
+  }
+}
+```
+
+`uvx` must be available on the client's PATH; an absolute executable path is also supported.
+A remote Desktop client uses `REVIT_MCP_HOST=ssh:revit-host`.
+
+For development or before the first PyPI publication, run from the repository root:
+
+```sh
+uv run --directory server revit-model-mcp
+claude mcp add revit-model-mcp -e REVIT_MCP_HOST=local -- uv run --directory /absolute/path/to/revit-model-mcp/server revit-model-mcp
+```
+
+mcp-name: io.github.sharafutdinovdi/revit-model-mcp
+
+## Configuration
+
+| Variable | Default | Behavior |
+|---|---|---|
+| `REVIT_MCP_HOST` | `local` | Local PowerShell, `ssh:<alias>` or an `http://` / `https://` add-in endpoint. `--host` overrides it. |
+| `REVIT_MCP_ALLOW_WRITE` | Unset | Only `1` registers the nine action tools, including `revit_batch` at server startup; the workstation gate is also required. |
+| `REVIT_MCP_TOKEN` | Unset | HTTP bearer token from workstation settings. `--token` overrides it. |
+| `REVIT_MCP_SSH_MUX` | Enabled | `0` disables OpenSSH connection multiplexing. Local mode ignores SSH settings. |
+| `REVIT_MCP_SSH_OPTIONS` | Unset | Extra SSH arguments, parsed with shell quoting and appended after built-in options, before the host. Example: `-o ServerAliveInterval=30 -p 2222`. |
+| `REVIT_MCP_ACTIVATE_TASK` | Unset | Optional existing Windows scheduled task. Runs once after 60 seconds if the trigger remains pending. The task must activate the interactive Revit window. No task is created by the server. |
+| `REVIT_MCP_CHANNEL_DIR` | `%LOCALAPPDATA%\RevitModelMcp` on Windows | Absolute Windows channel path. Set the same value in the Python server environment and in Revit's environment before starting Revit. In SSH mode this path belongs to the remote host. |
+| `REVIT_MCP_REDACT_PATHS` | Unset | `1` replaces every response `documentPath` and nested `path` value with its file name. `--redact-paths` enables the same behavior. |
+
+SSH mode passes `ControlMaster=auto`, `ControlPath=<dir>/mux-%C` and `ControlPersist=600` on every invocation.
+The socket directory is `$XDG_RUNTIME_DIR` when nonempty, otherwise `/tmp/revit-model-mcp-<uid>/`.
+The directory is created or restricted to mode `0700` on macOS and Linux.
+Keep its absolute path short for Unix socket limits; `%C` hashes the connection identity.
+The master connection remains available for 600 seconds after its last client disconnects.
+Extra options follow OpenSSH's first-value-wins behavior.
+To supply a custom multiplexing path or lifetime, set `REVIT_MCP_SSH_MUX=0` and provide all three `Control*` options through `REVIT_MCP_SSH_OPTIONS`.
+Clients whose OpenSSH lacks multiplexing support, such as native Windows OpenSSH, use `REVIT_MCP_SSH_MUX=0`.
+
+`uv run --directory server revit-model-mcp --help` prints the environment host mode, Windows channel directory and path redaction flag without contacting Revit.
+
+The server reads activation configuration at process startup.
+A configured task may restore and focus the Revit window.
+Without a task the server only polls for pickup.
+
+## Responses and privacy
+
+Model paths occur in responder metadata and instance listings.
+Redaction covers `documentPath` and all nested `path` fields in successful MCP results, including RVT/CAD/image link paths from `revit_links_status`.
+It preserves exported image `localPath` values for clients that open the downloaded file.
+It does not redact names, parameter values, add-in error text or files stored in the channel.
+Revit model data and errors can retain their original language.
+Python tool descriptions and server-generated messages are English.
+
+## Request behavior
+
+For HTTP setup and remote access commands, see [transport](../docs/transport.md#http-configuration).
+HTTP submits once and polls by job ID within `timeout_seconds`; pickup timeout applies only to file transports.
+HTTP exports download PNG directly without remote PowerShell.
+Each HTTP endpoint represents one Revit process.
+
+The default file pickup timeout is 300 seconds.
+The response timeout is 120 seconds after pickup.
+Most tools accept `pickup_timeout_seconds` and `timeout_seconds`.
+`revit_export_view` uses the defaults.
+Supply `document` when multiple Revit instances run on the host.
+Use a distinctive document title or file name.
+Matching is case-insensitive and accepts substrings.
+A pending job remains in the channel after pickup timeout and may execute later.
+Use one MCP server process per channel directory.
+
+See [transport](../docs/transport.md) for file handling and SSH behavior.
+
+## Tests
+
+From the repository root:
+
+```sh
+cd server
+uv run --with pytest pytest -q
+```
+
+The tests use mocked host operations and exercise MCP stdio without Revit.
+
+See the [tool arguments](../README.md#tools), [action arguments](../README.md#actions-opt-in) and [response contract](../docs/feed-format.md#command-responses).
+
+## License
+
+[MIT](LICENSE), copyright (c) 2026 Dinar Sharafutdinov.

revit_model_mcp-0.3.0/README.md

@@ -0,0 +1,130 @@
+# Revit Model MCP server
+
+The Python package exposes Revit tools over MCP stdio, read-only by default.
+Optional actions require `REVIT_MCP_ALLOW_WRITE=1` and a workstation `allow-write` gate.
+It requires Python 3.11 or later and the matching add-in loaded in Revit on Windows.
+
+## Install and run
+
+After the first PyPI release, run the published package with uv:
+
+```sh
+uvx revit-model-mcp
+```
+
+Register the local Windows server with Claude Code:
+
+```sh
+claude mcp add revit-model-mcp -e REVIT_MCP_HOST=local -- uvx revit-model-mcp
+```
+
+For a client on macOS or Linux:
+
+```sh
+claude mcp add revit-model-mcp -e REVIT_MCP_HOST=ssh:revit-host -e REVIT_MCP_REDACT_PATHS=1 -- uvx revit-model-mcp
+```
+
+Replace `revit-host` with an alias from the client's SSH configuration.
+The Windows SSH session must use the same account as Revit or an explicitly shared channel directory.
+
+Claude Desktop uses this entry in `claude_desktop_config.json` on Windows:
+
+```json
+{
+  "mcpServers": {
+    "revit-model-mcp": {
+      "command": "uvx",
+      "args": ["revit-model-mcp"],
+      "env": {
+        "REVIT_MCP_HOST": "local",
+        "REVIT_MCP_REDACT_PATHS": "1"
+      }
+    }
+  }
+}
+```
+
+`uvx` must be available on the client's PATH; an absolute executable path is also supported.
+A remote Desktop client uses `REVIT_MCP_HOST=ssh:revit-host`.
+
+For development or before the first PyPI publication, run from the repository root:
+
+```sh
+uv run --directory server revit-model-mcp
+claude mcp add revit-model-mcp -e REVIT_MCP_HOST=local -- uv run --directory /absolute/path/to/revit-model-mcp/server revit-model-mcp
+```
+
+mcp-name: io.github.sharafutdinovdi/revit-model-mcp
+
+## Configuration
+
+| Variable | Default | Behavior |
+|---|---|---|
+| `REVIT_MCP_HOST` | `local` | Local PowerShell, `ssh:<alias>` or an `http://` / `https://` add-in endpoint. `--host` overrides it. |
+| `REVIT_MCP_ALLOW_WRITE` | Unset | Only `1` registers the nine action tools, including `revit_batch` at server startup; the workstation gate is also required. |
+| `REVIT_MCP_TOKEN` | Unset | HTTP bearer token from workstation settings. `--token` overrides it. |
+| `REVIT_MCP_SSH_MUX` | Enabled | `0` disables OpenSSH connection multiplexing. Local mode ignores SSH settings. |
+| `REVIT_MCP_SSH_OPTIONS` | Unset | Extra SSH arguments, parsed with shell quoting and appended after built-in options, before the host. Example: `-o ServerAliveInterval=30 -p 2222`. |
+| `REVIT_MCP_ACTIVATE_TASK` | Unset | Optional existing Windows scheduled task. Runs once after 60 seconds if the trigger remains pending. The task must activate the interactive Revit window. No task is created by the server. |
+| `REVIT_MCP_CHANNEL_DIR` | `%LOCALAPPDATA%\RevitModelMcp` on Windows | Absolute Windows channel path. Set the same value in the Python server environment and in Revit's environment before starting Revit. In SSH mode this path belongs to the remote host. |
+| `REVIT_MCP_REDACT_PATHS` | Unset | `1` replaces every response `documentPath` and nested `path` value with its file name. `--redact-paths` enables the same behavior. |
+
+SSH mode passes `ControlMaster=auto`, `ControlPath=<dir>/mux-%C` and `ControlPersist=600` on every invocation.
+The socket directory is `$XDG_RUNTIME_DIR` when nonempty, otherwise `/tmp/revit-model-mcp-<uid>/`.
+The directory is created or restricted to mode `0700` on macOS and Linux.
+Keep its absolute path short for Unix socket limits; `%C` hashes the connection identity.
+The master connection remains available for 600 seconds after its last client disconnects.
+Extra options follow OpenSSH's first-value-wins behavior.
+To supply a custom multiplexing path or lifetime, set `REVIT_MCP_SSH_MUX=0` and provide all three `Control*` options through `REVIT_MCP_SSH_OPTIONS`.
+Clients whose OpenSSH lacks multiplexing support, such as native Windows OpenSSH, use `REVIT_MCP_SSH_MUX=0`.
+
+`uv run --directory server revit-model-mcp --help` prints the environment host mode, Windows channel directory and path redaction flag without contacting Revit.
+
+The server reads activation configuration at process startup.
+A configured task may restore and focus the Revit window.
+Without a task the server only polls for pickup.
+
+## Responses and privacy
+
+Model paths occur in responder metadata and instance listings.
+Redaction covers `documentPath` and all nested `path` fields in successful MCP results, including RVT/CAD/image link paths from `revit_links_status`.
+It preserves exported image `localPath` values for clients that open the downloaded file.
+It does not redact names, parameter values, add-in error text or files stored in the channel.
+Revit model data and errors can retain their original language.
+Python tool descriptions and server-generated messages are English.
+
+## Request behavior
+
+For HTTP setup and remote access commands, see [transport](../docs/transport.md#http-configuration).
+HTTP submits once and polls by job ID within `timeout_seconds`; pickup timeout applies only to file transports.
+HTTP exports download PNG directly without remote PowerShell.
+Each HTTP endpoint represents one Revit process.
+
+The default file pickup timeout is 300 seconds.
+The response timeout is 120 seconds after pickup.
+Most tools accept `pickup_timeout_seconds` and `timeout_seconds`.
+`revit_export_view` uses the defaults.
+Supply `document` when multiple Revit instances run on the host.
+Use a distinctive document title or file name.
+Matching is case-insensitive and accepts substrings.
+A pending job remains in the channel after pickup timeout and may execute later.
+Use one MCP server process per channel directory.
+
+See [transport](../docs/transport.md) for file handling and SSH behavior.
+
+## Tests
+
+From the repository root:
+
+```sh
+cd server
+uv run --with pytest pytest -q
+```
+
+The tests use mocked host operations and exercise MCP stdio without Revit.
+
+See the [tool arguments](../README.md#tools), [action arguments](../README.md#actions-opt-in) and [response contract](../docs/feed-format.md#command-responses).
+
+## License
+
+[MIT](LICENSE), copyright (c) 2026 Dinar Sharafutdinov.

revit_model_mcp-0.3.0/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "revit-model-mcp"
+version = "0.3.0"
+description = "MCP access to live Autodesk Revit models, read-only by default with opt-in actions"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["revit", "bim", "mcp", "mcp-server", "autodesk", "claude"]
+authors = [{name = "Dinar Sharafutdinov"}]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: OS Independent",
+    "Topic :: Scientific/Engineering",
+]
+dependencies = ["mcp>=2.0.0"]
+
+[project.urls]
+Homepage = "https://github.com/sharafutdinovdi/revit-model-mcp"
+Changelog = "https://github.com/sharafutdinovdi/revit-model-mcp/blob/main/CHANGELOG.md"
+Repository = "https://github.com/sharafutdinovdi/revit-model-mcp"
+Documentation = "https://github.com/sharafutdinovdi/revit-model-mcp#readme"
+Issues = "https://github.com/sharafutdinovdi/revit-model-mcp/issues"
+
+[project.scripts]
+revit-model-mcp = "revit_model_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["revit_model_mcp"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+required-version = "==0.16.7"
+target-version = "py311"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E4", "E7", "E9", "F", "I"]

revit_model_mcp-0.3.0/revit_model_mcp/__init__.py

@@ -0,0 +1,11 @@
+"""MCP tools for reading a live Autodesk Revit model."""
+
+from importlib.metadata import PackageNotFoundError
+from importlib.metadata import version as _version
+
+
+def package_version() -> str:
+    try:
+        return _version("revit-model-mcp")
+    except PackageNotFoundError:
+        return "0.0.0+unknown"

revit_model_mcp-0.3.0/revit_model_mcp/actions.py

@@ -0,0 +1,247 @@
+from __future__ import annotations
+
+import os
+from typing import Annotated, Any, Literal
+
+from mcp.server.mcpserver.exceptions import ToolError
+from mcp.types import ToolAnnotations
+from pydantic import BaseModel, ConfigDict, Field, create_model, model_validator
+
+from revit_model_mcp.revit_channel import (
+    DEFAULT_PICKUP_TIMEOUT_SECONDS,
+    DEFAULT_TIMEOUT_SECONDS,
+    ReadJob,
+    RevitChannelError,
+)
+
+ElementId = Annotated[int, Field(strict=True, gt=0, le=9223372036854775807)]
+ElementIds = list[ElementId]
+NonEmptyIds = Annotated[ElementIds, Field(min_length=1)]
+Number = Annotated[float, Field(allow_inf_nan=False)]
+PositiveLength = Annotated[float, Field(gt=0, allow_inf_nan=False)]
+Name = Annotated[str, Field(min_length=1, pattern=r"\S")]
+Point = Annotated[list[Number], Field(min_length=2, max_length=2)]
+
+
+_BATCH_FIELDS = {
+    "select": {"element_ids": (ElementIds, ...)},
+    "isolate": {"element_ids": (ElementIds, ...), "reset": (bool, False)},
+    "move": {
+        "element_ids": (NonEmptyIds, ...),
+        "dx_mm": (Number, ...),
+        "dy_mm": (Number, ...),
+        "dz_mm": (Number, 0),
+    },
+    "place_family": {
+        "family": (Name, ...),
+        "type_name": (Name | None, ...),
+        "x_mm": (Number, ...),
+        "y_mm": (Number, ...),
+        "level": (Name, ...),
+        "rotation_deg": (Number, 0),
+    },
+    "create_wall": {
+        "start_mm": (Point, ...),
+        "end_mm": (Point, ...),
+        "level": (Name, ...),
+        "wall_type": (Name | None, ...),
+        "height_mm": (PositiveLength, 3000),
+    },
+    "set_parameter": {
+        "element_id": (ElementId, ...),
+        "parameter": (Name, ...),
+        "value": (str, ...),
+    },
+    "delete": {"element_ids": (NonEmptyIds, ...)},
+}
+for _action in ("move", "place_family", "create_wall", "set_parameter", "delete"):
+    _BATCH_FIELDS[_action]["dry_run"] = (bool, False)
+_BATCH_MODELS = {
+    action: create_model(action, __config__=ConfigDict(extra="forbid"), **fields)
+    for action, fields in _BATCH_FIELDS.items()
+}
+
+
+class BatchStep(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+    action: Literal[
+        "move", "place_family", "create_wall", "set_parameter", "delete", "select", "isolate"
+    ]
+    args: dict
+
+    @model_validator(mode="after")
+    def validate_args(self):
+        self.args = _BATCH_MODELS[self.action].model_validate(self.args).model_dump()
+        if self.action == "isolate" and not self.args["reset"] and not self.args["element_ids"]:
+            raise ValueError("element_ids must not be empty unless reset is true.")
+        if self.action == "create_wall" and self.args["start_mm"] == self.args["end_mm"]:
+            raise ValueError("Wall endpoints must differ.")
+        return self
+
+    def payload(self) -> dict:
+        def camel(key):
+            first, *rest = key.split("_")
+            return first + "".join(part.title() for part in rest)
+
+        return {
+            "command": self.action.replace("_", "-"),
+            **{camel(key): value for key, value in self.args.items()},
+        }
+
+
+def millimeters_to_feet(value: float) -> float:
+    """Convert a finite millimetre length to Revit internal feet for client calculations."""
+    import math
+
+    if not math.isfinite(value):
+        raise ValueError("Length must be finite.")
+    return value / 304.8
+
+
+def register_actions(mcp, execute, host_provider) -> None:
+    if os.environ.get("REVIT_MCP_ALLOW_WRITE") != "1":
+        return
+
+    async def send(command: str, **payload) -> dict[str, Any]:
+        try:
+            instances = await host_provider().list_revit_instances()
+        except RevitChannelError as error:
+            raise ToolError(str(error)) from error
+        if len(instances) != 1:
+            raise ToolError("Actions require exactly one running Revit instance.")
+        job = ReadJob(
+            command,
+            {
+                "command": command,
+                **payload,
+                "targetProcessId": instances[0]["processId"],
+            },
+        )
+        return await execute(job, DEFAULT_TIMEOUT_SECONDS, DEFAULT_PICKUP_TIMEOUT_SECONDS, None)
+
+    def action(function):
+        return mcp.tool(
+            annotations=ToolAnnotations(
+                readOnlyHint=False,
+                destructiveHint=function.__name__
+                not in {"revit_select", "revit_show", "revit_isolate"},
+                idempotentHint=function.__name__
+                in {"revit_select", "revit_show", "revit_isolate", "revit_set_parameter"},
+            )
+        )(function)
+
+    @action
+    async def revit_select(element_ids: ElementIds) -> dict[str, Any]:
+        """Select element IDs for inspection in Revit; an empty list clears selection; IDs are unitless."""
+        return await send("select", elementIds=element_ids)
+
+    @action
+    async def revit_show(element_ids: NonEmptyIds, select: bool = True) -> dict[str, Any]:
+        """Show elements, optionally selecting them; open a level plan or 3D view when needed. Returns activeView, viewOpened and dialogsSuppressed; IDs are unitless."""
+        return await send("show", elementIds=element_ids, select=select)
+
+    @action
+    async def revit_isolate(element_ids: ElementIds, reset: bool = False) -> dict[str, Any]:
+        """Temporarily isolate IDs for visual review in the active view, or reset with an empty list; IDs are unitless."""
+        if not reset and not element_ids:
+            raise ToolError("element_ids must not be empty unless reset is true.")
+        return await send("isolate", elementIds=element_ids, reset=reset)
+
+    @action
+    async def revit_move(
+        element_ids: NonEmptyIds,
+        dx_mm: Number,
+        dy_mm: Number,
+        dz_mm: Number = 0,
+        dry_run: bool = False,
+    ) -> dict[str, Any]:
+        """Move elements when adjusting their position; dx_mm, dy_mm and dz_mm are offsets in millimetres on model axes.
+        dry_run executes and rolls back, returning the same verification block without changing the model.
+        """
+        return await send(
+            "move", elementIds=element_ids, dxMm=dx_mm, dyMm=dy_mm, dzMm=dz_mm, dryRun=dry_run
+        )
+
+    @action
+    async def revit_place_family(
+        family: Name,
+        type_name: Name | None,
+        x_mm: Number,
+        y_mm: Number,
+        level: Name,
+        rotation_deg: Number = 0,
+        dry_run: bool = False,
+    ) -> dict[str, Any]:
+        """Place a loaded unhosted family on a named level for layout.
+
+        family accepts a family name or Family: Type, case-insensitively.
+        null type_name uses the embedded type or the first type. Conflicting types
+        are rejected. Missing families return similar names with categories.
+        Model XY is in millimetres and Z rotation in degrees.
+        Use roomCenterMm when placing something inside a room.
+
+        dry_run executes and rolls back, returning the same verification block without changing the model.
+        """
+        return await send(
+            "place-family",
+            family=family,
+            typeName=type_name,
+            xMm=x_mm,
+            yMm=y_mm,
+            level=level,
+            rotationDeg=rotation_deg,
+            dryRun=dry_run,
+        )
+
+    @action
+    async def revit_create_wall(
+        start_mm: Point,
+        end_mm: Point,
+        level: Name,
+        wall_type: Name | None,
+        height_mm: PositiveLength = 3000,
+        dry_run: bool = False,
+    ) -> dict[str, Any]:
+        """Create a straight wall for layout on a named level; model XY endpoints and height are millimetres; null wall_type chooses the first basic type.
+        dry_run executes and rolls back, returning the same verification block without changing the model.
+        """
+        if start_mm == end_mm:
+            raise ToolError("Wall endpoints must differ.")
+        return await send(
+            "create-wall",
+            startMm=start_mm,
+            endMm=end_mm,
+            level=level,
+            wallType=wall_type,
+            heightMm=height_mm,
+            dryRun=dry_run,
+        )
+
+    @action
+    async def revit_set_parameter(
+        element_id: ElementId, parameter: Name, value: str, dry_run: bool = False
+    ) -> dict[str, Any]:
+        """Set a named instance parameter, falling back to its shared type; use for edits, with length in mm, area in m2 and other doubles in internal units.
+        dry_run executes and rolls back, returning the same verification block without changing the model.
+        """
+        return await send(
+            "set-parameter", elementId=element_id, parameter=parameter, value=value, dryRun=dry_run
+        )
+
+    @action
+    async def revit_delete(element_ids: NonEmptyIds, dry_run: bool = False) -> dict[str, Any]:
+        """Delete elements and their Revit dependencies when removal is intended; IDs are unitless and the returned count includes dependents.
+        dry_run executes and rolls back, returning the same verification block without changing the model.
+        """
+        return await send("delete", elementIds=element_ids, dryRun=dry_run)
+
+    @action
+    async def revit_batch(
+        steps: Annotated[list[BatchStep], Field(min_length=1, max_length=50)],
+        dry_run: bool = False,
+    ) -> dict[str, Any]:
+        """Execute up to 50 actions with one undo step; roll back the batch on its first failure.
+
+        dry_run executes and rolls back, returning the same verification block without changing the model.
+        """
+        return await send("batch", steps=[step.payload() for step in steps], dryRun=dry_run)

revit_model_mcp-0.3.0/revit_model_mcp/artifact_download.py

@@ -0,0 +1,22 @@
+from __future__ import annotations
+
+import base64
+import tempfile
+from pathlib import Path
+
+
+def save_artifact(result: dict[str, object], save_to: str | None) -> str:
+    name = result.get("artifactName")
+    encoded = result.get("artifact")
+    if not isinstance(name, str) or Path(name).name != name or not isinstance(encoded, str):
+        raise ValueError("Remote response does not contain a safe image artifact.")
+    target = (
+        Path(save_to).expanduser().resolve()
+        if save_to
+        else Path(tempfile.mkdtemp(prefix="revit-view-")) / name
+    )
+    if target.exists():
+        raise ValueError(f"Local file already exists: {target}")
+    target.parent.mkdir(parents=True, exist_ok=True)
+    target.write_bytes(base64.b64decode(encoded, validate=True))
+    return str(target)