mcpField
S
scanbim

scanbim

Remote
github.com/ScanBIM-LabsMedia & Design6Updated 27w ago
Repository

About scanbim

scanbim is an MCP server for AEC teams and AI agents to work with BIM models, Autodesk Construction Cloud, Revit, and related tools. It combines model conversion and viewing with coordination, project management, and visualization operations.

Key features

  1. 01Upload and convert 3D models
  2. 02Extract Revit elements and schedules
  3. 03Detect clashes with VDC rules
  4. 04Manage ACC issues, RFIs, and documents
  5. 05Create viewer links and XR sessions
  6. 06Render images and walkthroughs

Use cases

  1. 01Inspect and share translated BIM models
  2. 02Review model clashes during coordination
  3. 03Track project issues and RFIs in ACC
  4. 04Generate architectural renders and walkthroughs

MCP support

Exposes AEC tools through an MCP JSON-RPC endpoint for compatible clients. The tools cover model operations, Revit, ACC, Navisworks, Twinmotion, and visualization.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://mcp.scanbimlabs.io/unified
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

All endpoints
Streamable HTTPhttps://mcp.scanbimlabs.io/unifiedAuth required

Tools

Details

From the project README

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.