# mcp-servers-for-revit/mcp-server-for-revit-python architecture

> Architecture diagram of the GitHub repository mcp-servers-for-revit/mcp-server-for-revit-python, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mcp-servers-for-revit/mcp-server-for-revit-python
- Repository: https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python

## Overview

Revit MCP is a local two-process bridge: an MCP server exposes tools to an LLM client, forwards requests over loopback HTTP to pyRevit Routes inside Revit, and returns model data or images. The graph preserves documented model, view, family placement, visualization, code execution, document, status, launch, and pairing capabilities. Some tool-to-route mappings are not shown in the excerpts, so those relationships are represented only at the documented bridge boundary.

Main entry points: [`startup.py`](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/startup.py) (Route Registration), [`main.py`](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/main.py) (MCP Server), [`revit_mcp/pairing.py`](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/revit_mcp/pairing.py) (User Pairing), [`tools/registration.py`](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/tools/registration.py) (Tool Registration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["MCP Client Layer"]
  node_llm(("LLM Client"))
end

subgraph group_mcp["MCP Server"]
  node_mcp_server["MCP Server<br/>[main.py]"]
  node_tool_registry["Tool Registration<br/>[registration.py]"]
  node_catalog["Tool Catalog<br/>[catalog.py]"]
  node_launch["Launch and Discovery<br/>[launch_tools.py]"]
  node_document_tools["Document Tools<br/>[document_tools.py]"]
  node_model_tools["Model Tools<br/>[model_tools.py]"]
  node_view_tools["View Tools<br/>[view_tools.py]"]
  node_family_tools["Family Tools<br/>[family_tools.py]"]
  node_colors_tools["Color Tools<br/>[colors_tools.py]"]
  node_execution_tools["Code Execution Tools"]
end

subgraph group_security["Pairing and Security"]
  node_pairing[("User Pairing<br/>[pairing.py]")]
  node_http_security["HTTP Pairing Guard<br/>[http_security.py]"]
  node_route_security["Route Authorization<br/>[security.py]"]
end

subgraph group_routes["Revit Routes"]
  node_route_registry["Route Registration<br/>[startup.py]"]
  node_status["Status Routes<br/>[status.py]"]
  node_model_info["Model Information<br/>[model_info.py]"]
  node_views["View Export and Info<br/>[views.py]"]
  node_placement["Family Placement<br/>[placement.py]"]
  node_colors["Element Visualization<br/>[colors.py]"]
  node_execution["Revit Code Execution<br/>[code_execution.py]"]
  node_documents["Document Lifecycle<br/>[document.py]"]
end

subgraph group_revit["Revit Operations"]
  node_revit_app["Revit Application"]
end

node_llm -->|"calls tools"| node_mcp_server
node_mcp_server -->|"registers tools"| node_tool_registry
node_tool_registry -->|"loads catalog"| node_catalog
node_mcp_server -->|"gets bearer token"| node_pairing
node_mcp_server -->|"guards HTTP"| node_http_security
node_http_security -->|"validates token"| node_pairing
node_mcp_server -->|"sends loopback HTTP"| node_route_registry
node_route_registry -->|"registers routes"| node_status
node_route_registry -->|"registers routes"| node_model_info
node_route_registry -->|"registers routes"| node_views
node_route_registry -->|"registers routes"| node_placement
node_route_registry -->|"registers routes"| node_colors
node_route_registry -->|"registers routes"| node_execution
node_route_registry -->|"registers routes"| node_documents
node_route_security -->|"validates requests"| node_pairing
node_colors_tools -->|"posts tool request"| node_mcp_server
node_document_tools -->|"posts tool request"| node_mcp_server
node_launch -->|"polls readiness"| node_mcp_server
node_mcp_server -->|"routes tool requests"| node_route_registry
node_route_registry -->|"executes API operations"| node_revit_app

click node_mcp_server "https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/main.py"
click node_tool_registry "https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/tools/registration.py"
click node_catalog "https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/tools/catalog.py"
click node_launch "https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/tools/launch_tools.py"
click node_document_tools "https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/tools/document_tools.py"
click node_model_tools "https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/tools/model_tools.py"
click node_view_tools "https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/tools/view_tools.py"
click node_family_tools "https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/tools/family_tools.py"
click node_colors_tools "https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/tools/colors_tools.py"
click node_execution_tools "https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/tools/code_execution_tools.py"
click node_pairing "https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/revit_mcp/pairing.py"
click node_http_security "https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/tools/http_security.py"
click node_route_security "https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/revit_mcp/security.py"
click node_route_registry "https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/startup.py"
click node_status "https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/revit_mcp/status.py"
click node_model_info "https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/revit_mcp/model_info.py"
click node_views "https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/revit_mcp/views.py"
click node_placement "https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/revit_mcp/placement.py"
click node_colors "https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/revit_mcp/colors.py"
click node_execution "https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/revit_mcp/code_execution.py"
click node_documents "https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/revit_mcp/document.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_llm toneBlue
class node_mcp_server,node_tool_registry,node_catalog,node_launch,node_document_tools,node_model_tools,node_view_tools,node_family_tools,node_colors_tools,node_execution_tools toneAmber
class node_pairing,node_http_security,node_route_security toneMint
class node_route_registry,node_status,node_model_info,node_views,node_placement,node_colors,node_execution,node_documents toneRose
class node_revit_app toneIndigo
```

## Components

### MCP Client Layer

- **LLM Client**

### MCP Server

- [MCP Server](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/main.py): `main.py`
- [Tool Registration](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/tools/registration.py): `tools/registration.py`
- [Tool Catalog](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/tools/catalog.py): `tools/catalog.py`
- [Launch and Discovery](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/tools/launch_tools.py): `tools/launch_tools.py`
- [Document Tools](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/tools/document_tools.py): `tools/document_tools.py`
- [Model Tools](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/tools/model_tools.py): `tools/model_tools.py`
- [View Tools](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/tools/view_tools.py): `tools/view_tools.py`
- [Family Tools](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/tools/family_tools.py): `tools/family_tools.py`
- [Color Tools](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/tools/colors_tools.py): `tools/colors_tools.py`
- [Code Execution Tools](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/tools/code_execution_tools.py): `tools/code_execution_tools.py`

### Pairing and Security

- [User Pairing](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/revit_mcp/pairing.py): `revit_mcp/pairing.py`
- [HTTP Pairing Guard](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/tools/http_security.py): `tools/http_security.py`
- [Route Authorization](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/revit_mcp/security.py): `revit_mcp/security.py`

### Revit Routes

- [Route Registration](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/startup.py): `startup.py`
- [Status Routes](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/revit_mcp/status.py): `revit_mcp/status.py`
- [Model Information](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/revit_mcp/model_info.py): `revit_mcp/model_info.py`
- [View Export and Info](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/revit_mcp/views.py): `revit_mcp/views.py`
- [Family Placement](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/revit_mcp/placement.py): `revit_mcp/placement.py`
- [Element Visualization](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/revit_mcp/colors.py): `revit_mcp/colors.py`
- [Revit Code Execution](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/revit_mcp/code_execution.py): `revit_mcp/code_execution.py`
- [Document Lifecycle](https://github.com/mcp-servers-for-revit/mcp-server-for-revit-python/blob/master/revit_mcp/document.py): `revit_mcp/document.py`

### Revit Operations

- **Revit Application**

## Connections

- LLM Client → MCP Server: calls tools (evidence: `README.md`)
- MCP Server → Tool Registration: registers tools (evidence: `main.py`)
- Tool Registration → Tool Catalog: loads catalog (evidence: `tools/registration.py`)
- MCP Server → User Pairing: gets bearer token (evidence: `main.py`)
- MCP Server → HTTP Pairing Guard: guards HTTP (evidence: `main.py`)
- HTTP Pairing Guard → User Pairing: validates token (evidence: `tools/http_security.py`)
- MCP Server → Route Registration: sends loopback HTTP (evidence: `README.md`)
- Route Registration → Status Routes: registers routes (evidence: `startup.py`)
- Route Registration → Model Information: registers routes (evidence: `startup.py`)
- Route Registration → View Export and Info: registers routes (evidence: `startup.py`)
- Route Registration → Family Placement: registers routes (evidence: `startup.py`)
- Route Registration → Element Visualization: registers routes (evidence: `startup.py`)
- Route Registration → Revit Code Execution: registers routes (evidence: `startup.py`)
- Route Registration → Document Lifecycle: registers routes (evidence: `startup.py`)
- Route Authorization → User Pairing: validates requests (evidence: `revit_mcp/security.py`)
- Color Tools → MCP Server: posts tool request (evidence: `tools/colors_tools.py`)
- Document Tools → MCP Server: posts tool request (evidence: `tools/document_tools.py`)
- Launch and Discovery → MCP Server: polls readiness (evidence: `tools/launch_tools.py`)
- MCP Server → Route Registration: routes tool requests (evidence: `README.md`)
- Route Registration → Revit Application: executes API operations (evidence: `README.md`)
