SkillFoxx

AEC Model Bridge MCP

A Revit MCP server with an add-in: the agent reads the open BIM model and drafts edits that apply after a person approves.

  • 124 ★ on the repository
  • Last commit
  • GPL-3.0
MCP server

Extended access

Why this level

  • The agent sees the open model, and an applied plan changes it.
  • `MCP_REVIT_APPROVAL_MODE=auto` switches off human approval.
All reasons and checks

sam-aec/aec-model-bridgeAuthor:Sam-AEC

Install

Manual install

{
  "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": "mock"
      }
    }
  }
}

Fragment from Manual setup, set to mock mode for a check without Revit; switch to `bridge` for live work. `uv` is required.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The agent sees the open model, and an applied plan changes it.
  • `MCP_REVIT_APPROVAL_MODE=auto` switches off human approval.

This is third-party code. Review the repository files before installing.

What it does

AEC Model Bridge has two parts: a Python MCP server and an add-in for Revit 2024 to 2027. Read tools answer about the model at once: active document, warnings, elements by type, parameters. For edits the agent drafts a plan, a person reviews it in the Revit panel or with the `aec-model-bridge-approve` command, and only then does the add-in run each action in its own transaction. The same server reads IFC files, drives Rhino and Grasshopper and connects to Speckle. Without Revit the mock mode returns the tool list and generated sample data, and the model stays untouched.

Who it is for. BIM coordinators and managers who want an AI assistant for model quality checks and parameter fixes without writing scripts.

Good fit when

  • A coordinator asks for walls on Level 02 and their `Comments` values.
  • After a warnings review you need the list of affected elements.
  • A batch parameter change should be viewed as a plan and approved first.
  • A sheet list from CSV becomes project sheets.
  • Before connecting to a live project the tools are tried in mock mode.

Not a fit when

  • There is no licensed Revit 2024 to 2027 on Windows: live mode does not work without it.
  • Edits must run with nobody approving them in a production project.
  • You need a build verified on a real model: the author marks Revit behavior as unverified.

Example request

Show the active Revit document and its warnings, find the affected elements and draft a plan to change the `Comments` parameter.

MCP

Transport
stdio
Authentication
not required

Environment variables

MCP_REVIT_MODE
`mock` for a check without Revit or `bridge` for a live model
MCP_REVIT_WORKSPACE_DIR
Server workspace folder; `~/Documents/AEC Model Bridge` by default
MCP_REVIT_ALLOWED_DIRECTORIES
Folders the server may access
MCP_REVIT_APPROVAL_MODE
The `auto` value disables human approval; for controlled pipelines only

Limitations

Live mode needs Windows, a licensed Revit 2024 to 2027, Python 3.11 or newer, `uv` and the installed add-in. The author states that the dev branch is unreleased and Revit behavior is not yet confirmed in a live session: try it on a project copy. `MCP_REVIT_APPROVAL_MODE=auto` switches off human approval and belongs only in controlled pipelines. The license is GPL-3.0 plus commercial.

How to disable. Remove the `aec-model-bridge` entry from the client configuration, uninstall the Revit add-in the usual way and clear the `~/Documents/AEC Model Bridge` workspace.

FAQ

Can I try it without Revit?

Yes. With `MCP_REVIT_MODE=mock` the server starts on any machine, lists every tool with its schema and returns generated answers. Your model is not touched.

Who approves changes?

Only a person: in the Revit panel or with the `aec-model-bridge-approve` command. Approving and rolling back plans is not offered to AI clients over MCP.

How do I undo an applied action?

Each action runs in its own Revit transaction, so `Ctrl+Z` undoes one action per press. A `rollback_plan` tool exists too and itself needs approval.

Which clients are documented?

Claude Desktop, VS Code with GitHub Copilot, Cursor and Codex. Others such as Claude Code, Windsurf, Cline and Gemini CLI should work as ordinary MCP stdio clients.

What else does it support?

The same server reads IFC files, drives Rhino and Grasshopper and connects to Speckle. The Other integrations section of the README says which providers are ready and which are in progress.

Discussion

No questions or reviews yet.

MCP servers

A Revit MCP for Revit 2022–2027: up to 233 tools to read the model, create elements, views, sheets and exports, all running locally

MCP serverBroad access126
Official

An MCP server and add-in for Autodesk Revit 2023–2027 with 125 tools for modeling, schedules and exports.

MCP serverBroad access85
Official

Hosted MCP server for the PartMode browser CAD that lets an agent edit parametric parts, assemblies and drawings

MCP serverExtended access453

An MCP server for IFC: an agent counts building elements, validates a model against IDS, finds clashes and edits properties

MCP serverBroad access472

A CAD MCP server for build123d: the agent builds a part step by step, checks renders, measures geometry and exports STEP and STL.

MCP serverExtended access151

A Cocos Creator 2.4.x plugin with a local server so an agent edits scenes, prefabs and assets and builds the project over MCP

MCP serverBroad access236

README in short

The server works together with a Revit add-in. Reads run at once, changes go through a plan a person approves, and the mock mode lets you explore the tools without Revit.

README badge

Report a problem