mcpField
S
scanbim-mcp

scanbim-mcp

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

About scanbim-mcp

scanbim-mcp is a BIM tool suite for architecture, engineering, and construction teams, connecting workflows across Revit, Navisworks, ACC, and visualization. Its tools cover model handling, clash analysis, project coordination, and XR viewing, using Autodesk Platform Services API calls.

Key features

  1. 01Upload and convert multiple BIM formats
  2. 02Extract Revit elements, parameters, and schedules
  3. 03Run clash detection and create coordination reports
  4. 04Manage ACC issues, RFIs, and documents
  5. 05Generate renders and XR viewing sessions

Use cases

  1. 01Check BIM models for clashes
  2. 02Extract element and schedule data from Revit
  3. 03Create issues or RFIs in ACC
  4. 04Generate model viewer links or XR sessions

MCP support

It exposes an MCP JSON-RPC endpoint at `/mcp`, with tools for models, Revit, ACC, Navisworks, rendering, and XR.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "app-scanbim-scanbim": {
      "command": "npx",
      "args": [
        "-y",
        "@scanbim-labs/scanbim-mcp"
      ]
    }
  }
}
Run commandnpx -y @scanbim-labs/scanbim-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@scanbim-labs/scanbim-mcp1.0.6

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

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.