Odel
scanbim mcp

scanbim mcp

@scanbim-labsIntegrations5JavaScriptUpdated 2mo ago

AI Hub for AEC — 46 tools for Revit, Navisworks, ACC, XR via Autodesk Platform Services

ScanBIM MCP — The AI Hub for AEC

Live

MCP

Tools

APS

License: MIT

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.


Ecosystem (5 Workers, 46 Tools)

| 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.


scanbim-mcp Tools (19)

| 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 |

revit-mcp Tools (8)

| 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 |

acc-mcp Tools (9)

| 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 |

navisworks-mcp Tools (5)

| 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 |

twinmotion-mcp Tools (5)

| 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


# Health check

curl https://scanbim-mcp.itmartin24.workers.dev/health



# List tools

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



# View a model

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)

Supported Formats (50+)

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:

  1. x-scanbim-api-key: <your_user_key> — value is the user_key verbatim.
  2. 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.