How mcp-servers-for-revit/mcp-server-for-revit-python works
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 Route Registration · main.py MCP Server · pairing.py User Pairing · registration.py Tool Registration
Components 23
MCP Client Layer
- LLM Client
MCP Server
- MCP Server
main.py - Tool Registration
tools/registration.py - Tool Catalog
tools/catalog.py - Launch and Discovery
tools/launch_tools.py - Document Tools
tools/document_tools.py - Model Tools
tools/model_tools.py - View Tools
tools/view_tools.py - Family Tools
tools/family_tools.py - Color Tools
tools/colors_tools.py - Code Execution Tools
tools/code_execution_tools.py
Pairing and Security
- User Pairing
revit_mcp/pairing.py - HTTP Pairing Guard
tools/http_security.py - Route Authorization
revit_mcp/security.py
Revit Routes
- Route Registration
startup.py - Status Routes
revit_mcp/status.py - Model Information
revit_mcp/model_info.py - View Export and Info
revit_mcp/views.py - Family Placement
revit_mcp/placement.py - Element Visualization
revit_mcp/colors.py - Revit Code Execution
revit_mcp/code_execution.py - Document Lifecycle
revit_mcp/document.py
Revit Operations
- Revit Application
Connections 20
- LLM Client → MCP Server: calls tools
README.md - MCP Server → Tool Registration: registers tools
main.py - Tool Registration → Tool Catalog: loads catalog
tools/registration.py - MCP Server → User Pairing: gets bearer token
main.py - MCP Server → HTTP Pairing Guard: guards HTTP
main.py - HTTP Pairing Guard → User Pairing: validates token
tools/http_security.py - MCP Server → Route Registration: sends loopback HTTP
README.md - Route Registration → Status Routes: registers routes
startup.py - Route Registration → Model Information: registers routes
startup.py - Route Registration → View Export and Info: registers routes
startup.py - Route Registration → Family Placement: registers routes
startup.py - Route Registration → Element Visualization: registers routes
startup.py - Route Registration → Revit Code Execution: registers routes
startup.py - Route Registration → Document Lifecycle: registers routes
startup.py - Route Authorization → User Pairing: validates requests
revit_mcp/security.py - Color Tools → MCP Server: posts tool request
tools/colors_tools.py - Document Tools → MCP Server: posts tool request
tools/document_tools.py - Launch and Discovery → MCP Server: polls readiness
tools/launch_tools.py - MCP Server → Route Registration: routes tool requests
README.md - Route Registration → Revit Application: executes API operations
README.md