ScanBIM MCP — The AI Hub for AEC
Give Claude, ChatGPT, and any AI agent the ability to upload, convert, view, analyze, and share BIM models across 50+ formats.
Upload a .rvt file. Get back a shareable 3D viewer link with QR code. Run clash detection with 20 years of VDC intelligence. Create RFIs. Launch VR walkthroughs. No software install needed.
| Worker | Version | Tools | Endpoint | Description |
|--------|---------|-------|----------|-------------|
| scanbim-mcp | v1.0.5 | 19 | /mcp | Core hub — models, clashes, ACC, XR, viewer, rendering |
| revit-mcp | v1.1.0 | 8 | /mcp | Revit — elements, parameters, schedules, sheets, IFC export |
| acc-mcp | v1.0.1 | 9 | /mcp | ACC/BIM 360 — issues, RFIs, documents, project summaries |
| navisworks-mcp | v1.1.0 | 5 | /mcp | Navisworks — clash detection, coordination, viewpoints |
| twinmotion-mcp | v1.1.0 | 5 | /mcp | Visualization — renders, environments, video, scenes |
All 46 tools make real Autodesk Platform Services API calls. Zero stubs. Verified April 12, 2026.
| Tool | Description |
|------|-------------|
| upload_model | Upload 3D models (Revit, IFC, point clouds, 50+ formats) via APS OSS + SVF2 translation |
| detect_clashes | VDC-grade clash detection with D1 rules database (SMACNA, NEC, ACI 318) |
| get_viewer_link | Generate APS Viewer URL + QR code for any translated model |
| list_models | List all uploaded models in APS buckets |
| get_model_metadata | Get APS translation status, manifest, and metadata |
| get_supported_formats | List supported file formats by tier (free/pro/enterprise) |
| acc_list_projects | List ACC/BIM 360 hubs and projects |
| acc_create_issue | Create ACC issues with priority, assignment, due dates |
| acc_list_issues | List/filter ACC issues by status and priority |
| acc_create_rfi | Create ACC RFIs |
| acc_list_rfis | List/filter ACC RFIs |
| acc_search_documents | Search ACC project documents by keyword |
| acc_project_summary | Get project overview with issue/RFI counts |
| xr_launch_vr_session | Launch VR viewing session (Meta Quest 2/3/3S) |
| xr_launch_ar_session | Launch AR overlay session |
| xr_list_sessions | List active XR sessions |
| twinmotion_render | Generate photorealistic renders via APS |
| twinmotion_walkthrough | Create animated walkthrough sequences |
| lumion_render | Architectural visualization rendering |
| Tool | Description |
|------|-------------|
| revit_upload | Upload .rvt files to APS with SVF2 translation |
| revit_get_elements | Extract elements by category (walls, doors, windows, etc.) |
| revit_get_parameters | Get element parameters with parameter group extraction |
| revit_run_schedule | Extract tabular schedule data from model properties |
| revit_clash_detect | Bounding box overlap + level proximity + D1 VDC rules |
| revit_export_ifc | Model Derivative IFC translation job |
| revit_get_sheets | List 2D views + sheet enumeration |
| revit_get_views | List all metadata views with detail levels |
| Tool | Description |
|------|-------------|
| acc_list_projects | List all ACC/BIM 360 hubs and projects |
| acc_create_issue | Create quality/safety issues |
| acc_update_issue | Update issue status, priority, assignment |
| acc_list_issues | List/filter issues by status and priority |
| acc_create_rfi | Create RFIs with assignment and priority |
| acc_list_rfis | List/filter RFIs |
| acc_search_documents | Full-text document search across projects |
| acc_upload_file | Upload files via APS Data Management (4-step flow) |
| acc_project_summary | Project dashboard with hub/project/issue/RFI counts |
| Tool | Description |
|------|-------------|
| nwd_upload | Upload .nwd/.nwc files with SVF2 translation |
| nwd_get_clashes | Cross-category clash analysis with level proximity + D1 VDC rules |
| nwd_export_report | Generate coordination report with category breakdown |
| nwd_get_viewpoints | Extract saved viewpoints and camera positions |
| nwd_list_objects | Property-based object listing with keyword filter |
| Tool | Description |
|------|-------------|
| tm_import_rvt | Import .rvt via APS with SVF2 + thumbnail translation |
| tm_set_environment | Configure environment settings (time, weather, season) |
| tm_render_image | APS thumbnail rendering with resolution control |
| tm_export_video | OBJ derivative for offline rendering pipeline |
| tm_list_scenes | Enumerate scenes from metadata views + object tree |
Endpoints (scanbim-mcp)
| Path | Method | Description |
|------|--------|-------------|
| /mcp | POST | MCP JSON-RPC 2.0 endpoint (initialize, tools/list, tools/call, ping) |
| /info | GET | Server info, version, tool count, APS connection status |
| /health | GET | Health check with APS configuration status |
| /token | GET | APS access token (viewables:read scope) for Viewer JS integration |
| /viewer?urn=XXX | GET | Built-in APS Viewer JS v7 — load any translated model in-browser |
Quick Start
Use the hosted MCP (Recommended)
Add to your Claude Desktop config:
{
"mcpServers": {
"scanbim": {
"url": "https://scanbim-mcp.itmartin24.workers.dev/mcp"
},
"revit": {
"url": "https://revit-mcp.itmartin24.workers.dev/mcp"
},
"acc": {
"url": "https://acc-mcp.itmartin24.workers.dev/mcp"
},
"navisworks": {
"url": "https://navisworks-mcp.itmartin24.workers.dev/mcp"
},
"twinmotion": {
"url": "https://twinmotion-mcp.itmartin24.workers.dev/mcp"
}
}
}
curl
curl https://scanbim-mcp.itmartin24.workers.dev/health
curl -X POST https://scanbim-mcp.itmartin24.workers.dev/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
open "https://scanbim-mcp.itmartin24.workers.dev/viewer?urn=YOUR_BASE64_URN"
Deploy your own
git clone https://github.com/ScanBIM-Labs/scanbim-mcp.git
cd scanbim-mcp
npm install
npx wrangler secret put APS_CLIENT_ID
npx wrangler secret put APS_CLIENT_SECRET
npx wrangler deploy
Architecture
Claude / ChatGPT / Any AI Agent
| MCP Protocol (JSON-RPC 2.0)
v
Cloudflare Workers (5 workers, edge compute, <50ms global)
|-- scanbim-mcp (19 tools + /viewer + /token)
|-- revit-mcp (8 tools)
|-- acc-mcp (9 tools)
|-- navisworks-mcp (5 tools)
|-- twinmotion-mcp (5 tools)
|
|-- D1 Database (VDC rules, clash severity, coordination standards)
|-- KV Namespace (APS token caching with TTL)
|
v
Autodesk Platform Services (APS)
|-- Authentication v2 (2-legged client credentials)
|-- Model Derivative v2 (SVF2 translation, metadata, properties)
|-- Object Storage Service (file upload, bucket management)
|-- ACC Issues/RFIs API
|-- APS Viewer JS v7 (browser-based 3D rendering)
|
v
scanbim.app (Cloudflare Pages) + APS Viewer (/viewer route)
Free: IFC, glTF/GLB, OBJ, STL, PLY, E57, LAS/LAZ, DXF, DAE, 3DS, 3MF
Pro ($49/mo): + FBX, DWG, STEP/STP, IGES, SketchUp (.skp), DWF, SolidWorks (.sldprt/.sldasm), Inventor (.ipt/.iam), OSGB
Enterprise ($149/mo): + Revit (.rvt/.rfa), Navisworks (.nwd/.nwc), ReCap (.rcp/.rcs), PCD, PTS, FLS, PTX, PTG, ZFS, 3MX + 500M point clouds + ACC integration
VDC Intelligence Engine
Clash detection powered by 20 years of field experience encoded into D1-backed rules:
-
9 severity rules — SMACNA, NEC, ACI 318, AISC, ASCE 7 standards
-
5 coordination standards — MEP clearance, structural proximity
-
Fix suggestions — Real construction advice, not generic "move element"
-
Rework estimation — Hours-to-fix based on actual project data
Links
License
MIT — Free for commercial use.
ScanBIM Labs — VDC + AI + Reality Capture
20 years of BIM/VDC operations, now AI-native. Built by a VDC practitioner, not a dev shop.
Authentication
Two accepted header formats. Use one, do NOT mix:
x-scanbim-api-key: <your_user_key> — value is the user_key verbatim.Authorization: Bearer sk_scanbim_<your_user_key> — value is the entire string including the sk_scanbim_ prefix; the D1 user_key column must match this full string.
Mixing formats auto-creates a fresh free-plan row for the alternate key (you'll silently get a new 50-credit account on each switch).
Get your user_key at scanbim.app/settings/billing.
Example
curl -X POST https://mcp.scanbimlabs.io/unified/mcp \
-H "content-type: application/json" \
-H "x-scanbim-api-key: $SCANBIM_USER_KEY" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_models","arguments":{}}}'
Response codes
200 — tool call proceeded; credits debited.401 — missing or malformed auth header (middleware returns JSON-RPC error code -32001).402 — insufficient credits; response body includes checkout_urls for all 5 credit packs and top_up_url for the billing page.