Skip to content

Open-source Revit MCP server: let Claude and other AI assistants read and edit BIM models, with human approval on every change.

fix(mcp): cap mcp below 2, ship module data, annotate every tool, add directory files

sammohammad5782719871d28af
diff --git a/.dockerignore b/.dockerignore
new file mode 100644
index 0000000..adeb3c5
--- /dev/null
+++ b/.dockerignore
@@ -0,0 +1,16 @@
+**/__pycache__
+**/*.pyc
+.git
+.github
+.claude
+.venv
+**/.pytest_cache
+**/.ruff_cache
+packages/revit-bridge-addin
+packages/navisworks-bridge-addin
+packages/powerbi-bridge-tool
+packages/rhino-bridge-addin
+panel
+assets
+docs
+fixtures
diff --git a/.github/workflows/publish-mcp.yml b/.github/workflows/publish-mcp.yml
index d73e157..7ee9a53 100644
--- a/.github/workflows/publish-mcp.yml
+++ b/.github/workflows/publish-mcp.yml
@@ -4,28 +4,48 @@ on:
release:
types:
- published
+ # Releases created by release.yml use the workflow GITHUB_TOKEN, and GitHub does
+ # not fire `release: published` for events created that way. That is why the
+ # registry stayed on 1.1.0 while 1.2.1 and 1.3.0 were released. Chain off the
+ # release workflow instead.
+ workflow_run:
+ workflows:
+ - Build GitHub Release
+ types:
+ - completed
workflow_dispatch:
jobs:
publish:
+ # For workflow_run only publish stable tags (vX.Y.Z) whose release build passed.
+ if: >-
+ github.event_name != 'workflow_run' ||
+ (github.event.workflow_run.conclusion == 'success' &&
+ startsWith(github.event.workflow_run.head_branch, 'v') &&
+ !contains(github.event.workflow_run.head_branch, '-'))
runs-on: ubuntu-latest
permissions:
id-token: write
contents: read
+ env:
+ RELEASE_TAG: ${{ github.event.release.tag_name || github.event.workflow_run.head_branch }}
+
steps:
- name: Checkout code
uses: actions/checkout@v5
+ with:
+ ref: ${{ github.event.workflow_run.head_sha || github.sha }}
- name: Synchronize release artifact metadata
- if: github.event_name == 'release'
+ if: github.event_name != 'workflow_dispatch'
shell: bash
env:
GH_TOKEN: ${{ github.token }}
run: |
- version="${GITHUB_REF_NAME#v}"
+ version="${RELEASE_TAG#v}"
asset="aec-model-bridge-${version}.mcpb"
- gh release download "$GITHUB_REF_NAME" --pattern "$asset" --dir release
+ gh release download "$RELEASE_TAG" --repo "$GITHUB_REPOSITORY" --pattern "$asset" --dir release
sha256="$(sha256sum "release/$asset" | cut -d' ' -f1)"
python - "$version" "$sha256" <<'PY'
import json
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4aeae77..88d8c1b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,13 @@
## Unreleased
+- Fix install: `mcp` is now pinned `>=1.10,<2`. An unpinned install on Python 3.12+ resolved mcp 2.x, which removed the `Server.list_tools()` decorators this server uses, so the server crashed at import. `uv.lock` was also stale (missing `anthropic`) and is refreshed.
+- Fix packaging: module manifests, QA/QC rules and recipes were missing from the wheel, so a pip or uvx install lacked the 34 module tools. They are now package data.
+- Tools: every tool now lists a full description, a described input schema, a title and MCP annotations (`readOnlyHint`, `destructiveHint`, `idempotentHint`, `openWorldHint`), derived from the existing approval-gate flags. The server reports its own version and usage instructions at initialize. No tool behaviour changed.
+- Mock mode: tools backed by a legacy handler (for example `revit_health`) no longer fail with a missing `request_id`, so directories can call them without Revit.
+- Directories: add a root `Dockerfile` (mock mode), `glama.json` and `smithery.yaml` so listing sites can build and introspect the server without Revit. README gains a quick start, a tool table and a demo placeholder; `server.json` and `manifest.json` document more environment variables and keywords.
+- Release: `publish-mcp.yml` also runs after the release workflow completes. Releases created with the workflow token do not fire `release: published`, which is why the MCP Registry stayed on 1.1.0 after 1.2.1 and 1.3.0 were released.
+
## 1.3.1 - 2026-10-09
- Release: every GitHub release now ships one ready-to-install package per supported Revit year (`aec-model-bridge-revit-2024-X.Y.Z.zip` through `-2027-`). 1.3.0 only shipped the Revit 2027 package. `build-release.ps1` defaults to all years, and the release workflow installs the .NET 8 SDK that the 2024-2026 builds need.
diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 0000000..7d2a2d0
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,40 @@
+# AEC Model Bridge - MCP server image for directories and CI (Glama, Smithery, ...).
+#
+# This image runs the Python MCP server in MOCK mode so a registry can start it,
+# list all tools with their schemas and call the read-only ones WITHOUT Autodesk
+# Revit. Mock mode returns canned responses; it does not talk to a real model.
+# To drive a real Revit session, install the add-in on the Windows machine that
+# runs Revit and run the server there with MCP_REVIT_MODE=bridge (see README).
+#
+# SPDX-License-Identifier: GPL-3.0-or-later WITH Revit-Linking-Exception
+# (or a commercial license - see LICENSING.md)
+FROM python:3.12-slim
+
+LABEL org.opencontainers.image.title="AEC Model Bridge" \
+ org.opencontainers.image.description="MCP server for Autodesk Revit (mock mode in this image)" \
+ org.opencontainers.image.source="https://github.com/Sam-AEC/aec-model-bridge" \
+ org.opencontainers.image.licenses="GPL-3.0-or-later"
+
+ENV PYTHONUNBUFFERED=1 \
+ PIP_NO_CACHE_DIR=1 \
+ PIP_DISABLE_PIP_VERSION_CHECK=1 \
+ MCP_REVIT_MODE=mock \
+ MCP_REVIT_WORKSPACE_DIR=/workspace \
+ MCP_REVIT_ALLOWED_DIRECTORIES=/workspace \
+ MCP_REVIT_AUDIT_LOG=/workspace/aec-model-bridge-audit.jsonl
+
+WORKDIR /app
+COPY packages/mcp-server-revit/ /app/
+
+# Editable install keeps the module manifests and recipes (non-Python files)
+# next to the code, exactly as in a source checkout.
+RUN pip install -e . \
+ && useradd --create-home --uid 10001 mcp \
+ && mkdir -p /workspace \
+ && chown -R mcp:mcp /workspace
+
+USER mcp
+WORKDIR /workspace
+
+# stdio transport: the MCP client starts this container and talks over stdin/stdout.
+ENTRYPOINT ["aec-model-bridge"]
diff --git a/README.md b/README.md
index 8b7f603..9f4c76f 100644
--- a/README.md
+++ b/README.md
@@ -25,6 +25,69 @@ It does not edit your model on its own. Any tool that changes the model goes
through a plan that you review and approve first. See
[How approval works](#how-approval-works).
+**License:** GPL-3.0-or-later with a Revit linking exception, or a separate
+commercial license ([details](LICENSING.md)). Independent project, not
+affiliated with Autodesk.
+
+## Quick start
+
+For live Revit automation you need Windows, a licensed Revit 2024 to 2027,
+Python 3.11 or newer, and the Revit add-in
+([install steps](#install-the-revit-add-in)). Then add this to your
+`claude_desktop_config.json` (Codex, Cursor and VS Code use the same values):
+
+```json
+{
+ "mcpServers": {
+ "aec-model-bridge": {
+ "command": "uvx",
+ "args": [
+ "--from",
+ "git+https://github.com/Sam-AEC/aec-model-bridge#subdirectory=packages/mcp-server-revit",
+ "aec-model-bridge"
+ ],
+ "env": {
+ "MCP_REVIT_MODE": "bridge",
+ "MCP_REVIT_WORKSPACE_DIR": "C:\\RevitProjects",
+ "MCP_REVIT_ALLOWED_DIRECTORIES": "C:\\RevitProjects"
+ }
+ }
+ }
+}
+```
+
+Want to look at the tools first, without Revit? Set `"MCP_REVIT_MODE": "mock"`.
+The server then starts anywhere, lists every tool with its schema and returns
+canned responses instead of touching a model. A `Dockerfile` for the same mock
+mode is in the repository root (`docker build -t aec-model-bridge .`, then
+`docker run -i --rm aec-model-bridge`).
+
+### Tools at a glance
+
+| Area | Tools | What they do |
+| --- | --- | --- |
+| Revit | 103 | Read the model, create and edit elements, parameters, views, sheets, schedules, exports, worksharing |
+| Approval | 6 | Plan, review, approve, execute and roll back model changes |
+| Modules | 34 | Snapshot inspection, parameter grids, QA/QC checks, recipes, reports, selections |
+| Rhino and Grasshopper | 19 | Geometry, layers, materials, boolean operations |
+| Speckle | 17 | Projects, models, versions, send and receive |
+| Navisworks | 15 | Model tree, viewpoints, clash tests (in progress) |
+| IFC | 7 | Read IFC files without Revit: structure, properties, validation |
+| Graph, snapshots, exports, jobs | 18 | Semantic graph audits, snapshot diffs, SQLite export, background jobs |
+
+219 tools are listed in the default setup (counts from the 1.3.1 server in mock
+mode). The Autodesk Data tools appear when APS credentials are configured. The
+[tool reference](docs/tools-generated.md) lists every tool. Each tool carries
+MCP annotations (`readOnlyHint`, `destructiveHint`, `idempotentHint`,
+`openWorldHint`), so clients can tell reads from writes.
+
+### Demo
+
+> TODO (owner): add a 30 to 60 second screen recording here as
+> `assets/demo.gif` (or a linked video): ask Claude for a change, the plan
+> appears in the Revit panel, you approve it, the model updates. No demo is
+> shown until a real recording exists.
+
## What can the AI do in Revit?
The server exposes more than 200 tools across all providers. The full list is
diff --git a/docs/tools-generated.md b/docs/tools-generated.md
index 5a4ad20..1775d33 100644
--- a/docs/tools-generated.md
+++ b/docs/tools-generated.md
@@ -20,12 +20,12 @@ This catalog lists all tools exposed by the AEC Model Bridge providers.
| Tool Name | Description | Mutating? | Execution Type |
| --- | --- | --- | --- |
-| `approve_plan` | Approve a pending ActionPlan for execution. | No | sync |
+| `approve_plan` | Approve a pending ActionPlan so that its actions may be executed. | No | sync |
| `execute_plan` | Run every action in an approved ActionPlan. | No | sync |
-| `list_pending_plans` | List all pending ActionPlans waiting for review. | No | sync |
-| `plan_actions` | Create a draft ActionPlan of proposed modifications, capturing their before-states. | No | sync |
-| `reject_plan` | Reject and archive a pending ActionPlan. | No | sync |
-| `rollback_plan` | Rollback an executed ActionPlan using inverse values. | No | sync |
+| `list_pending_plans` | List all ActionPlans that are waiting for review. | No | sync |
+| `plan_actions` | Create a draft ActionPlan describing the model changes you want to make, capturing the before-state of each. | No | sync |
+| `reject_plan` | Reject and archive a pending ActionPlan so that it can never be executed. | No | sync |
+| `rollback_plan` | Undo an already executed ActionPlan by applying the inverse of each recorded change, in reverse order. | No | sync |
## Autodesk Data Provider
@@ -61,7 +61,7 @@ This catalog lists all tools exposed by the AEC Model Bridge providers.
| Tool Name | Description | Mutating? | Execution Type |
| --- | --- | --- | --- |
| `job_cancel` | Cancel a running or queued background job. | No | sync |
-| `job_status` | Get the status, progress, results, or error details of a background job. | No | sync |
+| `job_status` | Return the status, progress, result or error of a background job started with run_async. | No | sync |
## Mcp Proxy Provider
@@ -71,168 +71,168 @@ This catalog lists all tools exposed by the AEC Model Bridge providers.
| Tool Name | Description | Mutating? | Execution Type |
| --- | --- | --- | --- |
-| `familytype_mapper_audit_families` | Audit Families. | No | sync |
-| `familytype_mapper_list_type_mappings` | List Type Mappings. | No | sync |
-| `hello_world_say_hello` | Say Hello. | No | sync |
-| `model_inspector_ask` | Ask About Model. | No | sync |
-| `model_inspector_inspect_selection` | Inspect Selection. | No | sync |
-| `model_inspector_list_groups` | List Model Groups. | No | sync |
-| `model_inspector_list_saved_queries` | List Saved Queries. | No | sync |
-| `model_inspector_run_saved_query` | Run Saved Query. | No | sync |
-| `model_inspector_save_query` | Save Query. | No | sync |
-| `model_inspector_summarize_model` | Summarize Model. | No | sync |
-| `module_list_commands` | List all registered modules and their commands for dockable panels. | No | sync |
-| `parameter_manager_diff_params` | Diff Parameter Values. | No | sync |
-| `parameter_manager_export_params_csv` | Export Parameters to CSV. | No | sync |
-| `parameter_manager_filter_params` | Filter Parameter Grid. | No | sync |
-| `parameter_manager_import_params_csv` | Import Parameters from CSV. | Yes | sync |
-| `parameter_manager_plan_set_params` | Plan Parameter Set. | Yes | sync |
-| `qaqc_checker_list_issues` | List QA/QC Issues. | No | sync |
-| `qaqc_checker_list_rules` | List Available Rules. | No | sync |
-| `qaqc_checker_resolve_issue` | Resolve Issue. | No | sync |
-| `qaqc_checker_run_check` | Run QA/QC Check. | No | sync |
-| `recipe_runner_get_run_status` | Get Recipe Run Status. | No | sync |
-| `recipe_runner_list_recipes` | List Recipes. | No | sync |
-| `recipe_runner_list_runs` | List Recipe Runs. | No | sync |
-| `recipe_runner_run_recipe` | Run Recipe. | No | sync |
-| `report_generator_export_excel` | Export to Excel. | No | sync |
-| `report_generator_export_sqlite_summary` | Export SQLite Summary. | No | sync |
-| `selection_tools_group_convert_to_detail` | Convert Group to Detail Group. | Yes | sync |
-| `selection_tools_group_rename` | Rename Group. | Yes | sync |
-| `selection_tools_group_ungroup` | Ungroup Group. | Yes | sync |
-| `selection_tools_list_saved_selections` | List Saved Selections. | No | sync |
-| `selection_tools_restore_selection` | Restore Selection. | Yes | sync |
-| `selection_tools_save_selection` | Save Selection. | No | sync |
-| `selection_tools_select_by_query` | Select By Query. | Yes | sync |
-| `selection_tools_set_selection` | Set Selection. | Yes | sync |
+| `familytype_mapper_audit_families` | Audit the families in a saved snapshot and report problems such as unmapped or inconsistent family types. | No | sync |
+| `familytype_mapper_list_type_mappings` | List family-type mappings found in a saved snapshot, optionally for one category. | No | sync |
+| `hello_world_say_hello` | Example module command that returns a greeting; use it to confirm the module system works. | No | sync |
+| `model_inspector_ask` | Answer a question about a saved snapshot by filtering its element records with the filter DSL. | No | sync |
+| `model_inspector_inspect_selection` | Return the snapshot records of the given elements (by UniqueId). | No | sync |
+| `model_inspector_list_groups` | List the model groups found in a saved snapshot. | No | sync |
+| `model_inspector_list_saved_queries` | List the saved named queries. | No | sync |
+| `model_inspector_run_saved_query` | Run a previously saved named query against a saved snapshot. | No | sync |
+| `model_inspector_save_query` | Save a named filter query so it can be re-run later with model_inspector_run_saved_query. | No | sync |
+| `model_inspector_summarize_model` | Summarise a saved snapshot, for example element counts by category. | No | sync |
+| `module_list_commands` | List all registered modules and the commands they expose to the dockable Revit panel. | No | sync |
+| `parameter_manager_diff_params` | Compare parameter values between two saved snapshots and list the differences. | No | sync |
+| `parameter_manager_export_params_csv` | Export parameters of the matching snapshot elements to a CSV file in the workspace. | No | sync |
+| `parameter_manager_filter_params` | Return a parameter grid for the elements of a snapshot that match a filter, optionally including read-only parameters. | No | sync |
+| `parameter_manager_import_params_csv` | Import parameter values from a CSV file in the workspace and apply them to elements. | Yes | sync |
+| `parameter_manager_plan_set_params` | Create a draft ActionPlan that sets parameter values on the elements of a snapshot matching a filter. | Yes | sync |
+| `qaqc_checker_list_issues` | List recorded QA/QC issues for a document, optionally filtered by status and severity. | No | sync |
+| `qaqc_checker_list_rules` | List the QA/QC rules that are available, optionally for one rule pack. | No | sync |
+| `qaqc_checker_resolve_issue` | Mark one recorded QA/QC issue as resolved. | No | sync |
+| `qaqc_checker_run_check` | Run a QA/QC rule pack against a saved snapshot and record the issues it finds. | No | sync |
+| `recipe_runner_get_run_status` | Return the status and results of one recipe run. | No | sync |
+| `recipe_runner_list_recipes` | List the available automation recipes. | No | sync |
+| `recipe_runner_list_runs` | List past recipe runs, optionally for one recipe. | No | sync |
+| `recipe_runner_run_recipe` | Run a named automation recipe (a YAML-defined sequence of tool calls) with arguments; set dry_run to list the steps without executing them. | No | sync |
+| `report_generator_export_excel` | Export a snapshot (optionally filtered, with chosen parameters and QA/QC findings) to an Excel workbook in the workspace. | No | sync |
+| `report_generator_export_sqlite_summary` | Export a summary of a snapshot to a SQLite database file in the workspace. | No | sync |
+| `selection_tools_group_convert_to_detail` | Convert a model group into a detail group. | Yes | sync |
+| `selection_tools_group_rename` | Rename a model group identified by its UniqueId. | Yes | sync |
+| `selection_tools_group_ungroup` | Ungroup a model group identified by its UniqueId. | Yes | sync |
+| `selection_tools_list_saved_selections` | List the saved named selections. | No | sync |
+| `selection_tools_restore_selection` | Re-select a previously saved named selection in the Revit UI. | Yes | sync |
+| `selection_tools_save_selection` | Save a set of element UniqueIds under a name for later restore. | No | sync |
+| `selection_tools_select_by_query` | Select in Revit the elements of a snapshot that match a filter query. | Yes | sync |
+| `selection_tools_set_selection` | Select the given elements (by UniqueId) in the Revit UI. | Yes | sync |
## Navisworks Provider
| Tool Name | Description | Mutating? | Execution Type |
| --- | --- | --- | --- |
-| `navisworks_activate_viewpoint` | Activate a saved viewpoint by Guid. | No | sync |
-| `navisworks_append_file` | Append a file (e. | No | sync |
-| `navisworks_create_viewpoint` | Create a new saved viewpoint from the current view. | Yes | sync |
-| `navisworks_get_clash_results` | Get results for a clash test by Guid. | No | sync |
-| `navisworks_get_document_info` | Get info about the active Navisworks document. | No | sync |
-| `navisworks_get_model_tree` | Get the model hierarchy tree in Navisworks. | No | sync |
-| `navisworks_get_selection` | Get active selection items in Navisworks. | No | sync |
-| `navisworks_health` | Check if Navisworks is running and get status information. | No | sync |
-| `navisworks_invoke_method` | Invoke a C# method in Navisworks via reflection. | Yes | sync |
-| `navisworks_list_clash_tests` | List clash tests defined in Clash Detective. | No | sync |
-| `navisworks_list_viewpoints` | List saved viewpoints. | No | sync |
-| `navisworks_reflect_get` | Get a C# property value from a Navisworks object via reflection. | No | sync |
-| `navisworks_reflect_set` | Set a C# property value on a Navisworks object via reflection. | Yes | sync |
-| `navisworks_refresh` | Refresh all updated files in the active document. | No | sync |
-| `navisworks_run_clash_test` | Run a clash test by Guid. | Yes | sync |
+| `navisworks_activate_viewpoint` | Switch the Navisworks view to a saved viewpoint identified by its Guid. | No | sync |
+| `navisworks_append_file` | Append a model file (for example NWD, NWC or IFC) from the allowed workspace to the active Navisworks document. | No | sync |
+| `navisworks_create_viewpoint` | Create a saved viewpoint with the given name from the current view. | Yes | sync |
+| `navisworks_get_clash_results` | Return the results of one clash test, with paging by skip and limit. | No | sync |
+| `navisworks_get_document_info` | Return metadata about the active Navisworks document. | No | sync |
+| `navisworks_get_model_tree` | Return the model hierarchy tree of the active Navisworks document down to a maximum depth. | No | sync |
+| `navisworks_get_selection` | Return the items currently selected in Navisworks. | No | sync |
+| `navisworks_health` | Check that the Navisworks bridge is reachable and return its status. | No | sync |
+| `navisworks_invoke_method` | Advanced escape hatch: call a public C# method in Navisworks through reflection. | Yes | sync |
+| `navisworks_list_clash_tests` | List the clash tests defined in Clash Detective. | No | sync |
+| `navisworks_list_viewpoints` | List the saved viewpoints of the active Navisworks document. | No | sync |
+| `navisworks_reflect_get` | Advanced: read a C# property of a Navisworks object through reflection. | No | sync |
+| `navisworks_reflect_set` | Advanced escape hatch: set a C# property of a Navisworks object through reflection. | Yes | sync |
+| `navisworks_refresh` | Refresh all appended files that changed on disk in the active Navisworks document. | No | sync |
+| `navisworks_run_clash_test` | Run one Clash Detective test, identified by Guid, and update its results. | Yes | sync |
## Revit Provider
| Tool Name | Description | Mutating? | Execution Type |
| --- | --- | --- | --- |
-| `revit_apply_view_template` | Apply view template to a view. | Yes | sync |
-| `revit_batch_create_sheets_from_csv` | Create multiple sheets from a CSV file. | Yes | sync |
-| `revit_batch_set_parameters` | Set a parameter value for multiple elements. | Yes | sync |
+| `revit_apply_view_template` | Apply a view template to a view. | Yes | sync |
+| `revit_batch_create_sheets_from_csv` | Create many sheets from a CSV file inside the allowed workspace, using the named title block. | Yes | sync |
+| `revit_batch_set_parameters` | Set the same parameter to the same value on many elements, given by ElementId, in one Revit transaction. | Yes | sync |
| `revit_batch_set_parameters_by_filter` | Set a parameter value on all elements matching a filter (category, type, level, or parameter value). | Yes | sync |
-| `revit_calculate_material_quantities` | Calculate material volumes for a category. | No | sync |
+| `revit_calculate_material_quantities` | Calculate material volumes and areas for all elements of a category. | No | sync |
| `revit_change_element_type` | Swap all instances of one element type to another type. | Yes | sync |
-| `revit_check_clashes` | Check clashes between categories. | No | sync |
-| `revit_close_document` | Close active document. | Yes | sync |
-| `revit_convert_to_group` | Convert elements into a group. | Yes | sync |
-| `revit_copy_element` | Copy an element. | Yes | sync |
-| `revit_create_3d_view` | Create a new 3D view. | Yes | sync |
-| `revit_create_beam` | Create structural beam. | Yes | sync |
-| `revit_create_column` | Create structural column. | Yes | sync |
-| `revit_create_conduit` | Create electrical conduit. | Yes | sync |
-| `revit_create_dimension` | Create linear dimension between elements. | Yes | sync |
-| `revit_create_duct` | Create duct. | Yes | sync |
-| `revit_create_floor` | Create a floor in Revit with a rectangular or custom boundary. | Yes | sync |
-| `revit_create_floor_plan_view` | Create a floor plan view for a level. | Yes | sync |
-| `revit_create_foundation` | Create foundation. | Yes | sync |
-| `revit_create_grid` | Create a grid line in Revit. | Yes | sync |
-| `revit_create_group` | Create a group. | Yes | sync |
-| `revit_create_level` | Create a new level in Revit. | Yes | sync |
-| `revit_create_material` | Create a new material with color and properties. | Yes | sync |
-| `revit_create_new_document` | Create new project. | Yes | sync |
-| `revit_create_pipe` | Create pipe. | Yes | sync |
-| `revit_create_project_parameter` | Create a new project parameter. | Yes | sync |
-| `revit_create_roof` | Create a roof in Revit. | Yes | sync |
-| `revit_create_room` | Create a room at a specific point on a level. | Yes | sync |
-| `revit_create_schedule` | Create a schedule. | Yes | sync |
-| `revit_create_section_view` | Create a section view. | Yes | sync |
-| `revit_create_shared_parameter` | Create a new shared parameter. | Yes | sync |
-| `revit_create_sheet` | Create a new sheet. | Yes | sync |
-| `revit_create_tag` | Tag an element. | Yes | sync |
-| `revit_create_text_note` | Create a text note. | Yes | sync |
-| `revit_create_wall` | Create a wall in Revit between two points. | Yes | sync |
-| `revit_delete_element` | Delete an element by ID. | Yes | sync |
-| `revit_delete_sheet` | Delete a sheet. | Yes | sync |
-| `revit_duplicate_sheet` | Duplicate a sheet. | Yes | sync |
-| `revit_edit_family` | Open a family for editing. | Yes | sync |
+| `revit_check_clashes` | Check for geometric clashes between elements of two categories, within a tolerance (feet). | No | sync |
+| `revit_close_document` | Close the active Revit document, optionally saving changes first. | Yes | sync |
+| `revit_convert_to_group` | Convert a set of elements into a named model group. | Yes | sync |
+| `revit_copy_element` | Copy one element and place the copy at an offset vector in feet from the original. | Yes | sync |
+| `revit_create_3d_view` | Create a new 3D view with the given name in the active Revit document. | Yes | sync |
+| `revit_create_beam` | Create a structural beam of a given family type between two x/y points on a level. | Yes | sync |
+| `revit_create_column` | Create a structural column of a given family type at an x/y point on a level. | Yes | sync |
+| `revit_create_conduit` | Create an electrical conduit between two points at a given diameter on a level. | Yes | sync |
+| `revit_create_dimension` | Create a linear dimension between two points or two elements in the active view. | Yes | sync |
+| `revit_create_duct` | Create a duct between two points at an elevation on a level, with a mechanical system type and duct type. | Yes | sync |
+| `revit_create_floor` | Create a floor on a level from a closed boundary of points in the active Revit document. | Yes | sync |
+| `revit_create_floor_plan_view` | Create a floor plan view for the named level in the active Revit document. | Yes | sync |
+| `revit_create_foundation` | Create a foundation element of a given family type at a point on a level. | Yes | sync |
+| `revit_create_grid` | Create a straight grid line between two points in the active Revit document. | Yes | sync |
+| `revit_create_group` | Create a model group from a list of ElementIds, with a name. | Yes | sync |
+| `revit_create_level` | Create a new level with the given name at the given elevation (feet) in the active Revit document. | Yes | sync |
+| `revit_create_material` | Create a new material with a colour, transparency, shininess and smoothness. | Yes | sync |
+| `revit_create_new_document` | Create a new Revit project, optionally from a template file inside the allowed workspace. | Yes | sync |
+| `revit_create_pipe` | Create a pipe between two points at an elevation on a level, with a piping system type and pipe type. | Yes | sync |
+| `revit_create_project_parameter` | Create a new project parameter and bind it to a category in the active Revit document. | Yes | sync |
+| `revit_create_roof` | Create a roof on a level from a closed footprint of points, with an optional slope, in the active Revit document. | Yes | sync |
+| `revit_create_room` | Create a room at an x/y point on a level, with a name and number, in the active Revit document. | Yes | sync |
+| `revit_create_schedule` | Create a schedule view for a category with the given name. | Yes | sync |
+| `revit_create_section_view` | Create a section view between two points with the given height in the active Revit document. | Yes | sync |
+| `revit_create_shared_parameter` | Create a new shared parameter with a name, parameter group and data type in the active Revit document. | Yes | sync |
+| `revit_create_sheet` | Create a new sheet with a name, number and title block in the active Revit document. | Yes | sync |
+| `revit_create_tag` | Tag one element at an x/y position in a view. | Yes | sync |
+| `revit_create_text_note` | Create a text note at an x/y position in a view of the active Revit document. | Yes | sync |
+| `revit_create_wall` | Create a straight wall between two points on a level in the active Revit document. | Yes | sync |
+| `revit_delete_element` | Delete one element by its Revit ElementId from the active document. | Yes | sync |
+| `revit_delete_sheet` | Delete a sheet by ElementId. | Yes | sync |
+| `revit_duplicate_sheet` | Duplicate a sheet, optionally with its views, using one of Revit's duplicate options. | Yes | sync |
+| `revit_edit_family` | Open a family for editing in the Revit family editor. | Yes | sync |
| `revit_execute_python` | Execute arbitrary Python/IronPython code inside Revit with broad access to the public Revit API. | Yes | sync |
-| `revit_export_dwg` | Export view to DWG. | No | sync |
-| `revit_export_ifc` | Export to IFC. | No | sync |
-| `revit_export_image` | Export view to Image. | No | sync |
-| `revit_export_navisworks` | Export to NWC. | No | sync |
+| `revit_export_dwg` | Export a view to a DWG file at a path inside the allowed workspace. | No | sync |
+| `revit_export_ifc` | Export the model to an IFC file at a path inside the allowed workspace. | No | sync |
+| `revit_export_image` | Export a view to an image file of the given pixel size at a path inside the allowed workspace. | No | sync |
+| `revit_export_navisworks` | Export the model to a Navisworks NWC file at a path inside the allowed workspace. | No | sync |
| `revit_extract_snapshot` | Extract a semantic BIM snapshot of the active document. | No | sync |
-| `revit_get_categories` | List Revit categories. | No | sync |
-| `revit_get_design_options` | Get design options. | No | sync |
-| `revit_get_document_info` | Get information about the active Revit document. | No | sync |
-| `revit_get_element_bounding_box` | Get element bounding box. | No | sync |
+| `revit_get_categories` | List the Revit categories available in the active document. | No | sync |
+| `revit_get_design_options` | List the design option sets and options of the active Revit document. | No | sync |
+| `revit_get_document_info` | Return metadata about the active Revit document, such as its title, path and workshare status. | No | sync |
+| `revit_get_element_bounding_box` | Return the axis-aligned bounding box (min and max corner, feet) of an element. | No | sync |
| `revit_get_element_geometry` | Get geometric data for an element: location point or curve endpoints, bounding box, level, area, volume, and length. | No | sync |
-| `revit_get_element_parameters` | Get all parameters of an element. | No | sync |
-| `revit_get_element_type` | Find element types/families. | No | sync |
+| `revit_get_element_parameters` | Return every instance parameter of one element (name, value, storage type and read-only flag). | No | sync |
+| `revit_get_element_type` | Find element types by category name and family name in the active document. | No | sync |
| `revit_get_elements_by_type` | Get element IDs and key parameters, filtered by type, category, and/or level. | No | sync |
-| `revit_get_group_members` | Get group members. | No | sync |
-| `revit_get_link_instances` | Get link instances. | No | sync |
-| `revit_get_parameter_value` | Get a specific parameter value. | No | sync |
-| `revit_get_phase_filters` | Get phase filters. | No | sync |
-| `revit_get_phases` | Get project phases. | No | sync |
-| `revit_get_revision_sequences` | Get list of revision sequences. | No | sync |
-| `revit_get_rvt_links` | Get RVT links. | No | sync |
-| `revit_get_schedule_data` | Get schedule data. | No | sync |
-| `revit_get_selection` | Get currently selected element IDs. | No | sync |
-| `revit_get_sheet_info` | Get detailed information about a sheet. | No | sync |
+| `revit_get_group_members` | List the member elements of a model group. | No | sync |
+| `revit_get_link_instances` | List the placed instances of linked Revit models in the active document. | No | sync |
+| `revit_get_parameter_value` | Read the value of one named parameter on one element. | No | sync |
+| `revit_get_phase_filters` | List the phase filters of the active Revit document. | No | sync |
+| `revit_get_phases` | List the project phases of the active Revit document. | No | sync |
+| `revit_get_revision_sequences` | List the revision sequences defined in the active Revit document. | No | sync |
+| `revit_get_rvt_links` | List the linked Revit models (link types) in the active document. | No | sync |
+| `revit_get_schedule_data` | Return the rows and columns of an existing schedule. | No | sync |
+| `revit_get_selection` | Return the ElementIds of the elements currently selected in the Revit UI. | No | sync |
+| `revit_get_sheet_info` | Return detailed information about one sheet, such as its number, name, title block and placed views. | No | sync |
| `revit_get_snapshot_delta` | Get lists of unique IDs for elements added, modified, or deleted during the active session. | No | sync |
-| `revit_get_type_parameters` | Get type parameters for an element. | No | sync |
-| `revit_get_view_templates` | Get list of view templates. | No | sync |
-| `revit_get_warnings` | Get current project warnings. | No | sync |
-| `revit_get_worksets` | Get all worksets. | No | sync |
-| `revit_health` | Check if Revit is running and get status information. | No | sync |
-| `revit_invoke_method` | Invoke any Revit API method dynamically using Reflection. | Yes | sync |
-| `revit_list_elements` | List elements by category (Walls, Floors, Roofs, Doors, Windows, etc. | No | sync |
-| `revit_list_families` | List all loaded families and their types. | No | sync |
-| `revit_list_levels` | List all levels in the Revit project. | No | sync |
-| `revit_list_project_parameters` | List project parameters. | No | sync |
-| `revit_list_shared_parameters` | List shared parameters in the document. | No | sync |
-| `revit_list_sheets` | List all sheets. | No | sync |
-| `revit_list_titleblocks` | List available titleblocks. | No | sync |
-| `revit_list_views` | List all views in the Revit project. | No | sync |
-| `revit_mirror_element` | Mirror an element. | Yes | sync |
-| `revit_move_element` | Move an element. | Yes | sync |
-| `revit_pin_element` | Pin an element. | Yes | sync |
-| `revit_place_door` | Place a door in a wall. | Yes | sync |
-| `revit_place_family_instance` | Place a family instance (e. | Yes | sync |
-| `revit_place_viewport_on_sheet` | Place a view on a sheet. | Yes | sync |
-| `revit_place_window` | Place a window in a wall. | Yes | sync |
-| `revit_populate_titleblock` | Populate titleblock parameters. | Yes | sync |
-| `revit_reflect_get` | Get any Revit property value dynamically. | No | sync |
-| `revit_reflect_set` | Set any Revit property value dynamically. | Yes | sync |
-| `revit_relinquish_all` | Relinquish all elements and worksets. | Yes | sync |
-| `revit_render_3d` | Render 3D view to image. | No | sync |
-| `revit_renumber_sheets` | Batch renumber sheets. | Yes | sync |
+| `revit_get_type_parameters` | Return the type parameters of the family type that an element belongs to. | No | sync |
+| `revit_get_view_templates` | List the view templates available in the active Revit document. | No | sync |
+| `revit_get_warnings` | Return the current warnings of the active Revit project (for example overlapping or duplicate elements). | No | sync |
+| `revit_get_worksets` | List the worksets of a workshared model with their owners and open state. | No | sync |
+| `revit_health` | Check that the Revit bridge is reachable and return its status information. | No | sync |
+| `revit_invoke_method` | Advanced escape hatch: call any public Revit API method by class and method name through reflection, optionally inside a transaction. | Yes | sync |
+| `revit_list_elements` | List the elements of one Revit category (for example Walls, Floors, Roofs, Doors or Windows) in the active document. | No | sync |
+| `revit_list_families` | List the families loaded in the active Revit document together with their types. | No | sync |
+| `revit_list_levels` | List all levels in the active Revit project with their names and elevations. | No | sync |
+| `revit_list_project_parameters` | List the project parameters defined in the active Revit document with the categories they are bound to. | No | sync |
+| `revit_list_shared_parameters` | List the shared parameters defined in the active Revit document. | No | sync |
+| `revit_list_sheets` | List all sheets in the active Revit project with their numbers, names and ids. | No | sync |
+| `revit_list_titleblocks` | List the title block family types available in the active Revit document. | No | sync |
+| `revit_list_views` | List all views in the active Revit project with their names, ids and view types. | No | sync |
+| `revit_mirror_element` | Mirror one element about a plane given by an origin point and a normal vector. | Yes | sync |
+| `revit_move_element` | Move one element by an offset vector in feet. | Yes | sync |
+| `revit_pin_element` | Pin an element so it cannot be moved by accident. | Yes | sync |
+| `revit_place_door` | Place a door of a given family and type in a host wall at a location. | Yes | sync |
+| `revit_place_family_instance` | Place an instance of a loaded family type (for example furniture or equipment) at a point on a level. | Yes | sync |
+| `revit_place_viewport_on_sheet` | Place a view on a sheet at an x/y position (feet on the sheet). | Yes | sync |
+| `revit_place_window` | Place a window of a given family and type in a host wall at a location. | Yes | sync |
+| `revit_populate_titleblock` | Write a set of parameter values into the title block of a sheet. | Yes | sync |
+| `revit_reflect_get` | Advanced: read any public Revit API property of an object identified by target_id, through reflection. | No | sync |
+| `revit_reflect_set` | Advanced escape hatch: set any writable Revit API property of an object identified by target_id, through reflection. | Yes | sync |
+| `revit_relinquish_all` | Relinquish every element and workset the current user owns in a workshared model. | Yes | sync |
+| `revit_render_3d` | Render a 3D view to an image file at a chosen quality level. | No | sync |
+| `revit_renumber_sheets` | Renumber all sheets in one batch using a prefix and a starting number. | Yes | sync |
| `revit_replace_family_type` | Replace all instances of one family/type combination with another, identified by name. | Yes | sync |
-| `revit_rotate_element` | Rotate an element. | Yes | sync |
-| `revit_save_document` | Save the current Revit document. | Yes | sync |
-| `revit_select_by_unique_ids` | Select and zoom to elements in the active view by their UniqueId. | No | sync |
-| `revit_set_element_material` | Set material for an element or specific face. | Yes | sync |
-| `revit_set_parameter_value` | Set a parameter value for an element. | Yes | sync |
-| `revit_set_selection` | Set selection by element IDs. | Yes | sync |
-| `revit_set_type_parameter` | Set a type parameter value. | Yes | sync |
-| `revit_sync_to_central` | Sync to central model. | Yes | sync |
-| `revit_tag_all_in_view` | Tag all elements of a category in view. | Yes | sync |
-| `revit_ungroup` | Ungroup a group. | Yes | sync |
-| `revit_unpin_element` | Unpin an element. | Yes | sync |
+| `revit_rotate_element` | Rotate one element about a vertical axis through a centre point by an angle in radians. | Yes | sync |
+| `revit_save_document` | Save the active Revit document, optionally to a path inside the allowed workspace directories. | Yes | sync |
+| `revit_select_by_unique_ids` | Select elements by UniqueId and zoom to them in the active view. | No | sync |
+| `revit_set_element_material` | Assign a material, by name, to an element or to one of its faces. | Yes | sync |
+| `revit_set_parameter_value` | Set one instance parameter on one element to a new value in the active Revit document. | Yes | sync |
+| `revit_set_selection` | Replace the current Revit UI selection with the given ElementIds. | Yes | sync |
+| `revit_set_type_parameter` | Set one type parameter on the family type of an element. | Yes | sync |
+| `revit_sync_to_central` | Synchronise a workshared model with the central model with a comment, optionally relinquishing ownership. | Yes | sync |
+| `revit_tag_all_in_view` | Tag every element of a category in the active view. | Yes | sync |
+| `revit_ungroup` | Dissolve a model group into its member elements. | Yes | sync |
+| `revit_unpin_element` | Unpin a previously pinned element so it can be moved again. | Yes | sync |
## Rhino Provider
@@ -240,19 +240,19 @@ This catalog lists all tools exposed by the AEC Model Bridge providers.
| --- | --- | --- | --- |
| `rhino_boolean_difference` | Subtract cutter Breps from a base Brep; returns new object GUIDs. | Yes | sync |
| `rhino_boolean_union` | Boolean union a list of Brep objects by GUID; returns new object GUIDs. | Yes | sync |
-| `rhino_clear_scene` | Delete all objects in the Rhino document, or only objects on a specific layer. | Yes | sync |
+| `rhino_clear_scene` | Delete all objects in the Rhino document, or only the objects on one layer. | Yes | sync |
| `rhino_create_box` | Create a box (rectangular prism) from two corner points in metres. | Yes | sync |
| `rhino_create_cylinder` | Create a capped cylinder from base point, height, and radius in metres. | Yes | sync |
| `rhino_create_sphere` | Create a sphere by centre point and radius in metres. | Yes | sync |
| `rhino_generate_diagrid_tower` | Generate a parametric diagrid skyscraper with aluminum mullion sweeps and glass panel solids. | No | sync |
-| `rhino_get_document_info` | Get the active Rhino document name, path, unit system, and object count. | No | sync |
-| `rhino_get_lines` | Get all curves/lines from the active Rhino document. | No | sync |
-| `rhino_get_scene` | Get all objects in the Rhino scene with their type, layer, and bounding box. | No | sync |
-| `rhino_health` | Check if the Rhino bridge is running and healthy. | No | sync |
-| `rhino_invoke_method` | Invoke a C# method on a Rhino object via reflection. | Yes | sync |
-| `rhino_list_layers` | List all layers in the Rhino document with name, color, visibility, and lock state. | No | sync |
-| `rhino_reflect_get` | Get a C# property value from a Rhino object via reflection. | No | sync |
-| `rhino_reflect_set` | Set a C# property value on a Rhino object via reflection. | Yes | sync |
+| `rhino_get_document_info` | Return the active Rhino document name, path, unit system and object count. | No | sync |
+| `rhino_get_lines` | Return all curves and lines in the active Rhino document. | No | sync |
+| `rhino_get_scene` | Return every object in the Rhino scene with its type, layer and bounding box. | No | sync |
+| `rhino_health` | Check that the Rhino bridge is reachable and healthy. | No | sync |
+| `rhino_invoke_method` | Advanced escape hatch: call a public C# method on a Rhino object through reflection. | Yes | sync |
+| `rhino_list_layers` | List all layers of the Rhino document with name, colour, visibility and lock state. | No | sync |
+| `rhino_reflect_get` | Advanced: read a C# property of a Rhino object through reflection. | No | sync |
+| `rhino_reflect_set` | Advanced escape hatch: set a C# property of a Rhino object through reflection. | Yes | sync |
| `rhino_run_python` | Execute arbitrary IronPython code inside Rhino with full RhinoCommon access. | Yes | sync |
| `rhino_set_material` | Apply a material to objects by GUID list or by layer name. | Yes | sync |
| `rhino_set_view` | Set the active Rhino viewport display mode or projection. | Yes | sync |
@@ -274,19 +274,19 @@ This catalog lists all tools exposed by the AEC Model Bridge providers.
| Tool Name | Description | Mutating? | Execution Type |
| --- | --- | --- | --- |
-| `speckle_auth_status` | Get Speckle OAuth authentication status. | No | sync |
-| `speckle_checkout_version` | Checkout Speckle version metadata. | No | sync |
+| `speckle_auth_status` | Report the current Speckle OAuth authentication status of this server (signed in or not). | No | sync |
+| `speckle_checkout_version` | Retrieve the metadata of one Speckle version by ID. | No | sync |
| `speckle_create_branch` | Create an isolated Speckle branch for compatibility with model workflows. | Yes | sync |
| `speckle_create_model` | Create an isolated Speckle model. | Yes | sync |
-| `speckle_get_version_metadata` | Read Speckle version metadata. | No | sync |
-| `speckle_health` | Check Speckle provider health. | No | sync |
+| `speckle_get_version_metadata` | Read the metadata of one Speckle version by project and version ID. | No | sync |
+| `speckle_health` | Check that the Speckle provider is configured and report whether it can reach the Speckle server. | No | sync |
| `speckle_list_models` | List Speckle models for a project. | No | sync |
-| `speckle_list_projects` | List Speckle projects. | No | sync |
+| `speckle_list_projects` | List the Speckle projects the signed-in user can access, up to a limit. | No | sync |
| `speckle_list_versions` | List Speckle versions for a model or branch. | No | sync |
| `speckle_merge_branch` | Compatibility alias for merge_model. | Yes | sync |
| `speckle_merge_model` | Merge one Speckle model or branch into another through GraphQL. | Yes | sync |
| `speckle_oauth_exchange_code` | Exchange a Speckle OAuth authorization code. | No | sync |
-| `speckle_oauth_refresh` | Refresh the Speckle OAuth access token. | No | sync |
+| `speckle_oauth_refresh` | Refresh the Speckle OAuth access token so later Speckle calls keep working. | No | sync |
| `speckle_oauth_start` | Generate a Speckle OAuth authorization URL using PKCE. | No | sync |
| `speckle_publish_version` | Publish a Speckle version by creating a commit through GraphQL. | Yes | sync |
| `speckle_receive_object` | Receives data from a Speckle stream/project using local credentials. | No | sync |
diff --git a/glama.json b/glama.json
new file mode 100644
index 0000000..1455bee
--- /dev/null
+++ b/glama.json
@@ -0,0 +1,6 @@
+{
+ "$schema": "https://glama.ai/mcp/schemas/server.json",
+ "maintainers": [
+ "Sam-AEC"
+ ]
+}
diff --git a/packages/mcp-server-revit/manifest.json b/packages/mcp-server-revit/manifest.json
index 1908309..b1ee461 100644
--- a/packages/mcp-server-revit/manifest.json
+++ b/packages/mcp-server-revit/manifest.json
@@ -3,8 +3,8 @@
"name": "aec-model-bridge",
"display_name": "AEC Model Bridge",
"version": "1.3.1",
- "description": "Independent MCP integration for Autodesk Revit software through a local bridge.",
- "long_description": "Connect MCP clients to a locally installed Revit application through the AEC Model Bridge add-in. The server exposes model authoring, documentation, inspection, export, worksharing, and advanced API tools.",
+ "description": "Revit MCP server: 200+ tools to read and edit BIM models, every change human-approved.",
+ "long_description": "AEC Model Bridge lets Claude and other MCP clients read and edit the Autodesk Revit model you have open. It needs Windows, a licensed Revit 2024-2027 and the AEC Model Bridge add-in (see the install guide). The server exposes more than 200 tools for model authoring, parameters, sheets and views, QA/QC, exports (IFC, DWG, images, Navisworks), worksharing and advanced API access, plus IFC, Rhino/Grasshopper and Speckle providers. Every tool that changes the model requires a plan that a human approves first (approval mode 'required', the default). Independent project, not affiliated with Autodesk. Dual licensed: GPL-3.0-or-later with a Revit linking exception, or a commercial license.",
"author": {
"name": "A. Sam Mohammad",
"url": "https://github.com/Sam-AEC"
@@ -68,6 +68,12 @@
"mcp",
"revit",
"autodesk",
- "bim"
+ "bim",
+ "aec",
+ "architecture",
+ "ifc",
+ "navisworks",
+ "rhino",
+ "speckle"
]
}
diff --git a/packages/mcp-server-revit/pyproject.toml b/packages/mcp-server-revit/pyproject.toml
index b1833f1..c399078 100644
--- a/packages/mcp-server-revit/pyproject.toml
+++ b/packages/mcp-server-revit/pyproject.toml
@@ -15,7 +15,11 @@ dependencies = [
"pydantic-settings>=1.3",
"httpx>=0.24",
"python-dotenv>=1.0",
- "mcp>=0.9.0",
+ # 1.10 added Tool.title and Tool.annotations (readOnlyHint etc.), which
+ # tool_metadata.py sets on every listed tool. Capped below 2: mcp 2.x (Python
+ # 3.12+) removed the low-level `Server.list_tools()` decorators this server is
+ # built on, so an unpinned install crashed at import time.
+ "mcp>=1.10,<2",
"ifcopenshell>=0.7.0",
"networkx>=3.0",
"specklepy>=3,<4",
@@ -48,6 +52,16 @@ Issues = "https://github.com/Sam-AEC/aec-model-bridge/issues"
requires = ["setuptools>=77", "wheel"]
build-backend = "setuptools.build_meta"
+# Module manifests, QA/QC rules and recipes are data files next to the code. Without
+# this they were left out of the wheel, so a pip/uvx install silently lacked the
+# ~34 module tools that a source checkout has.
+[tool.setuptools.package-data]
+revit_mcp_server = [
+ "modules/*/module.json",
+ "modules/*/rules/*.yaml",
+ "modules/*/recipes/*.yaml",
+]
+
[tool.pytest.ini_options]
markers = [
"e2e: marks Revit bridge end-to-end tests (opt in with AEC_MODEL_BRIDGE_E2E=1)",
diff --git a/packages/mcp-server-revit/scripts/generate_tool_docs.py b/packages/mcp-server-revit/scripts/generate_tool_docs.py
index d89f9b6..2c79c23 100644
--- a/packages/mcp-server-revit/scripts/generate_tool_docs.py
+++ b/packages/mcp-server-revit/scripts/generate_tool_docs.py
@@ -30,6 +30,7 @@ from revit_mcp_server.providers import (
ModuleProvider,
)
from revit_mcp_server.module_registry import ModuleRegistry
+from revit_mcp_server.tool_metadata import DESCRIPTIONS
from revit_mcp_server.config import config
try:
@@ -120,7 +121,7 @@ def main():
output_lines.append("| Tool Name | Description | Mutating? | Execution Type |")
output_lines.append("| --- | --- | --- | --- |")
for t in sorted_tools:
- desc = get_first_sentence(t.description)
+ desc = get_first_sentence(DESCRIPTIONS.get(t.name, t.description))
mutating_str = "Yes" if t.is_mutating else "No"
exec_str = t.execution_mode
output_lines.append(f"| `{t.name}` | {desc} | {mutating_str} | {exec_str} |")
diff --git a/packages/mcp-server-revit/src/revit_mcp_server/mcp_server.py b/packages/mcp-server-revit/src/revit_mcp_server/mcp_server.py
index f8fb575..2d845d2 100644
--- a/packages/mcp-server-revit/src/revit_mcp_server/mcp_server.py
+++ b/packages/mcp-server-revit/src/revit_mcp_server/mcp_server.py
@@ -4,6 +4,7 @@ MCP Server for AEC - Dynamic multi-provider automation server.
from __future__ import annotations
import asyncio
+import inspect
import json
import logging
from typing import Any
@@ -15,11 +16,42 @@ from mcp.types import Tool, TextContent
from .errors import BridgeError
from .registry_factory import build_registry
from .security.audit import redact_data
+from .tool_metadata import enrich_tool
logger = logging.getLogger(__name__)
+SERVER_INSTRUCTIONS = (
+ "AEC Model Bridge exposes Autodesk Revit (and Navisworks, Rhino, IFC, Speckle) as MCP tools. "
+ "Read-only tools run immediately. Every tool that changes a model requires an approved plan: "
+ "call plan_actions with the proposed changes, have the human approve it (approve_plan or the Revit panel), "
+ "then call execute_plan or pass the plan_id to the write tool. Revit lengths are in feet. "
+ "In MCP_REVIT_MODE=mock the server returns canned responses and needs no Revit."
+)
+
+
+def _package_version() -> str:
+ try:
+ from importlib.metadata import version
+
+ return version("aec-model-bridge")
+ except Exception:
+ return "0.0.0"
+
+
+def _make_server() -> Server:
+ # Report this package's version (not the MCP SDK's) and, where the installed
+ # SDK supports them, the usage instructions and website.
+ wanted = {
+ "version": _package_version(),
+ "instructions": SERVER_INSTRUCTIONS,
+ "website_url": "https://github.com/Sam-AEC/aec-model-bridge",
+ }
+ accepted = inspect.signature(Server.__init__).parameters
+ return Server("aec-model-bridge", **{k: v for k, v in wanted.items() if k in accepted})
+
+
# Initialize the MCP server
-app = Server("aec-model-bridge")
+app = _make_server()
# Registry components — populated in main() so importing this module never
# triggers provider construction (Rhino health probes, Speckle OAuth, SQLite
@@ -32,13 +64,12 @@ job_manager = None
@app.list_tools()
async def list_tools() -> list[Tool]:
"""List all available AEC tools from registered providers."""
+ # enrich_tool adds parameter docs and behaviour annotations (readOnlyHint,
+ # destructiveHint, idempotentHint, openWorldHint) without changing behaviour.
return [
- Tool(
- name=t.name,
- description=t.description,
- inputSchema=t.input_schema
- )
- for t in registry.get_all_tools()
+ enrich_tool(provider.get_identity(), t)
+ for provider in registry.get_all_providers()
+ for t in provider.get_capabilities()
]
@app.call_tool()
diff --git a/packages/mcp-server-revit/src/revit_mcp_server/providers/revit.py b/packages/mcp-server-revit/src/revit_mcp_server/providers/revit.py
index 5e0a8de..8645cd2 100644
--- a/packages/mcp-server-revit/src/revit_mcp_server/providers/revit.py
+++ b/packages/mcp-server-revit/src/revit_mcp_server/providers/revit.py
@@ -175,7 +175,7 @@ class RevitProvider(AECProvider):
handler = TOOL_HANDLERS.get(legacy_dot_name)
if handler:
try:
- handler(payload, self.workspace)
+ handler({"request_id": "mcp-bridge", **payload}, self.workspace)
except WorkspaceViolation:
# A workspace-sandbox escape must always block the call — swallowing
# this as a warning would let a path-outside-workspace request reach
@@ -195,7 +195,11 @@ class RevitProvider(AECProvider):
legacy_dot_name = bridge_tool
handler = TOOL_HANDLERS.get(legacy_dot_name)
if handler:
- return handler(payload, self.workspace)
+ # The legacy handlers' models require a request_id, which the MCP
+ # tool schemas do not expose. Supply one for the handler only, so a
+ # plain tool call (for example from a registry introspecting the
+ # server in mock mode) does not fail validation.
+ return handler({"request_id": "mcp-mock", **payload}, self.workspace)
# Fallback to general mock response
return self._bridge.send_tool(bridge_tool, payload)
diff --git a/packages/mcp-server-revit/src/revit_mcp_server/tool_metadata.py b/packages/mcp-server-revit/src/revit_mcp_server/tool_metadata.py
new file mode 100644
index 0000000..890c5b0
--- /dev/null
+++ b/packages/mcp-server-revit/src/revit_mcp_server/tool_metadata.py
@@ -0,0 +1,582 @@
+"""Presentation metadata for the MCP tool listing.
+
+Providers define tools with terse descriptions and schemas that often leave
+individual parameters undocumented. MCP directories (Glama, ToolBench, Smithery,
+...) and the LLMs that call the tools both score/depend on three things: a clear
+description, a documented input schema, and behaviour annotations
+(readOnlyHint / destructiveHint / idempotentHint / openWorldHint).
+
+This module layers that metadata on top of the provider definitions at listing
+time. It never changes what a tool does or how it is gated: `enrich_tool` returns
+a copy, and the annotations are *derived from* the existing `is_mutating` /
+`destructive` flags plus an explicit table of the few tools whose flag alone
+would be misleading (for example exports, which are not gated but do write files).
+"""
+from __future__ import annotations
+
+import copy
+from typing import Any
+
+from mcp.types import Tool, ToolAnnotations
+
+from .providers.base import ProviderTool
+
+APPROVAL_SUFFIX = (
+ " Write operation: when approval mode is 'required' (the default) it only runs "
+ "with the plan_id of an approved plan (see plan_actions and approve_plan)."
+)
+
+PLAN_ID_DESCRIPTION = (
+ "ID of an approved ActionPlan authorising this write (created with plan_actions, "
+ "approved with approve_plan). Required while approval mode is 'required'."
+)
+
+# --------------------------------------------------------------------------- #
+# Tool descriptions (only tools whose provider-defined text is too terse)
+# --------------------------------------------------------------------------- #
+DESCRIPTIONS: dict[str, str] = {
+ # --- Revit: model authoring -------------------------------------------
+ "revit_health": "Check that the Revit bridge is reachable and return its status information. Call this first to confirm Revit is running.",
+ "revit_create_wall": "Create a straight wall between two points on a level in the active Revit document. Coordinates and height are in feet (Revit internal units).",
+ "revit_create_floor": "Create a floor on a level from a closed boundary of points in the active Revit document. Coordinates are in feet.",
+ "revit_create_roof": "Create a roof on a level from a closed footprint of points, with an optional slope, in the active Revit document. Coordinates are in feet.",
+ "revit_list_levels": "List all levels in the active Revit project with their names and elevations.",
+ "revit_list_views": "List all views in the active Revit project with their names, ids and view types.",
+ "revit_list_elements": "List the elements of one Revit category (for example Walls, Floors, Roofs, Doors or Windows) in the active document.",
+ "revit_get_document_info": "Return metadata about the active Revit document, such as its title, path and workshare status.",
+ "revit_create_level": "Create a new level with the given name at the given elevation (feet) in the active Revit document.",
+ "revit_save_document": "Save the active Revit document, optionally to a path inside the allowed workspace directories.",
+ "revit_create_grid": "Create a straight grid line between two points in the active Revit document. Coordinates are in feet.",
+ "revit_create_room": "Create a room at an x/y point on a level, with a name and number, in the active Revit document. The point must lie inside an enclosed area.",
+ "revit_delete_element": "Delete one element by its Revit ElementId from the active document. Dependent elements (for example hosted doors) may be deleted with it.",
+ "revit_place_family_instance": "Place an instance of a loaded family type (for example furniture or equipment) at a point on a level. Coordinates are in feet.",
+ "revit_place_door": "Place a door of a given family and type in a host wall at a location. Coordinates are in feet.",
+ "revit_place_window": "Place a window of a given family and type in a host wall at a location. Coordinates are in feet.",
+ "revit_list_families": "List the families loaded in the active Revit document together with their types.",
+ "revit_create_floor_plan_view": "Create a floor plan view for the named level in the active Revit document.",
+ "revit_create_3d_view": "Create a new 3D view with the given name in the active Revit document.",
+ "revit_create_section_view": "Create a section view between two points with the given height in the active Revit document. Coordinates and height are in feet.",
+ "revit_get_element_parameters": "Return every instance parameter of one element (name, value, storage type and read-only flag).",
+ "revit_set_parameter_value": "Set one instance parameter on one element to a new value in the active Revit document.",
+ "revit_get_parameter_value": "Read the value of one named parameter on one element.",
+ "revit_list_shared_parameters": "List the shared parameters defined in the active Revit document.",
+ "revit_create_shared_parameter": "Create a new shared parameter with a name, parameter group and data type in the active Revit document.",
+ "revit_list_project_parameters": "List the project parameters defined in the active Revit document with the categories they are bound to.",
+ "revit_create_project_parameter": "Create a new project parameter and bind it to a category in the active Revit document.",
+ "revit_batch_set_parameters": "Set the same parameter to the same value on many elements, given by ElementId, in one Revit transaction.",
+ "revit_get_type_parameters": "Return the type parameters of the family type that an element belongs to.",
+ "revit_set_type_parameter": "Set one type parameter on the family type of an element. This changes every instance of that type.",
+ "revit_list_sheets": "List all sheets in the active Revit project with their numbers, names and ids.",
+ "revit_create_sheet": "Create a new sheet with a name, number and title block in the active Revit document.",
+ "revit_delete_sheet": "Delete a sheet by ElementId. Views placed on it are not deleted, only their viewports.",
+ "revit_place_viewport_on_sheet": "Place a view on a sheet at an x/y position (feet on the sheet).",
+ "revit_batch_create_sheets_from_csv": "Create many sheets from a CSV file inside the allowed workspace, using the named title block.",
+ "revit_populate_titleblock": "Write a set of parameter values into the title block of a sheet.",
+ "revit_list_titleblocks": "List the title block family types available in the active Revit document.",
+ "revit_get_sheet_info": "Return detailed information about one sheet, such as its number, name, title block and placed views.",
+ "revit_duplicate_sheet": "Duplicate a sheet, optionally with its views, using one of Revit's duplicate options.",
+ "revit_renumber_sheets": "Renumber all sheets in one batch using a prefix and a starting number.",
+ "revit_get_selection": "Return the ElementIds of the elements currently selected in the Revit UI.",
+ "revit_set_selection": "Replace the current Revit UI selection with the given ElementIds. Does not modify the model.",
+ "revit_select_by_unique_ids": "Select elements by UniqueId and zoom to them in the active view. Changes the Revit UI selection and view only, not the model.",
+ "revit_create_text_note": "Create a text note at an x/y position in a view of the active Revit document.",
+ "revit_create_tag": "Tag one element at an x/y position in a view.",
+ "revit_create_column": "Create a structural column of a given family type at an x/y point on a level. Coordinates are in feet.",
+ "revit_create_beam": "Create a structural beam of a given family type between two x/y points on a level. Coordinates are in feet.",
+ "revit_create_foundation": "Create a foundation element of a given family type at a point on a level. Coordinates are in feet.",
+ "revit_create_duct": "Create a duct between two points at an elevation on a level, with a mechanical system type and duct type. Coordinates are in feet.",
+ "revit_create_pipe": "Create a pipe between two points at an elevation on a level, with a piping system type and pipe type. Coordinates are in feet.",
+ "revit_get_categories": "List the Revit categories available in the active document.",
+ "revit_get_element_type": "Find element types by category name and family name in the active document.",
+ "revit_close_document": "Close the active Revit document, optionally saving changes first.",
+ "revit_create_new_document": "Create a new Revit project, optionally from a template file inside the allowed workspace.",
+ "revit_export_dwg": "Export a view to a DWG file at a path inside the allowed workspace. Writes a file; does not change the model.",
+ "revit_export_ifc": "Export the model to an IFC file at a path inside the allowed workspace. Writes a file; does not change the model.",
+ "revit_export_navisworks": "Export the model to a Navisworks NWC file at a path inside the allowed workspace. Writes a file; does not change the model.",
+ "revit_export_image": "Export a view to an image file of the given pixel size at a path inside the allowed workspace. Writes a file; does not change the model.",
+ "revit_render_3d": "Render a 3D view to an image file at a chosen quality level. Writes a file; does not change the model.",
+ "revit_move_element": "Move one element by an offset vector in feet.",
+ "revit_copy_element": "Copy one element and place the copy at an offset vector in feet from the original.",
+ "revit_rotate_element": "Rotate one element about a vertical axis through a centre point by an angle in radians.",
+ "revit_mirror_element": "Mirror one element about a plane given by an origin point and a normal vector.",
+ "revit_pin_element": "Pin an element so it cannot be moved by accident.",
+ "revit_unpin_element": "Unpin a previously pinned element so it can be moved again.",
+ "revit_sync_to_central": "Synchronise a workshared model with the central model with a comment, optionally relinquishing ownership. Ignored if the document is not workshared.",
+ "revit_relinquish_all": "Relinquish every element and workset the current user owns in a workshared model.",
+ "revit_get_worksets": "List the worksets of a workshared model with their owners and open state.",
+ "revit_create_schedule": "Create a schedule view for a category with the given name.",
+ "revit_get_schedule_data": "Return the rows and columns of an existing schedule.",
+ "revit_get_element_bounding_box": "Return the axis-aligned bounding box (min and max corner, feet) of an element.",
+ "revit_get_phases": "List the project phases of the active Revit document.",
+ "revit_get_phase_filters": "List the phase filters of the active Revit document.",
+ "revit_get_design_options": "List the design option sets and options of the active Revit document.",
+ "revit_create_group": "Create a model group from a list of ElementIds, with a name.",
+ "revit_ungroup": "Dissolve a model group into its member elements.",
+ "revit_get_group_members": "List the member elements of a model group.",
+ "revit_get_rvt_links": "List the linked Revit models (link types) in the active document.",
+ "revit_get_link_instances": "List the placed instances of linked Revit models in the active document.",
+ "revit_create_conduit": "Create an electrical conduit between two points at a given diameter on a level. Coordinates and diameter are in feet.",
+ "revit_check_clashes": "Check for geometric clashes between elements of two categories, within a tolerance (feet). Read-only.",
+ "revit_create_material": "Create a new material with a colour, transparency, shininess and smoothness.",
+ "revit_set_element_material": "Assign a material, by name, to an element or to one of its faces.",
+ "revit_convert_to_group": "Convert a set of elements into a named model group.",
+ "revit_edit_family": "Open a family for editing in the Revit family editor.",
+ "revit_create_dimension": "Create a linear dimension between two points or two elements in the active view.",
+ "revit_get_revision_sequences": "List the revision sequences defined in the active Revit document.",
+ "revit_tag_all_in_view": "Tag every element of a category in the active view.",
+ "revit_get_view_templates": "List the view templates available in the active Revit document.",
+ "revit_apply_view_template": "Apply a view template to a view.",
+ "revit_calculate_material_quantities": "Calculate material volumes and areas for all elements of a category. Read-only.",
+ "revit_get_warnings": "Return the current warnings of the active Revit project (for example overlapping or duplicate elements).",
+ "revit_invoke_method": (
+ "Advanced escape hatch: call any public Revit API method by class and method name through reflection, "
+ "optionally inside a transaction. Can change anything the Revit API can change; prefer a dedicated tool."
+ ),
+ "revit_reflect_get": "Advanced: read any public Revit API property of an object identified by target_id, through reflection. Read-only.",
+ "revit_reflect_set": "Advanced escape hatch: set any writable Revit API property of an object identified by target_id, through reflection. Prefer a dedicated tool.",
+ # --- Approval tools ----------------------------------------------------
+ "plan_actions": (
+ "Create a draft ActionPlan describing the model changes you want to make, capturing the before-state of each. "
+ "Nothing is changed in the model; the plan must be approved before any write tool will run."
+ ),
+ "list_pending_plans": "List all ActionPlans that are waiting for review. Read-only.",
+ "approve_plan": "Approve a pending ActionPlan so that its actions may be executed. This is the human approval step.",
+ "reject_plan": "Reject and archive a pending ActionPlan so that it can never be executed.",
+ "rollback_plan": "Undo an already executed ActionPlan by applying the inverse of each recorded change, in reverse order. Actions without a rollback handler are reported as warnings.",
+ # --- Modules (panel commands) -----------------------------------------
+ "module_list_commands": "List all registered modules and the commands they expose to the dockable Revit panel. Read-only.",
+ "familytype_mapper_audit_families": "Audit the families in a saved snapshot and report problems such as unmapped or inconsistent family types. Read-only.",
+ "familytype_mapper_list_type_mappings": "List family-type mappings found in a saved snapshot, optionally for one category. Read-only.",
+ "hello_world_say_hello": "Example module command that returns a greeting; use it to confirm the module system works.",
+ "model_inspector_summarize_model": "Summarise a saved snapshot, for example element counts by category. Read-only.",
+ "model_inspector_ask": "Answer a question about a saved snapshot by filtering its element records with the filter DSL. Read-only.",
+ "model_inspector_list_groups": "List the model groups found in a saved snapshot. Read-only.",
+ "model_inspector_inspect_selection": "Return the snapshot records of the given elements (by UniqueId). Read-only.",
+ "model_inspector_save_query": "Save a named filter query so it can be re-run later with model_inspector_run_saved_query.",
+ "model_inspector_run_saved_query": "Run a previously saved named query against a saved snapshot. Read-only.",
+ "model_inspector_list_saved_queries": "List the saved named queries. Read-only.",
+ "parameter_manager_filter_params": "Return a parameter grid for the elements of a snapshot that match a filter, optionally including read-only parameters. Read-only.",
+ "parameter_manager_diff_params": "Compare parameter values between two saved snapshots and list the differences. Read-only.",
+ "parameter_manager_plan_set_params": "Create a draft ActionPlan that sets parameter values on the elements of a snapshot matching a filter. Review and approve the plan before it runs.",
+ "parameter_manager_export_params_csv": "Export parameters of the matching snapshot elements to a CSV file in the workspace. Writes a file; does not change the model.",
+ "parameter_manager_import_params_csv": "Import parameter values from a CSV file in the workspace and apply them to elements. Write operation.",
+ "qaqc_checker_run_check": "Run a QA/QC rule pack against a saved snapshot and record the issues it finds.",
+ "qaqc_checker_list_issues": "List recorded QA/QC issues for a document, optionally filtered by status and severity. Read-only.",
+ "qaqc_checker_resolve_issue": "Mark one recorded QA/QC issue as resolved.",
+ "qaqc_checker_list_rules": "List the QA/QC rules that are available, optionally for one rule pack. Read-only.",
+ "recipe_runner_run_recipe": "Run a named automation recipe (a YAML-defined sequence of tool calls) with arguments; set dry_run to list the steps without executing them.",
+ "recipe_runner_list_recipes": "List the available automation recipes. Read-only.",
+ "recipe_runner_list_runs": "List past recipe runs, optionally for one recipe. Read-only.",
+ "recipe_runner_get_run_status": "Return the status and results of one recipe run. Read-only.",
+ "report_generator_export_excel": "Export a snapshot (optionally filtered, with chosen parameters and QA/QC findings) to an Excel workbook in the workspace. Writes a file; does not change the model.",
+ "report_generator_export_sqlite_summary": "Export a summary of a snapshot to a SQLite database file in the workspace. Writes a file; does not change the model.",
+ "selection_tools_set_selection": "Select the given elements (by UniqueId) in the Revit UI. Does not modify the model.",
+ "selection_tools_save_selection": "Save a set of element UniqueIds under a name for later restore.",
+ "selection_tools_restore_selection": "Re-select a previously saved named selection in the Revit UI.",
+ "selection_tools_select_by_query": "Select in Revit the elements of a snapshot that match a filter query.",
+ "selection_tools_list_saved_selections": "List the saved named selections. Read-only.",
+ "selection_tools_group_rename": "Rename a model group identified by its UniqueId.",
+ "selection_tools_group_ungroup": "Ungroup a model group identified by its UniqueId. Its members stay in the model as separate elements.",
+ "selection_tools_group_convert_to_detail": "Convert a model group into a detail group.",
+ # --- Navisworks --------------------------------------------------------
+ "navisworks_health": "Check that the Navisworks bridge is reachable and return its status.",
+ "navisworks_get_document_info": "Return metadata about the active Navisworks document. Read-only.",
+ "navisworks_get_model_tree": "Return the model hierarchy tree of the active Navisworks document down to a maximum depth. Read-only.",
+ "navisworks_get_selection": "Return the items currently selected in Navisworks. Read-only.",
+ "navisworks_append_file": "Append a model file (for example NWD, NWC or IFC) from the allowed workspace to the active Navisworks document.",
+ "navisworks_refresh": "Refresh all appended files that changed on disk in the active Navisworks document.",
+ "navisworks_list_viewpoints": "List the saved viewpoints of the active Navisworks document. Read-only.",
+ "navisworks_create_viewpoint": "Create a saved viewpoint with the given name from the current view.",
+ "navisworks_activate_viewpoint": "Switch the Navisworks view to a saved viewpoint identified by its Guid.",
+ "navisworks_list_clash_tests": "List the clash tests defined in Clash Detective. Read-only.",
+ "navisworks_run_clash_test": "Run one Clash Detective test, identified by Guid, and update its results.",
+ "navisworks_get_clash_results": "Return the results of one clash test, with paging by skip and limit. Read-only.",
+ "navisworks_invoke_method": "Advanced escape hatch: call a public C# method in Navisworks through reflection. Prefer a dedicated tool.",
+ "navisworks_reflect_get": "Advanced: read a C# property of a Navisworks object through reflection. Read-only.",
+ "navisworks_reflect_set": "Advanced escape hatch: set a C# property of a Navisworks object through reflection.",
+ # --- Rhino -------------------------------------------------------------
+ "rhino_health": "Check that the Rhino bridge is reachable and healthy.",
+ "rhino_get_document_info": "Return the active Rhino document name, path, unit system and object count. Read-only.",
+ "rhino_get_lines": "Return all curves and lines in the active Rhino document. Read-only.",
+ "rhino_get_scene": "Return every object in the Rhino scene with its type, layer and bounding box. Read-only.",
+ "rhino_list_layers": "List all layers of the Rhino document with name, colour, visibility and lock state. Read-only.",
+ "rhino_clear_scene": "Delete all objects in the Rhino document, or only the objects on one layer.",
+ "rhino_reflect_get": "Advanced: read a C# property of a Rhino object through reflection. Read-only.",
+ "rhino_invoke_method": "Advanced escape hatch: call a public C# method on a Rhino object through reflection. Prefer a dedicated tool.",
+ "rhino_reflect_set": "Advanced escape hatch: set a C# property of a Rhino object through reflection.",
+ # --- Graph / Speckle / jobs / snapshots --------------------------------
+ "snapshot_take": "Extract and save a complete semantic BIM snapshot of the active Revit model into the workspace and return its snapshot_id.",
+ "snapshot_query": "Query the element records of a saved snapshot with the filter DSL. Read-only.",
+ "snapshot_diff": "Compare two saved snapshots and report added, deleted and modified elements. Read-only.",
+ "speckle_health": "Check that the Speckle provider is configured and report whether it can reach the Speckle server.",
+ "speckle_auth_status": "Report the current Speckle OAuth authentication status of this server (signed in or not).",
+ "speckle_oauth_refresh": "Refresh the Speckle OAuth access token so later Speckle calls keep working.",
+ "speckle_list_projects": "List the Speckle projects the signed-in user can access, up to a limit.",
+ "speckle_get_version_metadata": "Read the metadata of one Speckle version by project and version ID. Read-only.",
+ "speckle_checkout_version": "Retrieve the metadata of one Speckle version by ID. Does not change data on the Speckle server.",
+ "job_status":"Return the status, progress, result or error of a background job started with run_async. Read-only.",
+ "job_cancel": "Cancel a running or queued background job.",
+}
+
+# --------------------------------------------------------------------------- #
+# Parameter descriptions, used only where a schema property has none.
+# Lookup order: (tool, param) -> (provider, param) -> param
+# --------------------------------------------------------------------------- #
+PARAM_DESCRIPTIONS: dict[str, str] = {
+ "element_id": "Revit ElementId (integer) of the target element.",
+ "element_ids": "List of Revit ElementIds (integers).",
+ "element_uids": "List of Revit UniqueIds (strings) of the target elements.",
+ "name": "Name to give to the new item.",
+ "snapshot_id": "ID of a saved semantic snapshot (returned by snapshot_take or revit_extract_snapshot).",
+ "snapshot_a_id": "ID of the first (baseline) saved snapshot.",
+ "snapshot_b_id": "ID of the second (comparison) saved snapshot.",
+ "x": "X coordinate in feet (Revit internal units).",
+ "y": "Y coordinate in feet (Revit internal units).",
+ "z": "Z coordinate or elevation in feet (Revit internal units).",
+ "start_x": "Start point X in feet.",
+ "start_y": "Start point Y in feet.",
+ "start_z": "Start point Z in feet.",
+ "end_x": "End point X in feet.",
+ "end_y": "End point Y in feet.",
+ "end_z": "End point Z in feet.",
+ "center_x": "X of the rotation centre in feet.",
+ "center_y": "Y of the rotation centre in feet.",
+ "center_z": "Z of the rotation centre in feet.",
+ "plane_origin_x": "X of a point on the mirror plane, in feet.",
+ "plane_origin_y": "Y of a point on the mirror plane, in feet.",
+ "plane_origin_z": "Z of a point on the mirror plane, in feet.",
+ "plane_normal_x": "X component of the mirror plane normal vector.",
+ "plane_normal_y": "Y component of the mirror plane normal vector.",
+ "plane_normal_z": "Z component of the mirror plane normal vector.",
+ "angle_radians": "Rotation angle in radians (counter-clockwise positive).",
+ "level": "Name of the Revit level, for example 'Level 1'.",
+ "level_name": "Name of the Revit level, for example 'Level 1'.",
+ "family_name": "Name of the loaded Revit family.",
+ "type_name": "Name of the family type within the family.",
+ "family_symbol_id": "ElementId (integer) of the family symbol (type).",
+ "family_instance_id": "ElementId (integer) of the family instance.",
+ "category": "Revit category name, for example 'Walls', 'Doors' or 'Windows'.",
+ "category_name": "Revit category name, for example 'Walls', 'Doors' or 'Windows'.",
+ "category1": "First Revit category name, for example 'Ducts'.",
+ "category2": "Second Revit category name, for example 'Structural Framing'.",
+ "view_id": "Revit ElementId (integer) of the view.",
+ "view_name": "Name for the new view.",
+ "sheet_id": "Revit ElementId (integer) of the sheet.",
+ "schedule_id": "Revit ElementId (integer) of the schedule.",
+ "titleblock_id": "ElementId (integer) of the title block family type.",
+ "titleblock_name": "Name of the title block family type.",
+ "template_id": "ElementId (integer) of the view template.",
+ "template_path": "Path of a Revit template file inside the allowed workspace.",
+ "wall_id": "ElementId (integer) of the host wall.",
+ "group_id": "ElementId (integer) of the model group.",
+ "group": "Parameter group the parameter is shown under.",
+ "type": "Data type of the parameter.",
+ "visible": "Whether the parameter is visible in the properties palette.",
+ "output_path": "Destination file path; must be inside the allowed workspace directories.",
+ "output_filename": "File name for the output, written into the workspace.",
+ "csv_path": "Path of a CSV file inside the allowed workspace.",
+ "csv_filename": "Name of a CSV file in the workspace.",
+ "path": "File path; must be inside the allowed workspace directories.",
+ "limit": "Maximum number of items to return.",
+ "skip": "Number of items to skip (for paging).",
+ "offset": "Number of items to skip (for paging).",
+ "idempotency_key": "Optional unique key; repeating a call with the same key does not repeat the write.",
+ "plan_id": "ID of an ActionPlan (from plan_actions).",
+ "actions": "List of proposed tool calls, each with a tool name and its arguments.",
+ "parameter_name": "Name of the Revit parameter.",
+ "param_name": "Name of the parameter.",
+ "param_names": "List of parameter names.",
+ "value": "New value to write; a string, number or boolean that matches the parameter's type.",
+ "location": "Location object with x, y and optional z in feet.",
+ "height": "Height in feet.",
+ "width": "Width in pixels.",
+ "quality": "Render quality level.",
+ "tolerance": "Distance tolerance in feet.",
+ "radius": "Radius in the document's units.",
+ "diameter": "Diameter in feet.",
+ "system_type": "Name of the system type (for example a piping or duct system).",
+ "duct_type": "Name of the duct type.",
+ "pipe_type": "Name of the pipe type.",
+ "text": "Text content.",
+ "comment": "Comment recorded with the operation.",
+ "relinquish": "Whether to relinquish ownership of elements and worksets after syncing.",
+ "save_changes": "Whether to save changes before closing.",
+ "with_views": "Whether to also duplicate the views placed on the sheet.",
+ "duplicate_option": "How to duplicate the sheet's content (Revit duplicate option name).",
+ "prefix": "Prefix for the new sheet numbers.",
+ "start_number": "First number to use.",
+ "parameters": "Map of parameter name to value.",
+ "color": "Colour as an object with r, g and b values (0-255) or, for Rhino, an [r, g, b] array.",
+ "transparency": "Transparency of the material.",
+ "shininess": "Shininess of the material (0-100).",
+ "smoothness": "Smoothness of the material (0-100).",
+ "reflectivity": "Reflectivity of the material (0-1).",
+ "material_name": "Name of an existing material.",
+ "start_point": "Start point as an object with x, y and z in feet.",
+ "end_point": "End point as an object with x, y and z in feet.",
+ "element1_id": "ElementId (integer) of the first element.",
+ "element2_id": "ElementId (integer) of the second element.",
+ "use_transaction": "Wrap the call in a Revit transaction.",
+ "max_depth": "Maximum tree depth to return.",
+ "filter": "Filter DSL object selecting records, for example by category, level or parameter value.",
+ "element_filter": "Filter DSL object selecting elements, for example by category, level or parameter value.",
+ "include_readonly": "Whether to include read-only parameters.",
+ "doc_guid": "GUID of the document the issues belong to.",
+ "severity": "Severity filter, for example 'error' or 'warning'.",
+ "issue_id": "ID of the QA/QC issue.",
+ "rule_pack": "Name of the QA/QC rule pack.",
+ "class_name": "Fully qualified class name that holds the method to call.",
+ "method_name": "Name of the method to call.",
+ "arguments": "Positional arguments for the method, as a JSON array.",
+ "target_id": "Identifier of the target object (for example a Revit ElementId).",
+ "property_name": "Name of the property.",
+ "guid": "Guid of the item, as returned by the corresponding list command.",
+ "node_ids": "List of graph node IDs.",
+ "message": "Message recorded with the operation.",
+ "number": "Number (identifier string) to assign.",
+ "project_id": "ID of the Speckle project.",
+ "model_id": "ID of the Speckle model.",
+ "version_id": "ID of the Speckle version.",
+ "branch_id": "ID of the Speckle branch.",
+ "object_id": "ID of the Speckle object to publish.",
+ "source_model_id": "ID of the Speckle model or branch to merge from.",
+ "target_model_id": "ID of the Speckle model or branch to merge into.",
+ "source_application": "Name of the application the data comes from.",
+ "description": "Free-text description.",
+ "layer": "Name of the Rhino layer.",
+ "ids": "List of Rhino object GUIDs.",
+ "base_id": "GUID of the base Rhino object.",
+ "cutter_ids": "List of GUIDs of Rhino objects to subtract.",
+ "rotation": "Rotation object (angle and axis).",
+ "node_id": "ID of the graph node.",
+ "related_node_id": "ID of the related graph node.",
+ "relation": "Relation type, for example SUPPORTED_BY.",
+ "direction": "Relation direction to follow: incoming or outgoing.",
+ "relation_types": "List of relation types to consider.",
+ "node_types": "List of node types to consider.",
+ "min_degree": "Minimum number of connections a node must have.",
+ "attributes": "Free-form attributes stored on the relation.",
+ "code": "Authorization code returned by the OAuth flow.",
+ "state": "State value returned by the OAuth flow.",
+ "source_id": "Identifier to translate.",
+ "model_name": "Name of the Speckle model.",
+ "data": "JSON object to send.",
+}
+
+# Per-tool overrides where the generic text would be wrong or vague.
+TOOL_PARAM_DESCRIPTIONS: dict[tuple[str, str], str] = {
+ ("revit_move_element", "x"): "X component of the offset vector in feet.",
+ ("revit_move_element", "y"): "Y component of the offset vector in feet.",
+ ("revit_move_element", "z"): "Z component of the offset vector in feet.",
+ ("revit_copy_element", "x"): "X component of the offset vector in feet.",
+ ("revit_copy_element", "y"): "Y component of the offset vector in feet.",
+ ("revit_copy_element", "z"): "Z component of the offset vector in feet.",
+ ("revit_place_viewport_on_sheet", "x"): "X position on the sheet in feet.",
+ ("revit_place_viewport_on_sheet", "y"): "Y position on the sheet in feet.",
+ ("revit_create_text_note", "x"): "X position in the view in feet.",
+ ("revit_create_text_note", "y"): "Y position in the view in feet.",
+ ("revit_create_tag", "x"): "X position in the view in feet.",
+ ("revit_create_tag", "y"): "Y position in the view in feet.",
+ ("revit_create_level", "name"): "Name of the new level.",
+ ("revit_create_grid", "name"): "Name (label) of the new grid line.",
+ ("revit_create_room", "name"): "Name of the new room.",
+ ("revit_create_room", "number"): "Room number.",
+ ("revit_create_sheet", "name"): "Name of the new sheet.",
+ ("revit_create_sheet", "number"): "Sheet number, for example 'A101'.",
+ ("revit_create_schedule", "name"): "Name of the new schedule.",
+ ("revit_create_material", "name"): "Name of the new material.",
+ ("revit_create_group", "name"): "Name of the new group.",
+ ("revit_convert_to_group", "name"): "Name of the new group.",
+ ("revit_create_shared_parameter", "name"): "Name of the new shared parameter.",
+ ("revit_create_project_parameter", "name"): "Name of the new project parameter.",
+ ("revit_create_project_parameter", "category"): "Revit category the parameter is bound to.",
+ ("revit_create_shared_parameter", "type"): "Parameter data type, for example 'Text', 'Number' or 'Length'.",
+ ("revit_create_project_parameter", "type"): "Parameter data type, for example 'Text', 'Number' or 'Length'.",
+ ("revit_render_3d", "view_id"): "ElementId (integer) of the 3D view to render.",
+ ("revit_create_floor_plan_view", "view_name"): "Name for the new floor plan view.",
+ ("revit_check_clashes", "tolerance"): "Clash tolerance in feet (the add-in defaults to 0.01 ft).",
+ ("revit_set_type_parameter", "element_id"): "ElementId (integer) of any element of the type to change.",
+ ("revit_get_type_parameters", "element_id"): "ElementId (integer) of any element of the type to read.",
+ ("revit_set_element_material", "face_index"): "Optional index of a single face; omit to apply to the whole element.",
+ ("revit_save_document", "path"): "Optional path to save to; must be inside the allowed workspace directories. Omit to save in place.",
+ ("navisworks_create_viewpoint", "name"): "Name of the new saved viewpoint.",
+ ("navisworks_append_file", "path"): "Path of the file to append; must be inside the allowed workspace directories.",
+ ("navisworks_get_clash_results", "limit"): "Maximum number of clash results to return.",
+ ("hello_world_say_hello", "name"): "Name to greet.",
+ ("graph_add_relation", "source_id"): "ID of the source graph node.",
+ ("graph_add_relation", "target_id"): "ID of the target graph node.",
+ ("graph_add_relation", "relation"): "Relation type, for example SUPPORTED_BY.",
+ ("speckle_create_model", "name"): "Name of the new Speckle model.",
+ ("speckle_create_branch", "name"): "Name of the new Speckle branch.",
+ ("speckle_create_model", "description"): "Optional description of the new model.",
+ ("speckle_create_branch", "description"): "Optional description of the new branch.",
+ ("rhino_set_view", "view"): "Display mode or projection to switch to.",
+ ("rhino_create_box", "min_pt"): "Minimum corner as [x, y, z] in metres.",
+ ("rhino_create_box", "max_pt"): "Maximum corner as [x, y, z] in metres.",
+ ("rhino_create_sphere", "center"): "Centre as [x, y, z] in metres.",
+ ("rhino_create_sphere", "radius"): "Radius in metres.",
+ ("rhino_create_cylinder", "base"): "Base centre as [x, y, z] in metres.",
+ ("rhino_create_cylinder", "height"): "Height in metres.",
+ ("rhino_create_cylinder", "radius"): "Radius in metres.",
+ ("rhino_boolean_union", "layer"): "Layer to place the resulting object on.",
+ ("rhino_set_material", "layer"): "Apply the material to every object on this layer.",
+ ("rhino_set_material", "ids"): "GUIDs of the objects to apply the material to.",
+ ("rhino_set_material", "name"): "Name of the material.",
+ ("rhino_set_material", "color"): "Material colour as an [r, g, b] array (0-255).",
+ ("rhino_set_material", "transparency"): "Transparency of the material (0-1).",
+ ("rhino_transform_objects", "ids"): "GUIDs of the objects to transform.",
+ ("rhino_transform_objects", "translation"): "Translation vector [x, y, z] in metres.",
+ ("rhino_transform_objects", "scale"): "Scale factors [x, y, z].",
+ ("rhino_run_python", "code"): "IronPython source to run inside Rhino; stdout is captured and returned.",
+ ("revit_execute_python", "script"): "Python/IronPython source to run inside Revit with access to the Revit API.",
+ ("revit_invoke_method", "target_id"): "Identifier of the object to call the method on; omit for a static method.",
+ ("revit_reflect_set", "value"): "New value for the property.",
+ ("navisworks_reflect_set", "value"): "New value for the property.",
+ ("rhino_reflect_set", "value"): "New value for the property.",
+ ("ifc_get_properties", "element_id"): "GlobalId or step id of the IFC element.",
+ ("ifc_get_bounding_box", "element_id"): "GlobalId or step id of the IFC element.",
+ ("ifc_query_elements", "property_value"): "Value the property must have.",
+ ("ifc_query_elements", "guid"): "IFC GlobalId to look for.",
+ ("ifc_query_elements", "name_filter"): "Substring that the element name must contain.",
+ ("ifc_query_elements", "ifc_class"): "IFC class to filter by, for example IfcWall.",
+ ("exporter_to_sqlite", "db_path"): "SQLite database file path; must be inside the allowed workspace directories.",
+ ("exporter_graph_to_sqlite", "db_path"): "SQLite database file path; must be inside the allowed workspace directories.",
+}
+
+# --------------------------------------------------------------------------- #
+# Behaviour annotations
+# --------------------------------------------------------------------------- #
+# Tools that the gate does NOT treat as mutating (is_mutating=False) but that are
+# not read-only either (they write files, plan state, UI state or in-memory
+# state). value = (destructiveHint, idempotentHint).
+NOT_READ_ONLY: dict[str, tuple[bool, bool]] = {
+ "plan_actions": (False, False),
+ "approve_plan": (False, True),
+ "reject_plan": (False, True),
+ "rollback_plan": (True, False),
+ "execute_plan": (True, False),
+ "revit_extract_snapshot": (False, False),
+ "snapshot_take": (False, False),
+ "revit_export_dwg": (False, True),
+ "revit_export_ifc": (False, True),
+ "revit_export_navisworks": (False, True),
+ "revit_export_image": (False, True),
+ "revit_render_3d": (False, True),
+ "revit_select_by_unique_ids": (False, True),
+ "navisworks_append_file": (False, False),
+ "navisworks_refresh": (False, True),
+ "navisworks_activate_viewpoint": (False, True),
+ "exporter_to_sqlite": (False, False),
+ "exporter_graph_to_sqlite": (False, False),
+ "parameter_manager_export_params_csv": (False, True),
+ "report_generator_export_excel": (False, True),
+ "report_generator_export_sqlite_summary": (False, True),
+ "model_inspector_save_query": (False, True),
+ "selection_tools_save_selection": (False, True),
+ "qaqc_checker_run_check": (False, False),
+ "qaqc_checker_resolve_issue": (False, True),
+ "recipe_runner_run_recipe": (True, False),
+ "aec_register_mapping": (False, True),
+ "graph_compile": (False, False),
+ "graph_add_relation": (False, True),
+ "speckle_oauth_start": (False, False),
+ "speckle_oauth_exchange_code": (False, False),
+ "speckle_oauth_refresh": (False, True),
+ "speckle_checkout_version": (False, True),
+ "job_cancel": (True, True),
+ "rhino_generate_diagrid_tower": (False, False),
+}
+
+# Mutating tools that only add things (or only change UI/plan state): they cannot
+# destroy existing model content, so destructiveHint is false. Every other
+# mutating tool defaults to destructive=true, which is the safe MCP default.
+ADDITIVE_NAME_PARTS = frozenset({"create", "place", "copy", "duplicate", "tag", "pin", "unpin"})
+ADDITIVE_NAMES = frozenset(
+ {
+ "revit_save_document",
+ "revit_set_selection",
+ "selection_tools_set_selection",
+ "selection_tools_restore_selection",
+ "selection_tools_select_by_query",
+ "parameter_manager_plan_set_params",
+ "navisworks_run_clash_test",
+ "speckle_publish_version",
+ "speckle_send_object",
+ }
+)
+# Verbs that make a repeated identical call a no-op.
+IDEMPOTENT_NAME_PARTS = frozenset({"set", "pin", "unpin", "delete", "save", "apply", "restore", "select"})
+# Providers whose tools talk to remote services (open world).
+OPEN_WORLD_PROVIDERS = frozenset({"speckle", "aps", "autodesk_data", "cloud"})
+
+_ACRONYMS = {
+ "ifc": "IFC", "dwg": "DWG", "nwc": "NWC", "rvt": "RVT", "csv": "CSV", "sqlite": "SQLite",
+ "aps": "APS", "3d": "3D", "qaqc": "QA/QC", "id": "ID", "ids": "IDs", "uids": "UIDs", "aec": "AEC",
+}
+
+
+def humanize(name: str) -> str:
+ return " ".join(_ACRONYMS.get(p, p.capitalize()) for p in name.split("_"))
+
+
+def annotations_for(provider_id: str, tool: ProviderTool) -> ToolAnnotations:
+ """Derive MCP behaviour hints from the tool's existing gate flags."""
+ parts = set(tool.name.split("_"))
+ open_world = provider_id in OPEN_WORLD_PROVIDERS or provider_id.startswith("proxy")
+
+ if tool.name in NOT_READ_ONLY:
+ read_only, (destructive, idempotent) = False, NOT_READ_ONLY[tool.name]
+ elif tool.is_mutating:
+ read_only = False
+ if tool.destructive:
+ destructive = True
+ else:
+ destructive = not (
+ tool.name in ADDITIVE_NAMES or bool(parts & ADDITIVE_NAME_PARTS)
+ )
+ idempotent = bool(parts & IDEMPOTENT_NAME_PARTS) and not (parts & {"create"})
+ else:
+ read_only, destructive, idempotent = True, False, True
+
+ if tool.destructive:
+ destructive = True
+ return ToolAnnotations(
+ title=humanize(tool.name),
+ readOnlyHint=read_only,
+ destructiveHint=destructive,
+ idempotentHint=idempotent,
+ openWorldHint=open_world,
+ )
+
+
+def enrich_tool(provider_id: str, tool: ProviderTool) -> Tool:
+ """Return the MCP `Tool` for a provider tool, with fuller metadata.
+
+ The provider's own description is kept when it is already substantial; the
+ approval requirement is appended to every mutating tool.
+ """
+ description = DESCRIPTIONS.get(tool.name, tool.description)
+ if tool.is_mutating and "plan_id" not in description:
+ description += APPROVAL_SUFFIX
+
+ schema = copy.deepcopy(tool.input_schema) if tool.input_schema else {"type": "object"}
+ schema.setdefault("type", "object")
+ props: dict[str, Any] = schema.setdefault("properties", {})
+ if tool.is_mutating and "plan_id" not in props:
+ props["plan_id"] = {"type": "string", "description": PLAN_ID_DESCRIPTION}
+ for key, prop in props.items():
+ if not isinstance(prop, dict) or prop.get("description"):
+ continue
+ text = (
+ TOOL_PARAM_DESCRIPTIONS.get((tool.name, key))
+ or PARAM_DESCRIPTIONS.get(key)
+ )
+ if text:
+ prop["description"] = text
+ return Tool(
+ name=tool.name,
+ title=humanize(tool.name),
+ description=description,
+ inputSchema=schema,
+ annotations=annotations_for(provider_id, tool),
+ )
diff --git a/packages/mcp-server-revit/tests/test_tool_metadata.py b/packages/mcp-server-revit/tests/test_tool_metadata.py
new file mode 100644
index 0000000..8aa5dc4
--- /dev/null
+++ b/packages/mcp-server-revit/tests/test_tool_metadata.py
@@ -0,0 +1,122 @@
+"""The MCP tool listing must carry clear descriptions, documented parameters and annotations."""
+from __future__ import annotations
+
+import asyncio
+from pathlib import Path
+
+import pytest
+
+from revit_mcp_server import mcp_server
+from revit_mcp_server.registry_factory import build_registry
+from revit_mcp_server.security.workspace import WorkspaceMonitor
+
+
[email protected](scope="module")
+def listed(tmp_path_factory):
+ workspace_dir = Path(tmp_path_factory.mktemp("meta-ws"))
+ registry, approval, job_manager, _modules, _ws = build_registry(WorkspaceMonitor([workspace_dir]))
+ previous = (mcp_server.registry, mcp_server.approval_provider, mcp_server.job_manager)
+ mcp_server.registry, mcp_server.approval_provider, mcp_server.job_manager = registry, approval, job_manager
+ try:
+ tools = asyncio.run(mcp_server.list_tools())
+ finally:
+ mcp_server.registry, mcp_server.approval_provider, mcp_server.job_manager = previous
+ gate_flags = {t.name: t for t in registry.get_all_tools()}
+ return {t.name: t for t in tools}, gate_flags
+
+
+def test_every_tool_has_all_four_annotations(listed):
+ tools, _ = listed
+ assert len(tools) > 150
+ for tool in tools.values():
+ ann = tool.annotations
+ assert ann is not None, tool.name
+ for hint in ("readOnlyHint", "destructiveHint", "idempotentHint", "openWorldHint"):
+ assert getattr(ann, hint) is not None, f"{tool.name}: {hint} missing"
+ assert ann.title, tool.name
+
+
+def test_every_tool_has_a_substantial_description(listed):
+ tools, _ = listed
+ short = [t.name for t in tools.values() if len(t.description or "") < 40]
+ assert short == []
+
+
+def test_every_parameter_is_described(listed):
+ tools, _ = listed
+ missing = [
+ f"{t.name}.{key}"
+ for t in tools.values()
+ for key, prop in t.inputSchema.get("properties", {}).items()
+ if not (isinstance(prop, dict) and prop.get("description"))
+ ]
+ assert missing == []
+
+
+def test_gated_tools_are_never_marked_read_only(listed):
+ tools, gate = listed
+ for name, tool in tools.items():
+ if gate[name].is_mutating:
+ assert tool.annotations.readOnlyHint is False, name
+ assert "plan_id" in tool.inputSchema["properties"], name
+
+
+def test_escape_hatches_are_destructive(listed):
+ tools, gate = listed
+ for name, tool in gate.items():
+ if tool.destructive:
+ assert tools[name].annotations.destructiveHint is True, name
+ assert tools["revit_execute_python"].annotations.destructiveHint is True
+ assert tools["rhino_run_python"].annotations.destructiveHint is True
+ assert tools["revit_delete_element"].annotations.destructiveHint is True
+
+
+def test_file_writing_and_plan_execution_tools_are_not_read_only(listed):
+ tools, _ = listed
+ for name in ("revit_export_ifc", "revit_export_dwg", "execute_plan", "rollback_plan", "plan_actions"):
+ assert tools[name].annotations.readOnlyHint is False, name
+ assert tools["execute_plan"].annotations.destructiveHint is True
+
+
+def test_pure_readers_are_read_only_and_local_tools_are_closed_world(listed):
+ tools, _ = listed
+ for name in ("revit_list_levels", "revit_get_element_parameters", "ifc_get_metadata", "list_pending_plans"):
+ ann = tools[name].annotations
+ assert ann.readOnlyHint is True and ann.destructiveHint is False, name
+ assert ann.openWorldHint is False, name
+ assert tools["speckle_list_projects"].annotations.openWorldHint is True
+
+
+def test_module_data_files_are_declared_as_package_data():
+ """The wheel must ship module manifests, rules and recipes (non-Python files)."""
+ import fnmatch
+ import tomllib
+
+ package_root = Path(__file__).resolve().parent.parent
+ patterns = tomllib.loads((package_root / "pyproject.toml").read_text(encoding="utf-8"))["tool"][
+ "setuptools"
+ ]["package-data"]["revit_mcp_server"]
+ base = package_root / "src" / "revit_mcp_server"
+ data_files = [
+ p.relative_to(base).as_posix()
+ for p in base.rglob("*")
+ if p.is_file() and p.suffix in (".json", ".yaml") and "modules" in p.parts
+ ]
+ assert data_files
+ uncovered = [f for f in data_files if not any(fnmatch.fnmatch(f, pat) for pat in patterns)]
+ assert uncovered == []
+
+
+def test_mcp_dependency_is_capped_below_2():
+ import tomllib
+
+ package_root = Path(__file__).resolve().parent.parent
+ deps = tomllib.loads((package_root / "pyproject.toml").read_text(encoding="utf-8"))["project"]["dependencies"]
+ assert any(d.replace(" ", "").startswith("mcp>=") and "<2" in d.replace(" ", "") for d in deps)
+
+
+def test_provider_schema_is_not_mutated(listed):
+ """Listing must not leak the added plan_id property back into the provider tool."""
+ tools, gate = listed
+ assert "plan_id" in tools["revit_create_wall"].inputSchema["properties"]
+ assert "plan_id" not in gate["revit_create_wall"].input_schema.get("properties", {})
diff --git a/packages/mcp-server-revit/uv.lock b/packages/mcp-server-revit/uv.lock
index 706b3e7..f1df947 100644
--- a/packages/mcp-server-revit/uv.lock
+++ b/packages/mcp-server-revit/uv.lock
@@ -3,14 +3,16 @@ revision = 3
requires-python = ">=3.11"
resolution-markers = [
"python_full_version >= '3.15'",
- "python_full_version < '3.15'",
+ "python_full_version >= '3.12' and python_full_version < '3.15' and sys_platform == 'emscripten'",
+ "(python_full_version < '3.15' and sys_platform != 'emscripten') or (python_full_version < '3.12' and sys_platform == 'emscripten')",
]
[[package]]
name = "aec-model-bridge"
-version = "1.2.0"
+version = "1.3.1"
source = { editable = "." }
dependencies = [
+ { name = "anthropic" },
{ name = "httpx" },
{ name = "ifcopenshell" },
{ name = "mcp" },
@@ -32,9 +34,10 @@ dev = [
[package.metadata]
requires-dist = [
+ { name = "anthropic", specifier = ">=0.99" },
{ name = "httpx", specifier = ">=0.24" },
{ name = "ifcopenshell", specifier = ">=0.7.0" },
- { name = "mcp", specifier = ">=0.9.0" },
+ { name = "mcp", specifier = ">=1.10,<2" },
{ name = "mypy", marker = "extra == 'dev'", specifier = ">=1.8" },
{ name = "networkx", specifier = ">=3.0" },
{ name = "openpyxl", specifier = ">=3.1" },
@@ -57,6 +60,24 @@ wheels = [
{ url = "https://files.pythonhosted.org/packages/78/b6/6307fbef88d9b5ee7421e68d78a9f162e0da4900bc5f5793f6d3d0e34fb8/annotated_types-0.7.0-py3-none-any.whl", hash = "sha256:1f02e8b43a8fbbc3f3e0d4f0f4bfc8131bcb4eebe8849b8e5c773f3a1c582a53", size = 13643, upload-time = "2024-05-20T21:33:24.1Z" },
]
+[[package]]
+name = "anthropic"
+version = "1.12.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+ { name = "anyio" },
+ { name = "docstring-parser" },
+ { name = "httpx2" },
+ { name = "jiter" },
+ { name = "pydantic" },
+ { name = "sniffio" },
+ { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/bd/cc/0da23e94020c62c0077c17648252f32d575b187710faaf3b85145e8e555d/anthropic-1.12.1.tar.gz", hash = "sha256:10f720ab6ddf40ef12e0e5743412c3a6dfac1109c244e633c9a2dbd36778ad30", size = 1555908, upload-time = "2026-10-08T03:42:00.588Z" }
+wheels = [
+ { url = "https://files.pythonhosted.org/packages/8b/35/1ccdc3e950dd869b66de15035e15d9614607fcef9664dec403fe639f01df/anthropic-1.12.1-py3-none-any.whl", hash = "sha256:1c1469bb3f4118291756816b7850cc839f17b2be5cdc99c8fde3890a61a49ca2", size = 1919752, upload-time = "2026-10-08T03:41:58.596Z" },
+]
+
[[package]]
name = "anyio"
version = "4.13.0"
@@ -397,6 +418,15 @@ wheels = [
{ url = "https://files.pythonhosted.org/packages/84/d0/205d54408c08b13550c733c4b85429e7ead111c7f0014309637425520a9a/deprecated-1.3.1-py2.py3-none-any.whl", hash = "sha256:597bfef186b6f60181535a29fbe44865ce137a5079f295b479886c82729d5f3f", size = 11298, upload-time = "2025-10-30T08:19:00.758Z" },
]
+[[package]]
+name = "docstring-parser"
+version = "0.18.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/e0/4d/f332313098c1de1b2d2ff91cf2674415cc7cddab2ca1b01ae29774bd5fdf/docstring_parser-0.18.0.tar.gz", hash = "sha256:292510982205c12b1248696f44959db3cdd1740237a968ea1e2e7a900eeb2015", size = 29341, upload-time = "2026-04-14T04:09:19.867Z" }
+wheels = [
+ { url = "https://files.pythonhosted.org/packages/a7/5f/ed01f9a3cdffbd5a008556fc7b2a08ddb1cc6ace7effa7340604b1d16699/docstring_parser-0.18.0-py3-none-any.whl", hash = "sha256:b3fcbed555c47d8479be0796ef7e19c2670d428d72e96da63f3a40122860374b", size = 22484, upload-time = "2026-04-14T04:09:18.638Z" },
+]
+
[[package]]
name = "et-xmlfile"
version = "2.0.0"
@@ -461,6 +491,19 @@ wheels = [
{ url = "https://files.pythonhosted.org/packages/7e/f5/f66802a942d491edb555dd61e3a9961140fd64c90bce1eafd741609d334d/httpcore-1.0.9-py3-none-any.whl", hash = "sha256:2d400746a40668fc9dec9810239072b40b4484b640a8c38fd654a024c7a1bf55", size = 78784, upload-time = "2025-04-24T22:06:20.566Z" },
]
+[[package]]
+name = "httpcore2"
+version = "2.13.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+ { name = "h11" },
+ { name = "truststore" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/cb/f3/1db7aa2bc2524062192bb0e0323969492d1883152a232fe36eea65f4e35c/httpcore2-2.13.1.tar.gz", hash = "sha256:e0aa977abe17e69a3b820a24542a6fa88702676d83880b8d194dcd18408e5103", size = 68071, upload-time = "2026-09-23T07:47:22.372Z" }
+wheels = [
+ { url = "https://files.pythonhosted.org/packages/09/ba/a4568248771ce81957bfb7cc600264a40fbcda092391ee1c415c50be4bea/httpcore2-2.13.1-py3-none-any.whl", hash = "sha256:e1e05d4f25f7d7d496bfb96748f6f4b67657b03da069b3a68c36069f3db73d0a", size = 83423, upload-time = "2026-09-23T07:47:19.365Z" },
+]
+
[[package]]
name = "httpx"
version = "0.28.1"
@@ -485,6 +528,32 @@ wheels = [
{ url = "https://files.pythonhosted.org/packages/d2/fd/6668e5aec43ab844de6fc74927e155a3b37bf40d7c3790e49fc0406b6578/httpx_sse-0.4.3-py3-none-any.whl", hash = "sha256:0ac1c9fe3c0afad2e0ebb25a934a59f4c7823b60792691f779fad2c5568830fc", size = 8960, upload-time = "2025-10-10T21:48:21.158Z" },
]
+[[package]]
+name = "httpx2"
+version = "2.13.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+ { name = "anyio", marker = "sys_platform != 'emscripten'" },
+ { name = "httpcore2", marker = "sys_platform != 'emscripten'" },
+ { name = "httpx2-jsfetch", marker = "python_full_version >= '3.12' and sys_platform == 'emscripten'" },
+ { name = "idna" },
+ { name = "truststore", marker = "sys_platform != 'emscripten'" },
+ { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/d5/44/474bef2a0e9d90f1715d32cb98b0738695ca17ba324095fb2497ed7fbd59/httpx2-2.13.1.tar.gz", hash = "sha256:e48744a19e3af5ee48313d0ce5fe941d5422fae5705ea922a4aabf94d7800dfa", size = 100405, upload-time = "2026-09-23T07:47:23.052Z" }
+wheels = [
+ { url = "https://files.pythonhosted.org/packages/d8/9c/6fe8931fd9f381042a9e4c7d5a7b4cbf7016b252bec0c99a49fce42c3326/httpx2-2.13.1-py3-none-any.whl", hash = "sha256:6dff50fabc270ee5fd25d845d0b078ed20564579744d6d962850975996d2f9a4", size = 95597, upload-time = "2026-09-23T07:47:20.995Z" },
+]
+
+[[package]]
+name = "httpx2-jsfetch"
+version = "1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/cd/c4/0e5636363151a2a1795e0a77617168b9ca438e1748ec05fc9b5687f93d64/httpx2_jsfetch-1.0.tar.gz", hash = "sha256:70a0e3eabfef7cce5ad9c629f7d01ca05e418f586646f4ddf14782e4c1454c60", size = 6872, upload-time = "2026-08-07T00:13:07.492Z" }
+wheels = [
+ { url = "https://files.pythonhosted.org/packages/9b/43/832f631d32e4f1211caa2ba368317739fe71f0b8530e4c9d15dc454bac2a/httpx2_jsfetch-1.0-py3-none-any.whl", hash = "sha256:cb916b707601e69a07721aabc8f3f6659be3a6893bc1ff5c6f9e02241df2da32", size = 6382, upload-time = "2026-08-07T00:13:06.567Z" },
+]
+
[[package]]
name = "idna"
version = "3.18"
@@ -552,6 +621,119 @@ wheels = [
{ url = "https://files.pythonhosted.org/packages/15/aa/0aca39a37d3c7eb941ba736ede56d689e7be91cab5d9ca846bde3999eba6/isodate-0.7.2-py3-none-any.whl", hash = "sha256:28009937d8031054830160fce6d409ed342816b543597cece116d966c6d99e15", size = 22320, upload-time = "2024-10-08T23:04:09.501Z" },
]
+[[package]]
+name = "jiter"
+version = "0.17.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/9c/1f/8176d92e001f86505424b41664032ae26a882bc9ca41a32c803f373f9195/jiter-0.17.0.tar.gz", hash = "sha256:03e432f226a453851079fb84cd17c6da9991eab723e28d716f14ae3d906e0c12", size = 229037, upload-time = "2026-09-12T15:14:14.253Z" }
+wheels = [
+ { url = "https://files.pythonhosted.org/packages/a1/50/17afdaffcc8af4bf4fddf2b6c26d066553aa2221983f2affcde435fc2532/jiter-0.17.0-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:cfafd7be8b16ceadd298db542cead37cddc211c4c49e04ad2596924df18625b1", size = 290699, upload-time = "2026-09-12T15:11:30.085Z" },
+ { url = "https://files.pythonhosted.org/packages/c9/e4/c185d32d5b3657ad84da26c84a9eb15f00aa1b39d6882fcc0052dba2d7c2/jiter-0.17.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:8adca2e793288e5f1bb29279bb439d0d3cfbb50eddca7e7e6ffd42ff4f482406", size = 324246, upload-time = "2026-09-12T15:11:31.3Z" },
+ { url = "https://files.pythonhosted.org/packages/24/7a/8b8903bfe91a90a8fa1ec9b45d9fda5b6287a386693b69d720a882d73f3c/jiter-0.17.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:30c692d567ba206c7cca38c9d1d0ccc70c9786290173c184d871ca12e9981ed7", size = 343275, upload-time = "2026-09-12T15:11:32.758Z" },
+ { url = "https://files.pythonhosted.org/packages/a2/5d/6821fae2abc71a3c3a84bef8598d31fc4f27d9edfb55bd8f6c08afb8ef93/jiter-0.17.0-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:81c83c0abe614446a283d994d2c07c4f58632dea2cdf66ba9e2921bb8ccd593e", size = 328034, upload-time = "2026-09-12T15:11:33.9Z" },
+ { url = "https://files.pythonhosted.org/packages/f3/51/8e7a963b1c2dfdc01d6228b004f50a2a3d7c46f0549d7b096a5d15ef81d5/jiter-0.17.0-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:073dc68c1a700c8fc480e877864a6b6ffc887533e261f4380c08c16bf09d057a", size = 342457, upload-time = "2026-09-12T15:11:36.414Z" },
+ { url = "https://files.pythonhosted.org/packages/73/27/8b2a267e3bda45d9298331cacfe3521e761f0a2b05ad10a23c6548d08358/jiter-0.17.0-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:492f37230bbf9581ab2c17bcda862c249afb9ae2e3ab2dd6db59943bc4cc3153", size = 351271, upload-time = "2026-09-12T15:11:37.692Z" },
+ { url = "https://files.pythonhosted.org/packages/4a/8f/5c74e5e142a6736833d7a991ab04d5c0738038dc44db05af0bb3cd2559e8/jiter-0.17.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:5888fe5abc1ca2fa834a3e1b4c7ef0dcece286a7d7e95a609ef0934b777b9fc9", size = 346052, upload-time = "2026-09-12T15:11:39.722Z" },
+ { url = "https://files.pythonhosted.org/packages/98/9c/f54920f06d1696e80b1be841d56412871c6856b1b1e3b541b1ed35346554/jiter-0.17.0-cp311-cp311-manylinux_2_31_riscv64.whl", hash = "sha256:84ac78df457e1ee3f7e733bd114823302ae8c5ad5542d7e6647d92ffaa090a04", size = 328915, upload-time = "2026-09-12T15:11:41.065Z" },
+ { url = "https://files.pythonhosted.org/packages/21/53/080f126863bceb055db9f1fd5431485eb493b35545a3c35e961ac18cd924/jiter-0.17.0-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:7573e80232c5bcf80c24c038cf7e53a463f5c3b1dd1dd4109d66304f4dccc233", size = 337240, upload-time = "2026-09-12T15:11:42.356Z" },
+ { url = "https://files.pythonhosted.org/packages/f0/76/3ab742823a0e0e70e143c6c90a482d9d90396ac2445e7b9483eb7245d3b5/jiter-0.17.0-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:11902505d401691720f5785c15b02204248526edee11b635cd6c40cd52b81599", size = 484917, upload-time = "2026-09-12T15:11:43.549Z" },
+ { url = "https://files.pythonhosted.org/packages/14/e0/8ca71bc8b9cc9ed96c9da565863e00f3bb875a8fb82abcf03e975e067902/jiter-0.17.0-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:64846211a2debe7c071d2146d2283d2b0c1c93dc8fd5fb7794faac2ca6061b5c", size = 521868, upload-time = "2026-09-12T15:11:44.704Z" },
+ { url = "https://files.pythonhosted.org/packages/c1/02/81f8719dcedb75713082a2048405376c81f6546b75af8167f3bba01a1ed0/jiter-0.17.0-cp311-cp311-win32.whl", hash = "sha256:c19b9357309b8cc6de8a48fca8e44a8c9c2feaaa2f5896d037fa505d48fcab80", size = 187844, upload-time = "2026-09-12T15:11:45.874Z" },
+ { url = "https://files.pythonhosted.org/packages/3e/8c/59693f348488f01ed12d862e99ab8da14961152d3e9c39b9b1ef363f3572/jiter-0.17.0-cp311-cp311-win_amd64.whl", hash = "sha256:e654b6b04e39c9cb19cb8b04c6ddf1f2db07751fa14156413969fd78bad0e5cb", size = 231402, upload-time = "2026-09-12T15:11:47.083Z" },
+ { url = "https://files.pythonhosted.org/packages/fe/89/fb35e286463cb9f01edc2c4e47df6e5477ee36bca5096414e9ea87985588/jiter-0.17.0-cp311-cp311-win_arm64.whl", hash = "sha256:3ad556afc289f15d2b181b941982d01f06190863c07440185b9f354e1bd2def3", size = 187006, upload-time = "2026-09-12T15:11:48.245Z" },
+ { url = "https://files.pythonhosted.org/packages/aa/f8/07bd8c3a23f7a8a6875e6a820bbffe1483a18f18f9398a91b5495123176e/jiter-0.17.0-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:ebf918dfd6a74adc1b9ad71f63c4ab00902fcd3b7fd39f2e24d871db8d713b91", size = 291633, upload-time = "2026-09-12T15:11:49.431Z" },
+ { url = "https://files.pythonhosted.org/packages/0e/5e/0de4c6f84ffefa6809ffc2d550b9a314365acf7e7ec9b6c7375d49047900/jiter-0.17.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:61aed66ee042b3b49ef85fdf75714234d055d89d8496ac1c6e47f89e7a30d5e4", size = 321695, upload-time = "2026-09-12T15:11:52.727Z" },
+ { url = "https://files.pythonhosted.org/packages/20/ac/befe2e82065bee37a0252081666ed2f48c1ac5f5c6c318c2de8168ba393d/jiter-0.17.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:76eb4a5c20e86f9f848286f167024890f2862258a965d254774deb7fc1545ca1", size = 341967, upload-time = "2026-09-12T15:11:54.231Z" },
+ { url = "https://files.pythonhosted.org/packages/9f/cd/9797c1e529746750ae589da7c1a8c24373f00d88e11a989f9e5eb1959079/jiter-0.17.0-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:bcc064f99183a9cbe7f26ed648c352031a74145cd61ed75d34632c73eb46a5a8", size = 326546, upload-time = "2026-09-12T15:11:55.41Z" },
+ { url = "https://files.pythonhosted.org/packages/d9/fd/e6914c38d6347bab4ebff2b1f0c0f191db276e7a1d5c376176757da42fe3/jiter-0.17.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:73b64e69c4150748e020356d958af94bec33c70a0a93d665cfa8f6d580fe1a63", size = 340995, upload-time = "2026-09-12T15:11:58.211Z" },
+ { url = "https://files.pythonhosted.org/packages/9d/7d/611b3abf6f88945b5474da5cdc6d1a185e805ac9bf446bb7766dcda6ea87/jiter-0.17.0-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:f0bc7f684b65bcda9c20434267577db71bf9905ceddd32b60d1d93278d8c8d3a", size = 352188, upload-time = "2026-09-12T15:11:59.414Z" },
+ { url = "https://files.pythonhosted.org/packages/52/f8/b6e513ecbdf3b3cebe587c2279281ecf775b729a58cf4cc7bdf898ded029/jiter-0.17.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8c21265b251d99bbb40080d178a8953e35601d3a1564e05c4de4c0d2ca616797", size = 345025, upload-time = "2026-09-12T15:12:00.697Z" },
+ { url = "https://files.pythonhosted.org/packages/28/a8/fe26d06c5a6c5a4cfe703c5154c8a140da1305671eb3681aba9422d4f393/jiter-0.17.0-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:f3d7f7b34114f7ddc6d72a8e882d49de636b35d9fd12b4d420d3c5729f6c9812", size = 329180, upload-time = "2026-09-12T15:12:01.831Z" },
+ { url = "https://files.pythonhosted.org/packages/e1/58/e6d66a26af40a20e62486feb7e222fd50f6e7aaa4f107abd89675dcc835b/jiter-0.17.0-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:5078ab00664307fab2019b522a93aeb191122789f085daf5fd9e362154021d4a", size = 335805, upload-time = "2026-09-12T15:12:03.056Z" },
+ { url = "https://files.pythonhosted.org/packages/ef/3e/96520aa2fef5ef831d95483a902140bfab83dcac9eaa74f7df61b5e50a1b/jiter-0.17.0-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:470e1b1e4c42f1ead2189166a299691871a2df5056c976e7fb96feafaf5f9d44", size = 484121, upload-time = "2026-09-12T15:12:04.414Z" },
+ { url = "https://files.pythonhosted.org/packages/6a/8f/5d9d92fe538bf36ff481a2278c48147e59c1cf8eb2f7be665260665febe5/jiter-0.17.0-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:6eb6aedeb7352b8f3b6af9cbd67983840165c00428e63f1b420a85885128ea31", size = 521310, upload-time = "2026-09-12T15:12:05.612Z" },
+ { url = "https://files.pythonhosted.org/packages/50/06/a09f979b22e652afbc3de66c709b2ba92edcef555f7535ab937c86b4f21a/jiter-0.17.0-cp312-cp312-win32.whl", hash = "sha256:362bb47423886d45a9f705d2d9d4008c6eedd4e41eb1bab4e96fb6daa06b33fd", size = 185029, upload-time = "2026-09-12T15:12:06.994Z" },
+ { url = "https://files.pythonhosted.org/packages/6c/d9/98265a005b2473ec2be5a84e2b64c2f65382c673879f1574845cd4bcd77c/jiter-0.17.0-cp312-cp312-win_amd64.whl", hash = "sha256:9bd3caac219df476dd0cc3fe01d2f1581ed588906feac767abd9614c1c12f8b3", size = 227381, upload-time = "2026-09-12T15:12:08.823Z" },
+ { url = "https://files.pythonhosted.org/packages/a8/11/2e05bf5a56e57a543ebb8f585074adf09383e99d7b062dac92eab1f4d57f/jiter-0.17.0-cp312-cp312-win_arm64.whl", hash = "sha256:36ee6e69027396664e59995b9a635a947a5304ee9837279584a0bb8145c8f6b8", size = 183610, upload-time = "2026-09-12T15:12:10.374Z" },
+ { url = "https://files.pythonhosted.org/packages/40/eb/2c4a8075ed5ea02b56911e9375d4c8d7784572ff4af32e5a99ae0d071044/jiter-0.17.0-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:1b18434638228c0c184281609bf3d9459026a0f1ea48fb76c205e3ef72069caa", size = 290991, upload-time = "2026-09-12T15:12:11.641Z" },
+ { url = "https://files.pythonhosted.org/packages/ca/b1/34bfa29599d420423baac6ff7cada6674fe63d5a7a2ccb3900b904678783/jiter-0.17.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:ec89771f4272b989487a6364e519db6bbaba323e8bbf949ac89a45ea9c18b7a3", size = 321425, upload-time = "2026-09-12T15:12:13.855Z" },
+ { url = "https://files.pythonhosted.org/packages/11/71/a5ac64a62a04aebd556afadab14a6b730001e16df87266ded943a100a1d9/jiter-0.17.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4e3f052c671d5f425cca5ea5901cf11a831369fba4a55a3862cab93c323b4c3b", size = 343138, upload-time = "2026-09-12T15:12:15.046Z" },
+ { url = "https://files.pythonhosted.org/packages/01/dd/f761e320ea473314cb68612bc6a435393464dbd198051399b36848b4ebf3/jiter-0.17.0-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:785a216bbaf8f15fc974e964ced7322cd3d774bb0e86949edd78c6bffd6ba35b", size = 325805, upload-time = "2026-09-12T15:12:16.506Z" },
+ { url = "https://files.pythonhosted.org/packages/19/1a/27d8e40f0fb29bbc7a5adf30907144396a115dbe93d5d8976c054a6dfe96/jiter-0.17.0-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:d85c558c9f8532bba287a990ac63767c7daf756f0d8c030219f62499b1fa228a", size = 340230, upload-time = "2026-09-12T15:12:17.682Z" },
+ { url = "https://files.pythonhosted.org/packages/ac/c0/30bcde78a28155461f965d16b7aca4ffca6d17494d905f7a0bb072e6c64e/jiter-0.17.0-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:5c23849235d2142ce444b2b8c6eceee9f82f4cc0bd5c9081602e4155c6197807", size = 351343, upload-time = "2026-09-12T15:12:19.337Z" },
+ { url = "https://files.pythonhosted.org/packages/27/17/91420b156315ae22732f5ee1a7b5725a030aab9dc8fd7dcdacfb4aa588d3/jiter-0.17.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:58df29268a95e910f17db7ec9178eb7f15aa8619aaca3575275c4e6b3f4fe4c5", size = 344990, upload-time = "2026-09-12T15:12:20.705Z" },
+ { url = "https://files.pythonhosted.org/packages/6d/a2/ae6d5672644cc11127970277c9aeb0fa6fae376845587f5b0a8e8828167c/jiter-0.17.0-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:a277f97eba7d66b1ee27eb5dab5b774ff46a10c78d89a1d3dcce04ce1357c8ca", size = 328624, upload-time = "2026-09-12T15:12:23.859Z" },
+ { url = "https://files.pythonhosted.org/packages/04/62/45cb1162f6aa586536e4a973fc339d72dc6b08cca030d70a838a307aa778/jiter-0.17.0-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:fe15ddf316f1f1f643347d3a474e74ce61880c79a11ec5dca53df20c071bd3e8", size = 334731, upload-time = "2026-09-12T15:12:25.229Z" },
+ { url = "https://files.pythonhosted.org/packages/d9/5f/45c1574b644da7deda0b7591c349520dcf83ce45b24d7ca19922dab1fc27/jiter-0.17.0-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:02adebb7ce6413c44d40af9ad59d1c1cd79630ccdcb6f7bdd2d461e48c03d8f9", size = 483649, upload-time = "2026-09-12T15:12:27.557Z" },
+ { url = "https://files.pythonhosted.org/packages/c1/d3/ebea1ecb5b241c519f192b30215c79a8e47f42f1621acbcd6f8830728416/jiter-0.17.0-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:55d0e0e613a3f9ad600cf436e0e2b8057d1b52bcf1d91b2d36ac53451231e6a8", size = 520758, upload-time = "2026-09-12T15:12:28.99Z" },
+ { url = "https://files.pythonhosted.org/packages/64/e6/682b641ff0765ea9bdc349dbc7d223de5c8af8ec1abda0db3406992f92fe/jiter-0.17.0-cp313-cp313-win32.whl", hash = "sha256:2c45ad7c973ef33fe5114a953377b35a95240f4542c0724d9f781e47dc24bac7", size = 184334, upload-time = "2026-09-12T15:12:30.813Z" },
+ { url = "https://files.pythonhosted.org/packages/b8/d2/9a49aac2b27af4cc5015e368c0cc3588491a532f717a668ffce1f1ac57da/jiter-0.17.0-cp313-cp313-win_amd64.whl", hash = "sha256:a3cebb1fe4a1abb00465f3f8a17e09112603e8b7c59e5c3adbcd9f7815a64acd", size = 226601, upload-time = "2026-09-12T15:12:32.096Z" },
+ { url = "https://files.pythonhosted.org/packages/b4/ce/9a43e9f614608eafa78de22aedcff54cd21324467b5d442d5c9b00244145/jiter-0.17.0-cp313-cp313-win_arm64.whl", hash = "sha256:96b8b0c6dc5d78682f54a450785e075aa929cde768304cad363cd4efba5a82ac", size = 183103, upload-time = "2026-09-12T15:12:34.396Z" },
+ { url = "https://files.pythonhosted.org/packages/01/9e/23065f8e2c7a4c372c1b6f6622e4cfab4dc786cb5150052b1527e6a6a840/jiter-0.17.0-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:00d783a779c5664e16dbad5e3a3c3a75e128b07dd5f4765159658d9210a50ca5", size = 292210, upload-time = "2026-09-12T15:12:35.613Z" },
+ { url = "https://files.pythonhosted.org/packages/ea/81/67b58647560bc82a4490d722caa8561d7a86a9f45d4fa620b7e5fe282c7a/jiter-0.17.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:0619d806e260ecf0c2a64521942c94af5d547c9ec99b55ae4f51b538b5576a76", size = 321512, upload-time = "2026-09-12T15:12:36.907Z" },
+ { url = "https://files.pythonhosted.org/packages/c7/07/6658359a25f55927f7f8bf0e16465dee2ccd0b2a1a5208acc0df8972e074/jiter-0.17.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:dc0288ce39190ee33fe6e4ec73161eed34e7e2da509b525546ca061778d62b64", size = 343897, upload-time = "2026-09-12T15:12:38.189Z" },
+ { url = "https://files.pythonhosted.org/packages/46/04/5d50a9f0319cbdc37fd53c27f8c313d46afc34f1b048219ae6d8ea068da4/jiter-0.17.0-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:5a52a430d04225ffde633e6840bf2381d34c019ff98526b5929755b9052fb199", size = 326519, upload-time = "2026-09-12T15:12:39.532Z" },
+ { url = "https://files.pythonhosted.org/packages/bb/c7/d02517832b29eb8275fdd0f4ce0f17b80f58cc4c3ebecd4d9ace990d633d/jiter-0.17.0-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:37f33d327900bf2879613b3363fd48df97b4232d0c41f54bcf2e790c2fc40a71", size = 341369, upload-time = "2026-09-12T15:12:41.486Z" },
+ { url = "https://files.pythonhosted.org/packages/3b/07/499b5f5603501cdd93a73a6a176dfad9c96555a3ae58ca9f8e3acba63dc9/jiter-0.17.0-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:6cf564d43c4388149ca58ee571d0f5ccf875e20d1fd4662fd94cc0d1ea3b10ef", size = 352160, upload-time = "2026-09-12T15:12:42.721Z" },
+ { url = "https://files.pythonhosted.org/packages/f5/75/b04013c7743269d4533ef4e746fc0ed678a143968dd7448658e3f51daad2/jiter-0.17.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:523c499235fb65add25d4bb01b1c4709ce695efdc7deb6c0a7bc515b5c44e0fb", size = 345018, upload-time = "2026-09-12T15:12:44.192Z" },
+ { url = "https://files.pythonhosted.org/packages/1d/96/cbb6fd1e42a77c8412ec4643db95059b30cdfc635e387cc9193e098ce268/jiter-0.17.0-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:455e4ab35cb2a4a91a8404e08fd3c621bae433922e59bf1c494fe20a426b013b", size = 329244, upload-time = "2026-09-12T15:12:45.491Z" },
+ { url = "https://files.pythonhosted.org/packages/15/67/d3be402f398566a379bf40ae65be5c3505b14d9e95e0802a597ddde7ddee/jiter-0.17.0-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:6871973bfbd4408f7f1c632b30bbb5bbd9671c1bc8650af6823e24b7be13709b", size = 335693, upload-time = "2026-09-12T15:12:46.935Z" },
+ { url = "https://files.pythonhosted.org/packages/7f/8d/98e2c4130b93d64f1d67c89060b928d04102549bf05e64451c9e6024f9ca/jiter-0.17.0-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:77f6aac0137309b31448c1bdcda4c6c77077664a6d018ece8d94019c68a5a5b9", size = 484329, upload-time = "2026-09-12T15:12:48.361Z" },
+ { url = "https://files.pythonhosted.org/packages/78/5e/8da91e49f0fbca37c3489fb4cf3ad6676d4965f00ae5468bca3a2513737a/jiter-0.17.0-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:93946d89fa04d5ba64dd323a8dd8d901676cb8a3c81d99ae4f6c051a9b4c3f2f", size = 521358, upload-time = "2026-09-12T15:12:49.856Z" },
+ { url = "https://files.pythonhosted.org/packages/be/21/5388684a5a38af3557cd9c2424b9827c71809cff24373c75ef9d0d3dfba9/jiter-0.17.0-cp314-cp314-pyemscripten_2026_0_wasm32.whl", hash = "sha256:70f19a2ca8429f91e82eeffb2f51cb87bc2d6e953b009b91a92d29c3a16ccb03", size = 110459, upload-time = "2026-09-12T15:12:51.747Z" },
+ { url = "https://files.pythonhosted.org/packages/b1/ad/58b3a93525d2ffca7f54d9dee441381990082bd1172fbeb8d6a3f72a4dc3/jiter-0.17.0-cp314-cp314-win32.whl", hash = "sha256:71dbd74314c5df52a1bccf7b8bca46d14e943af7a2012e73b23f49977ef194c8", size = 185043, upload-time = "2026-09-12T15:12:54.477Z" },
+ { url = "https://files.pythonhosted.org/packages/7a/4a/1aa520eb6c359b262c14ff995ca7283837208ddfb1202082ce9d73cf214d/jiter-0.17.0-cp314-cp314-win_amd64.whl", hash = "sha256:ac3c6ee3264d6f5c44c617f90bc7e8b9e1587e7d6708c9d8f811cb65582ee312", size = 227163, upload-time = "2026-09-12T15:12:55.931Z" },
+ { url = "https://files.pythonhosted.org/packages/cf/e4/5997f648794bd9b499491d0ff480b096cc9a9c65bdba29f57568e6aa1705/jiter-0.17.0-cp314-cp314-win_arm64.whl", hash = "sha256:6219adaf59711ba7063a52496e8ec6d3fa3e209d7827d83eee3b2abc780a1744", size = 183505, upload-time = "2026-09-12T15:12:58.196Z" },
+ { url = "https://files.pythonhosted.org/packages/ac/4a/84a5ec271d09f7590b6073af5ee4abb44eab4ccace453b7e2c5ce45234ca/jiter-0.17.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:59bddbe6f9ffecc68d641e1e2d619ce64cf8a9e9eeb74e5c518f74fc87abf1b0", size = 321527, upload-time = "2026-09-12T15:12:59.394Z" },
+ { url = "https://files.pythonhosted.org/packages/39/71/9e1fd0045f5920b4c36be35c3f0f0dfd123668684f8ad352619d7aa44183/jiter-0.17.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6cb41cd1432f1dc19a231cf70b54d42b2c9f05085155859263fce06fa4d41388", size = 340865, upload-time = "2026-09-12T15:13:00.756Z" },
+ { url = "https://files.pythonhosted.org/packages/b7/2b/14627fd2bc377f3dd09491bcace6b90e34b4d7fea2f1f3295031ff91f528/jiter-0.17.0-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:fd7790aa79c8b518e512ebcdfce9f11d8ef5f30efd43720c8a19a548b39fa489", size = 325412, upload-time = "2026-09-12T15:13:02.152Z" },
+ { url = "https://files.pythonhosted.org/packages/4c/f3/8d5808f7bf0f456bde79e6393587183a0cee5f83d179fe1f7f1eff2ba067/jiter-0.17.0-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:dbbfe4e3c21c8166980cddc5bee1a315df082454f007947dfb6fb73800768165", size = 340473, upload-time = "2026-09-12T15:13:03.485Z" },
+ { url = "https://files.pythonhosted.org/packages/4f/da/1d8c7c6c4ae6b2423b94a81b6b907d37b28f87664e077427b531bf1b5313/jiter-0.17.0-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:8c286860abfe8b100cac1c02e225e5776eb9216edd71ba17cdb237da4af32bc9", size = 350757, upload-time = "2026-09-12T15:13:04.828Z" },
+ { url = "https://files.pythonhosted.org/packages/eb/96/c1813dcca15c5a370145a448aaea7d1f83f6f0228a5f1130e79340ee385f/jiter-0.17.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f753eb70b1474a29e635e7542ff7312e6d6b951e0b25e8a2e8c34eeb1ddcd478", size = 345203, upload-time = "2026-09-12T15:13:06.131Z" },
+ { url = "https://files.pythonhosted.org/packages/d7/f7/fc61cbcf2992d169ede13648fc3fd8e2d3171a3669dde43cd4db556549ac/jiter-0.17.0-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:eae86b1f027031e39db2e0e9c4842221edb7b8cd474d23f87a79b3bd4b651768", size = 328322, upload-time = "2026-09-12T15:13:07.392Z" },
+ { url = "https://files.pythonhosted.org/packages/8f/88/46418a3abbdffb7dc41b314200360f24f75faaeb35573e81c92de322cce9/jiter-0.17.0-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:5bf350452a43173e69e1fc74847c57a60e3d7515807287f29849baa2a85d8718", size = 336570, upload-time = "2026-09-12T15:13:08.666Z" },
+ { url = "https://files.pythonhosted.org/packages/f0/28/b8a55b949be6306df8888e365a8df05441de8a7b11289f6957004302e41e/jiter-0.17.0-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:da139721f4b7cafdbff580a4f511ea24cb91f4909330c6b926a1ca53836c0a59", size = 482879, upload-time = "2026-09-12T15:13:10.037Z" },
+ { url = "https://files.pythonhosted.org/packages/75/3b/21d0afa53ba0680962c39f3eb95ed2946f8793369ed44b0c82b490723081/jiter-0.17.0-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:8079849db9a1371bfd90bad088458a8fb836261879df2233cc9632464ecf64e1", size = 520406, upload-time = "2026-09-12T15:13:11.456Z" },
+ { url = "https://files.pythonhosted.org/packages/ef/03/bcbaf8b6b9ea23c2c074411f8ecfbb02d820abac5d0cb8f4e280209174a2/jiter-0.17.0-cp314-cp314t-win32.whl", hash = "sha256:8f770b0c77e5fac482e1ba03ca1a7e18286bfb213d749932a00a7e4cd5de5e06", size = 184434, upload-time = "2026-09-12T15:13:13.037Z" },
+ { url = "https://files.pythonhosted.org/packages/7a/b5/5d6ce2c93ef6fe1241b37a9005547f9b6d58db1f07f39fe95807d4b98f51/jiter-0.17.0-cp314-cp314t-win_amd64.whl", hash = "sha256:c4289293e5278d9314b00f15c37f2120fa51d3d68565292e715524c750e775a9", size = 227392, upload-time = "2026-09-12T15:13:14.933Z" },
+ { url = "https://files.pythonhosted.org/packages/f5/4b/1e52baf90187606e33a7b8cfa8f96f5829acd7f01870077eb01059ab76d0/jiter-0.17.0-cp314-cp314t-win_arm64.whl", hash = "sha256:4dfbfe5a6e1e80a7082af559f66386405025ec278833e0c649f69cbc6e1004cc", size = 182776, upload-time = "2026-09-12T15:13:16.239Z" },
+ { url = "https://files.pythonhosted.org/packages/05/fc/efe3ac75564ab10f53517958f5ccdc231fc7334af66c76776cb554a88967/jiter-0.17.0-cp315-cp315-macosx_10_12_x86_64.whl", hash = "sha256:84963d3f395ef5e9a32ce47155e08a7962fa292c159a10cb98b931cef1416925", size = 292143, upload-time = "2026-09-12T15:13:17.502Z" },
+ { url = "https://files.pythonhosted.org/packages/d1/4c/46982118d91f9ffe9714319d21ec4f98d9b7e0cfd9062826c524a54de24e/jiter-0.17.0-cp315-cp315-macosx_11_0_arm64.whl", hash = "sha256:ffa0380ad091de7d3fc33e17a97ff479851ee18a0a2a3ee56ff3215cdc886656", size = 321341, upload-time = "2026-09-12T15:13:19.133Z" },
+ { url = "https://files.pythonhosted.org/packages/e7/12/9b1ac6ecc6307049913db54839ddba1c11c1ef72c5a8bbb5514bc3b50d1b/jiter-0.17.0-cp315-cp315-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:755079792868ce5d4938e83b91a0939b34fb858a1ca65a104f2d771bea57faa1", size = 344383, upload-time = "2026-09-12T15:13:20.508Z" },
+ { url = "https://files.pythonhosted.org/packages/a9/b6/527cc72af836d824e9d4d666e64f0a1ca7eafd662a8da9657b78592172ba/jiter-0.17.0-cp315-cp315-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:3bf4dc2b84a464117fb097d15a25c58d100d2692888e3b0d92df5b48ed16b7c0", size = 326841, upload-time = "2026-09-12T15:13:21.83Z" },
+ { url = "https://files.pythonhosted.org/packages/d1/41/567f98617e88005b249503b933803f633ec6ba2d427cf4cc35e5c832125c/jiter-0.17.0-cp315-cp315-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:02a360707033d8cef53f7f3480817a1489177a259ec6ec01e98c37e0b922ddca", size = 341354, upload-time = "2026-09-12T15:13:23.323Z" },
+ { url = "https://files.pythonhosted.org/packages/40/da/b29cda895b785f7d426e224638a885b6145a08ce853b381f34afe3e88c5d/jiter-0.17.0-cp315-cp315-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:300ce01ab0215e3dea4d00090143c909aedc65c0f809b3c07983e1d038f291b9", size = 351985, upload-time = "2026-09-12T15:13:26.526Z" },
+ { url = "https://files.pythonhosted.org/packages/f7/5c/8a73829e7389e72ea298a450f2b3cb58e71a3e464b45f6d8753740f1c4f5/jiter-0.17.0-cp315-cp315-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:746243a080b4ca790b8499af3d7cf9825d5f5987933950cd818e767ee353d826", size = 346052, upload-time = "2026-09-12T15:13:27.887Z" },
+ { url = "https://files.pythonhosted.org/packages/1d/2f/98d6001026932c095ba440925570123043bed29f5ff56158dfe729a9e81b/jiter-0.17.0-cp315-cp315-manylinux_2_31_riscv64.whl", hash = "sha256:b550585523339b71cb852b811aae49d08d7601ad8ffe9f5dc1562f4c3d22fd87", size = 329159, upload-time = "2026-09-12T15:13:31.569Z" },
+ { url = "https://files.pythonhosted.org/packages/94/2e/708dc1d2678f092c31c12754e860cd8353e6a85ecbdb1010157edca0da9e/jiter-0.17.0-cp315-cp315-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:0239520085cac678e77a606fd7e3f1c60c371d719790c5e3807388d3da4354c2", size = 336001, upload-time = "2026-09-12T15:13:32.846Z" },
+ { url = "https://files.pythonhosted.org/packages/f4/f0/75a5ae38862f4eaf0fe2f8a9fbf6484c4890df04c06dcdffc45e36bca61a/jiter-0.17.0-cp315-cp315-musllinux_1_1_aarch64.whl", hash = "sha256:eb2295da7c3769f6719b227a237aa6a5cfa6550e478bc838001b592c57e16575", size = 484281, upload-time = "2026-09-12T15:13:35.333Z" },
+ { url = "https://files.pythonhosted.org/packages/a0/32/6636fae811c27c7f93e1b11fb5800de6a5c9e4269a27cf718e0b31218ad1/jiter-0.17.0-cp315-cp315-musllinux_1_1_x86_64.whl", hash = "sha256:e088612ff90ebc9247e1a43074b72835804261c47e6a6c01cb3ddcb55360d688", size = 521300, upload-time = "2026-09-12T15:13:37.101Z" },
+ { url = "https://files.pythonhosted.org/packages/61/aa/12df7e0b0b1a2602e3d5a5a7104d7d9700f254b400f134a9b50955c4d231/jiter-0.17.0-cp315-cp315-win32.whl", hash = "sha256:0b52d52035b3907c5b1f6277857b29c1cbfc965e24e0f27330dbed83edb591ec", size = 185138, upload-time = "2026-09-12T15:13:38.901Z" },
+ { url = "https://files.pythonhosted.org/packages/ba/ec/3dd2e495032cddde05723c1f4c743b67a23e55d2af244692a7f58f0cdae3/jiter-0.17.0-cp315-cp315-win_amd64.whl", hash = "sha256:10f5558eed511b830488003449d942bd75829ad6257dc58cb9a03e596a7777b1", size = 226950, upload-time = "2026-09-12T15:13:40.17Z" },
+ { url = "https://files.pythonhosted.org/packages/c3/c7/ef85704e0a57e9cadb2babc05f6d7c5df4a1c75da1a6ee31e1986b0099a5/jiter-0.17.0-cp315-cp315-win_arm64.whl", hash = "sha256:fa13acf1046f95df808c64b1310705e143fab87aee73ae00cc42d640867fd2c1", size = 183618, upload-time = "2026-09-12T15:13:41.432Z" },
+ { url = "https://files.pythonhosted.org/packages/0e/9a/a4b348349de68762b58d6713973d363ad80a1c741d0bf8def7975f0ecb26/jiter-0.17.0-cp315-cp315t-macosx_11_0_arm64.whl", hash = "sha256:af2f7501580f274b63c4b2283bc425f5df7edf06ae5b171e5f87d912ff359a20", size = 321155, upload-time = "2026-09-12T15:13:42.716Z" },
+ { url = "https://files.pythonhosted.org/packages/c1/70/aebd6d0b5f0677de3a3d0bdc4a05fac949b97c4ede454c8809f180ac7b17/jiter-0.17.0-cp315-cp315t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:10c5349312e5cb02b7a21e123a57665afa895953f05bf252a9dd4c13a572b7ab", size = 340985, upload-time = "2026-09-12T15:13:44.115Z" },
+ { url = "https://files.pythonhosted.org/packages/a7/82/4c3b49796b5eb62f3f5046f957683f4ba0135fe1a60957c11180512460df/jiter-0.17.0-cp315-cp315t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:86f3f9343a288eb85a81ef20a752b2f84564296636db54a9fff0b5c8deaf1df2", size = 325670, upload-time = "2026-09-12T15:13:45.901Z" },
+ { url = "https://files.pythonhosted.org/packages/bc/43/f6341ecb4872202a4ef150486fcee0e1ace4aa3da39b71b82061452cdd3a/jiter-0.17.0-cp315-cp315t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:4607ec7d93355fbc25b8dc5189153cf21d66063b9f9cd04dd2774e6e783f9b6a", size = 340339, upload-time = "2026-09-12T15:13:47.442Z" },
+ { url = "https://files.pythonhosted.org/packages/f9/c4/bc2c86e08fa065e03cb2fbc53b367c3640a7d257ef9d877b29118ea636b7/jiter-0.17.0-cp315-cp315t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:10cd64a5720ad7f809ac5466ff1705813f1b6b510f195a73acafba0ac0e1f675", size = 350705, upload-time = "2026-09-12T15:13:48.848Z" },
+ { url = "https://files.pythonhosted.org/packages/9d/67/91f12aa111cca6e3a197c3e36bf60a034bf9f122f6d41112a639e44217d8/jiter-0.17.0-cp315-cp315t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:efe9f61bb30174d2f5c8396445c360c96c44e78164d0815dfe627ccf57849574", size = 345011, upload-time = "2026-09-12T15:13:50.215Z" },
+ { url = "https://files.pythonhosted.org/packages/f5/cb/9f5556e8f6ec89755fb5a709d8eb8270c9a324e31079eda0dfbeca451b6e/jiter-0.17.0-cp315-cp315t-manylinux_2_31_riscv64.whl", hash = "sha256:370d8fe5bf201dc6925e8a84c81ac7291f74d9fd1778234fc79d517064a5c76b", size = 328268, upload-time = "2026-09-12T15:13:51.809Z" },
+ { url = "https://files.pythonhosted.org/packages/22/98/153f20680fb75781a490fb849940e2b00f95035c7aa054df592f36ed33fc/jiter-0.17.0-cp315-cp315t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:6b303d88e6a0bda789ec4b7801c7bad68e27230ba1fe4baffc756d1fbd32dc9d", size = 337024, upload-time = "2026-09-12T15:13:53.095Z" },
+ { url = "https://files.pythonhosted.org/packages/af/59/b16c9be3a5035df4466cc72e888188c027562de90a723d290ab6814cb9d4/jiter-0.17.0-cp315-cp315t-musllinux_1_1_aarch64.whl", hash = "sha256:30793a24a31e968969757c9e08d830cbb15a2cd3c4959b4498b38f4b1c2258eb", size = 482766, upload-time = "2026-09-12T15:13:55.713Z" },
+ { url = "https://files.pythonhosted.org/packages/d0/55/667dea313094024bef082175d6bfe8976f90d1c00c926af9df1d8e0eab48/jiter-0.17.0-cp315-cp315t-musllinux_1_1_x86_64.whl", hash = "sha256:686c93d86f2b426c803024b805bd161a6cd10e9627c23e901640eab646c0ad8a", size = 520367, upload-time = "2026-09-12T15:13:57.674Z" },
+ { url = "https://files.pythonhosted.org/packages/21/e3/4b1a43501fb9ed17b01d137e380cb0e8fdcb39a254ce31aa2ab95bc861ac/jiter-0.17.0-cp315-cp315t-win32.whl", hash = "sha256:86d703d9faa1ffc8ae4e9de0fa007712ed2171b5c0d93811a8e2e105ac729b0d", size = 184603, upload-time = "2026-09-12T15:13:59.27Z" },
+ { url = "https://files.pythonhosted.org/packages/f9/f2/b8ee0372b6ebdf1bde5cc44495d5291d17f961065f5b48f8616cc67cac2e/jiter-0.17.0-cp315-cp315t-win_amd64.whl", hash = "sha256:42b0260445251b1bc520a63baa94a32d88e0f931fba234f1764db7feb7c72174", size = 227936, upload-time = "2026-09-12T15:14:00.472Z" },
+ { url = "https://files.pythonhosted.org/packages/a4/b4/923a1215daba959aed8355973315cb3f81f53e0d01c5b211870a27b41f45/jiter-0.17.0-cp315-cp315t-win_arm64.whl", hash = "sha256:d47687806f9c54c84ea38733507081337922beca90ce819c7d852dd485bc0f23", size = 182977, upload-time = "2026-09-12T15:14:01.799Z" },
+ { url = "https://files.pythonhosted.org/packages/b9/3b/05a917204413e2e09906dfa35240c1021227aeb56c7305abea9562c598b4/jiter-0.17.0-graalpy311-graalpy242_311_native-macosx_10_12_x86_64.whl", hash = "sha256:eaba834b72d573547b9d966465b3394b749d5e14208cc70acb63aca37619ab33", size = 288143, upload-time = "2026-09-12T15:14:02.998Z" },
+ { url = "https://files.pythonhosted.org/packages/d9/e1/a1cd3c0cf8f79945939e4f8caae9990529f67d7f77f671769f73956329b9/jiter-0.17.0-graalpy311-graalpy242_311_native-macosx_11_0_arm64.whl", hash = "sha256:51e1519d676a9f14dad9c2a411170d43b022ddb7989562df4e849b261ce127b2", size = 281847, upload-time = "2026-09-12T15:14:04.414Z" },
+ { url = "https://files.pythonhosted.org/packages/72/b4/9b797679e09f4a46c32986aeb3670bd9bc562fc0b373c7a0ee5c5dce1206/jiter-0.17.0-graalpy311-graalpy242_311_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d0ce4feb52493e3513335b2accdcd75605652e4632772d3c8c2f7b86954d7f39", size = 304797, upload-time = "2026-09-12T15:14:05.733Z" },
+ { url = "https://files.pythonhosted.org/packages/25/4a/0d77415b27a00d970e4e710f7c1de62e96a11c4cab3ed1add0015af04626/jiter-0.17.0-graalpy311-graalpy242_311_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:29f49b325e0234e4ad9ecca5b861ffbd09b95ccac9bd46fa55841b6e56eea5fe", size = 307815, upload-time = "2026-09-12T15:14:07.105Z" },
+ { url = "https://files.pythonhosted.org/packages/17/31/4bb27f54333d3b9ef1e5bd3312dc0b4bbe59c68bb0885fdb40583a6b1567/jiter-0.17.0-graalpy312-graalpy250_312_native-macosx_10_12_x86_64.whl", hash = "sha256:454c4997d73cc466c71fd565d91e603b0274e48ea0c6b0b7a7aee6967e4ceb7c", size = 288415, upload-time = "2026-09-12T15:14:08.455Z" },
+ { url = "https://files.pythonhosted.org/packages/28/30/879570ecf82574eaea77c5eb10309f4b630dece5f2a556e9814a90ba3f2d/jiter-0.17.0-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:40d2c240f8f80b5b0f201b29f0ae129c81448c60c772227a41747b5e0026f6a2", size = 279113, upload-time = "2026-09-12T15:14:10.117Z" },
+ { url = "https://files.pythonhosted.org/packages/77/7a/1f0b8a35fbd079a4f1752c31a15dc99cf277f863747c459be0af39e900e5/jiter-0.17.0-graalpy312-graalpy250_312_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3e05f5adbf68c4bd11e1610f394034d984152988e84be6f8314235ce6f2139e5", size = 303708, upload-time = "2026-09-12T15:14:11.445Z" },
+ { url = "https://files.pythonhosted.org/packages/e1/8b/d76219ebdbcf3d4209d9d21a0810db4c8d0a6f88e3ee87d30bdea4e90d30/jiter-0.17.0-graalpy312-graalpy250_312_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:d2c0bf24c72fd0491405dce5d40194f2070e9021ce648c1a1d46234b93d848ff", size = 307147, upload-time = "2026-09-12T15:14:12.897Z" },
+]
+
[[package]]
name = "jsonschema"
version = "4.26.0"
@@ -1658,6 +1840,15 @@ wheels = [
{ url = "https://files.pythonhosted.org/packages/b7/ce/149a00dd41f10bc29e5921b496af8b574d8413afcd5e30dfa0ed46c2cc5e/six-1.17.0-py2.py3-none-any.whl", hash = "sha256:4721f391ed90541fddacab5acf947aa0d3dc7d27b2e1e8eda2be8970586c3274", size = 11050, upload-time = "2024-12-04T17:35:26.475Z" },
]
+[[package]]
+name = "sniffio"
+version = "1.3.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/a2/87/a6771e1546d97e7e041b6ae58d80074f81b7d5121207425c964ddf5cfdbd/sniffio-1.3.1.tar.gz", hash = "sha256:f4324edc670a0f49750a81b895f35c3adb843cca46f0530f79fc1babb23789dc", size = 20372, upload-time = "2024-02-25T23:20:04.057Z" }
+wheels = [
+ { url = "https://files.pythonhosted.org/packages/e9/44/75a9c9421471a6c4805dbf2356f7c181a29c1879239abab1ea2cc8f38b40/sniffio-1.3.1-py3-none-any.whl", hash = "sha256:2f6da418d1f1e0fddd844478f41680e794e6051915791a034ff65e5f100525a2", size = 10235, upload-time = "2024-02-25T23:20:01.196Z" },
+]
+
[[package]]
name = "specklepy"
version = "3.2.8"
@@ -1703,6 +1894,15 @@ wheels = [
{ url = "https://files.pythonhosted.org/packages/1c/54/196d0c1db10af76baa4f64894448505d60d3cdf70ef92cbb35f46a4e4c71/starlette-1.2.1-py3-none-any.whl", hash = "sha256:4de0082d08c8f6764a85a54cf1120d6939507a19905c7768acad2a9f875d2b89", size = 73350, upload-time = "2026-05-31T01:07:50.09Z" },
]
+[[package]]
+name = "truststore"
+version = "0.10.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/53/a3/1585216310e344e8102c22482f6060c7a6ea0322b63e026372e6dcefcfd6/truststore-0.10.4.tar.gz", hash = "sha256:9d91bd436463ad5e4ee4aba766628dd6cd7010cf3e2461756b3303710eebc301", size = 26169, upload-time = "2025-08-12T18:49:02.73Z" }
+wheels = [
+ { url = "https://files.pythonhosted.org/packages/19/97/56608b2249fe206a67cd573bc93cd9896e1efb9e98bce9c163bcdc704b88/truststore-0.10.4-py3-none-any.whl", hash = "sha256:adaeaecf1cbb5f4de3b1959b42d41f6fab57b2b1666adb59e89cb0b53361d981", size = 18660, upload-time = "2025-08-12T18:49:01.46Z" },
+]
+
[[package]]
name = "typing-extensions"
version = "4.15.0"
diff --git a/server.json b/server.json
index 51cc8dd..ad933cb 100644
--- a/server.json
+++ b/server.json
@@ -2,7 +2,7 @@
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"name": "io.github.Sam-AEC/aec-model-bridge",
"title": "AEC Model Bridge",
- "description": "Independent MCP integration for Autodesk Revit software through a local bridge.",
+ "description": "Revit MCP server: 200+ tools to read and edit BIM models, every change human-approved.",
"websiteUrl": "https://github.com/Sam-AEC/aec-model-bridge",
"icons": [
{
@@ -72,6 +72,37 @@
"isSecret": false,
"isRequired": false,
"format": "string"
+ },
+ {
+ "name": "MCP_REVIT_APPROVAL_MODE",
+ "description": "Approval gate for write tools. \"required\" (default) blocks every model change until a human approves a plan; do not relax this unless you understand the risk.",
+ "isSecret": false,
+ "isRequired": false,
+ "default": "required",
+ "format": "string"
+ },
+ {
+ "name": "MCP_REVIT_ENABLE_USER_MODULES",
+ "description": "Set to true to load user-written modules from the workspace. Off by default.",
+ "isSecret": false,
+ "isRequired": false,
+ "default": "false",
+ "format": "boolean"
+ },
+ {
+ "name": "MCP_REVIT_ALLOW_PYTHON_HOST",
+ "description": "Set to true to allow module commands that declare the python.host permission to run. Off by default.",
+ "isSecret": false,
+ "isRequired": false,
+ "default": "false",
+ "format": "boolean"
+ },
+ {
+ "name": "MCP_REVIT_ANTHROPIC_API_KEY",
+ "description": "Optional Anthropic API key, used only by the built-in agent chat in the Revit panel. Not needed for MCP use.",
+ "isSecret": true,
+ "isRequired": false,
+ "format": "string"
}
]
}
diff --git a/smithery.yaml b/smithery.yaml
new file mode 100644
index 0000000..f073a6e
--- /dev/null
+++ b/smithery.yaml
@@ -0,0 +1,32 @@
+# Smithery build/launch configuration. Runs the server from the root Dockerfile in
+# MOCK mode so Smithery can start it and list its tools without Autodesk Revit.
+# For real Revit use, install locally (see README) and run with MCP_REVIT_MODE=bridge.
+runtime: "container"
+build:
+ dockerfile: "Dockerfile"
+ dockerBuildPath: "."
+startCommand:
+ type: "stdio"
+ configSchema:
+ type: "object"
+ properties:
+ mode:
+ type: "string"
+ enum: ["mock", "bridge"]
+ default: "mock"
+ description: "mock returns canned responses (no Revit needed); bridge talks to the AEC Model Bridge add-in inside a running Revit."
+ bridgeUrl:
+ type: "string"
+ default: "http://127.0.0.1:3000"
+ description: "Add-in URL, only used when mode is bridge."
+ commandFunction: |-
+ (config) => ({
+ command: "aec-model-bridge",
+ args: [],
+ env: {
+ MCP_REVIT_MODE: config.mode || "mock",
+ MCP_REVIT_BRIDGE_URL: config.bridgeUrl || "http://127.0.0.1:3000",
+ MCP_REVIT_WORKSPACE_DIR: "/workspace",
+ MCP_REVIT_ALLOWED_DIRECTORIES: "/workspace"
+ }
+ })