이 MCP로 할 수 있는 일
Uploads and analyzes BIM and 3D models, supports Autodesk Construction Cloud project workflows, detects clashes, and provides viewer, rendering, and XR links.
기능
도구
19
도구
acc_create_issue
Create a real issue (punchlist/QC item) in ACC Build's Issues module via the APS Construction Issues v1 API. Returns the ACC-generated issue_id which can be linked back to a model URN or a detected clash.
When to use: detect_clashes flagged a critical clash, or a field user reports a QC defect, and you want to track it in ACC for assignment and closeout.
When NOT to use: you want to file a formal information request between trades — use acc_create_rfi instead. You want a note on a model element — that is a markup, not an issue.
APS scopes: data:read data:write account:read
Rate limits: APS default ~50 req/min per app per endpoint; Model Derivative translation jobs ~60 req/min; OSS uploads size-limited per file to 100MB for direct upload, larger via resumable.
Errors: 401 APS token expired/invalid — refresh; 403 scope or resource permission denied (app not provisioned for the project's ACC account); 404 project_id not found — check the ID (strip any leading 'b.'); 429 rate limited — backoff and retry; 5xx APS upstream outage — retry with jitter.
Side effects: NON-IDEMPOTENT. Creates a new ACC issue each call (repeated calls create duplicates). Inserts a row into D1 usage_log.
입력 스키마
{'type': 'object', 'required': ['project_id', 'title', 'description'], 'properties': {'title': {'type': 'string', 'examples': ['Duct/beam clash at Level 3 gridline C-4'], 'description': 'Short human-readable issue title, 1-255 chars. Shows up as the headline in ACC Issues UI.'}, 'due_date': {'type': 'string', 'examples': ['2026-05-15'], 'description': 'ISO 8601 calendar date (YYYY-MM-DD). Time component is ignored by ACC.'}, 'priority': {'enum': ['critical', 'high', 'medium', 'low'], 'type': 'string', 'examples': ['high'], 'description': "ACC issue priority. Defaults to 'medium' if omitted."}, 'project_id': {'type': 'string', 'examples': ['b.a4be0c34a-4a01-4b0e-9f1a-123456789abc'], 'description': "ACC project ID in either 'b.<uuid>' or plain '<uuid>' form (the worker strips the 'b.' prefix before calling the Issues endpoint). Obtainable via acc_list_projects."}, 'assigned_to': {'type': 'string', 'examples': ['jdoe@contractor.com'], 'description': 'ACC user ID (UUID) or email of the assignee. Pass null or omit to leave unassigned.'}, 'description': {'type': 'string', 'examples': ['16" supply duct (Mech-L3-SD-42) conflicts with W18x35 beam at elev 10\'-6". Reroute duct above beam per SMACNA, maintain 18" clearance.'], 'description': 'Long-form issue body. Plain text; supports newlines. Include clash coordinates, trade impact, and suggested fix.'}, 'linked_model_id': {'type': 'string', 'examples': ['dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6c2NhbmJpbS1tb2RlbHMvMTcwMDAwMDAwMDAwMF9idWlsZGluZy5ydnQ'], 'description': "Optional APS URN linking this issue back to the source model. Stored for ScanBIM cross-referencing; not forwarded to ACC's linkedDocuments field."}}}
acc_create_rfi
Create a Request For Information in ACC Build's RFIs module via the APS Construction RFIs v1 API, in 'draft' status. Returns the ACC rfi_id.
When to use: a trade or subcontractor needs formal information from the design team (unclear detail, conflicting spec, missing dimension) and you want a tracked paper trail.
When NOT to use: the item is just a punchlist fix — use acc_create_issue. The question is internal to one trade — handle inside that trade's toolchain.
APS scopes: data:read data:write account:read
Rate limits: APS default ~50 req/min per app per endpoint; Model Derivative translation jobs ~60 req/min; OSS uploads size-limited per file to 100MB for direct upload, larger via resumable.
Errors: 401 APS token expired/invalid — refresh; 403 scope or resource permission denied (app not provisioned for the project's ACC account, or RFIs module not enabled); 404 project_id not found — check the ID; 429 rate limited — backoff and retry; 5xx APS upstream outage — retry with jitter.
Side effects: NON-IDEMPOTENT. Creates a new draft RFI each call. Inserts a row into D1 usage_log.
입력 스키마
{'type': 'object', 'required': ['project_id', 'subject', 'question'], 'properties': {'subject': {'type': 'string', 'examples': ['Confirm fireproofing thickness on W18 beams at Level 3'], 'description': 'Short RFI subject line, 1-255 chars. Appears as the RFI headline in ACC.'}, 'priority': {'enum': ['critical', 'high', 'medium', 'low'], 'type': 'string', 'examples': ['high'], 'description': "RFI priority. Defaults to 'medium'."}, 'question': {'type': 'string', 'examples': ['Drawing S2.03 shows 1-hour rating on W18x35 beams but spec 07 81 00 calls for 2-hour. Which governs at Level 3?'], 'description': 'Full question body sent to the design team. Plain text with newlines allowed.'}, 'project_id': {'type': 'string', 'examples': ['b.a4be0c34a-4a01-4b0e-9f1a-123456789abc'], 'description': "ACC project ID in 'b.<uuid>' or '<uuid>' form (the 'b.' prefix is stripped automatically). Obtainable via acc_list_projects."}, 'assigned_to': {'type': 'string', 'examples': ['architect@designfirm.com'], 'description': 'ACC user ID (UUID) or email of the responder. Pass null or omit to leave unassigned.'}, 'linked_clash_id': {'type': 'string', 'examples': ['Ducts_001_Structural Framing_002'], 'description': 'Optional clash ID from detect_clashes output used to link this RFI back to the triggering clash. Stored for ScanBIM cross-referencing; not forwarded to ACC.'}, 'linked_model_id': {'type': 'string', 'examples': ['dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6c2NhbmJpbS1tb2RlbHMvMTcwMDAwMDAwMDAwMF9idWlsZGluZy5ydnQ'], 'description': 'Optional APS URN of the model the RFI references. Stored for ScanBIM cross-referencing; not forwarded to ACC.'}}}
acc_list_issues
List up to 50 issues from an ACC project, optionally filtered by status and priority. Returns a normalized array of {id, title, status, priority, due_date}.
When to use: you need a dashboard view of open issues, to find a specific issue by metadata, or to check the status of previously created issues.
When NOT to use: you want the full audit trail of a single issue — the ACC Issues UI or the per-issue endpoint is better. This tool caps at 50 results and does no pagination.
APS scopes: data:read account:read
Rate limits: APS default ~50 req/min per app per endpoint; Model Derivative translation jobs ~60 req/min; OSS uploads size-limited per file to 100MB for direct upload, larger via resumable.
Errors: 401 APS token expired/invalid — refresh; 403 scope or resource permission denied; 404 project_id not found — check the ID; 429 rate limited — backoff and retry; 5xx APS upstream outage — retry with jitter.
Side effects: READ-ONLY. Inserts a row into D1 usage_log. Idempotent.
입력 스키마
{'type': 'object', 'required': ['project_id'], 'properties': {'status': {'type': 'string', 'examples': ['open'], 'description': "Filter by ACC issue status. Accepted values: 'open', 'closed', 'in_review', 'draft'. Omit for all statuses."}, 'priority': {'type': 'string', 'examples': ['high'], 'description': "Filter by priority: 'critical' | 'high' | 'medium' | 'low'. Omit for all priorities."}, 'project_id': {'type': 'string', 'examples': ['b.a4be0c34a-4a01-4b0e-9f1a-123456789abc'], 'description': "ACC project ID in 'b.<uuid>' or '<uuid>' form (the 'b.' prefix is stripped automatically). Obtainable via acc_list_projects."}, 'assigned_to': {'type': 'string', 'examples': ['jdoe@contractor.com'], 'description': 'Reserved for future filtering by assignee user ID or email. Currently not forwarded to the ACC API.'}}}
acc_list_projects
List every Autodesk Construction Cloud (ACC) / BIM 360 project the configured APS 2-legged app has access to, flattened across all hubs, with hub_id, hub_name, project_id, project_name, and project type.
When to use: you need a project_id to pass into acc_create_issue, acc_list_issues, acc_create_rfi, acc_list_rfis, acc_search_documents, or acc_project_summary.
When NOT to use: you already have the b.xxxx project_id. This tool makes N+1 API calls (one per hub) so avoid calling it in tight loops.
APS scopes: data:read account:read
Rate limits: APS default ~50 req/min per app per endpoint; Model Derivative translation jobs ~60 req/min; OSS uploads size-limited per file to 100MB for direct upload, larger via resumable.
Errors: 401 APS token expired/invalid — refresh; 403 scope or resource permission denied (app not provisioned for any hub in ACC Account Admin → Custom Integrations); 404 no hubs found — check APS app provisioning; 429 rate limited — backoff and retry; 5xx APS upstream outage — retry with jitter.
Side effects: READ-ONLY. Inserts a row into D1 usage_log. Idempotent.
입력 스키마
{'type': 'object', 'properties': {}}
acc_list_rfis
List up to 50 RFIs from an ACC project, optionally filtered by status. Returns a normalized array of {id, subject, status}.
When to use: you need a quick rollup of outstanding or answered RFIs on a project, or to find a specific RFI id.
When NOT to use: you want the full response thread of a single RFI — use the ACC UI or per-RFI endpoint. This tool caps at 50 results and does no pagination.
APS scopes: data:read account:read
Rate limits: APS default ~50 req/min per app per endpoint; Model Derivative translation jobs ~60 req/min; OSS uploads size-limited per file to 100MB for direct upload, larger via resumable.
Errors: 401 APS token expired/invalid — refresh; 403 scope or resource permission denied (RFIs module may not be enabled on the project); 404 project_id not found — check the ID; 429 rate limited — backoff and retry; 5xx APS upstream outage — retry with jitter.
Side effects: READ-ONLY. Inserts a row into D1 usage_log. Idempotent.
입력 스키마
{'type': 'object', 'required': ['project_id'], 'properties': {'status': {'type': 'string', 'examples': ['open'], 'description': "Filter by RFI status. Common values: 'draft', 'open', 'answered', 'closed', 'void'. Omit for all."}, 'project_id': {'type': 'string', 'examples': ['b.a4be0c34a-4a01-4b0e-9f1a-123456789abc'], 'description': "ACC project ID in 'b.<uuid>' or '<uuid>' form (the 'b.' prefix is stripped automatically)."}}}
acc_project_summary
Fetch a single ACC/BIM 360 project's full attributes (name, type, dates, address, hub) from the APS Data Management project endpoint. If hub_id is omitted, the first hub the app can see is used.
When to use: you need name, type, or scope details for a single project before acting on it, or to confirm the project still exists.
When NOT to use: you want the list of all projects — call acc_list_projects. You want issues/RFIs counts — call the list tools.
APS scopes: data:read account:read
Rate limits: APS default ~50 req/min per app per endpoint; Model Derivative translation jobs ~60 req/min; OSS uploads size-limited per file to 100MB for direct upload, larger via resumable.
Errors: 401 APS token expired/invalid — refresh; 403 scope or resource permission denied; 404 project_id or hub_id not found — check the IDs; 429 rate limited — backoff and retry; 5xx APS upstream outage — retry with jitter.
Side effects: READ-ONLY. Inserts a row into D1 usage_log. Idempotent.
입력 스키마
{'type': 'object', 'required': ['project_id'], 'properties': {'hub_id': {'type': 'string', 'examples': ['b.11111111-2222-3333-4444-555555555555'], 'description': "Optional ACC hub_id (format 'b.<account-uuid>'). If omitted, the worker picks the first hub returned by /project/v1/hubs."}, 'project_id': {'type': 'string', 'examples': ['b.a4be0c34a-4a01-4b0e-9f1a-123456789abc'], 'description': "Full ACC project_id including the 'b.' prefix, exactly as returned by acc_list_projects. Unlike the Issues/RFIs tools, this tool passes the ID through unchanged to the Data Management project endpoint."}}}
acc_search_documents
Full-text search the ACC Docs module on a project for drawings, specs, submittals, and other documents matching a query string. Calls the APS Data Management v1 search endpoint scoped to a project.
When to use: an agent needs to locate a spec section, a sheet, or a submittal by keyword (e.g. 'fireproofing', 'A-101', 'RFI 23').
When NOT to use: you already have the document URN/lineage — fetch it directly. You want the file contents — this returns metadata; download separately via Data Management.
APS scopes: data:read account:read
Rate limits: APS default ~50 req/min per app per endpoint; Model Derivative translation jobs ~60 req/min; OSS uploads size-limited per file to 100MB for direct upload, larger via resumable.
Errors: 401 APS token expired/invalid — refresh; 403 scope or resource permission denied (Docs module access required); 404 project_id not found — check the ID (note: this endpoint re-prepends 'b.' so pass the UUID form); 429 rate limited — backoff and retry; 5xx APS upstream outage — retry with jitter.
Side effects: READ-ONLY. Inserts a row into D1 usage_log. Idempotent.
입력 스키마
{'type': 'object', 'required': ['project_id', 'query'], 'properties': {'query': {'type': 'string', 'examples': ['fireproofing detail'], 'description': 'Free-text search string. Matched against document names and attributes. URL-encoded automatically by the worker.'}, 'project_id': {'type': 'string', 'examples': ['b.a4be0c34a-4a01-4b0e-9f1a-123456789abc'], 'description': "ACC project ID in 'b.<uuid>' or '<uuid>' form (the 'b.' prefix is stripped and re-prepended automatically for the Data Management API)."}, 'document_type': {'type': 'string', 'examples': ['spec'], 'description': "Optional document type filter forwarded as filter[type]. Common values: 'drawing', 'spec', 'submittal', 'rfi', 'photo'."}}}
detect_clashes
Run a first-pass bounding-box clash check between two element categories in a translated model. Element boxes are read from the APS Model Derivative properties endpoint; ScanBIM never estimates or synthesises geometry. If the model returns no element boxes for a category, the tool returns status 'unavailable' with the element counts it did find and runs NO clash pass - treat that as no result, not as zero clashes. On a model that does carry boxes it returns each overlapping pair with a severity, a suggested fix and a rework-hour estimate. This is an axis-aligned box pass with no tolerance and no clearance rule, so it is a triage aid, not a substitute for a Navisworks or ACC Model Coordination run.
When to use: you want a first-pass coordination report between two MEP or structural trades (e.g. Ducts vs Structural Framing) for a model that has finished translating.
When NOT to use: the model has not finished translating yet (call get_model_metadata first to confirm manifest.status=='success'), or you need clash detection between more than two categories — call this tool multiple times.
APS scopes: data:read viewables:read
Rate limits: APS default ~50 req/min per app per endpoint; Model Derivative translation jobs ~60 req/min; OSS uploads size-limited per file to 100MB for direct upload, larger via resumable.
Errors: 401 APS token expired/invalid — refresh; 403 scope or resource permission denied; 404 URN not found or has no derivatives yet — check the ID; 429 rate limited — backoff and retry; 5xx APS upstream outage — retry with jitter.
Side effects: READ-ONLY on APS. Inserts a row into D1 usage_log for analytics. Idempotent — repeated calls return the same clash set for a given model.
입력 스키마
{'type': 'object', 'required': ['model_id', 'category_a', 'category_b'], 'properties': {'model_id': {'type': 'string', 'examples': ['dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6c2NhbmJpbS1tb2RlbHMvMTcwMDAwMDAwMDAwMF9idWlsZGluZy5ydnQ'], 'description': "APS URN returned by upload_model. Base64url-encoded Autodesk object ID starting with 'dXJu' (which decodes to 'urn:adsk.objects:os.object:...'). Unpadded."}, 'category_a': {'type': 'string', 'examples': ['Ducts'], 'description': "Revit/IFC category name (case-sensitive, exactly as it appears in the model properties). Common values: 'Ducts', 'Pipes', 'Electrical', 'Structural Framing', 'Structural Columns', 'Mechanical Equipment', 'Walls'."}, 'category_b': {'type': 'string', 'examples': ['Structural Framing'], 'description': "Second Revit/IFC category to clash against category_a. Case-sensitive; must match a category present in the translated model's property set."}}}
get_model_metadata
Fetch the APS Model Derivative manifest and metadata for a URN, including translation progress, derivative outputs, and a viewer URL. Use this to confirm a model has finished translating (manifest.status == 'success') before calling detect_clashes or opening the viewer.
When to use: right after upload_model to poll translation progress, or later to inspect which viewable derivatives (SVF2, thumbnail, OBJ) are available.
When NOT to use: you just want a link to share — call get_viewer_link. You want the actual element properties list — this tool returns the metadata index, not the full property collection.
APS scopes: data:read viewables:read
Rate limits: APS default ~50 req/min per app per endpoint; Model Derivative translation jobs ~60 req/min; OSS uploads size-limited per file to 100MB for direct upload, larger via resumable.
Errors: 401 APS token expired/invalid — refresh; 403 scope or resource permission denied; 404 URN not found or job not yet submitted — check the ID; 429 rate limited — backoff and retry; 5xx APS upstream outage — retry with jitter.
Side effects: READ-ONLY on APS. Inserts a row into D1 usage_log. Idempotent.
입력 스키마
{'type': 'object', 'required': ['model_id'], 'properties': {'model_id': {'type': 'string', 'examples': ['dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6c2NhbmJpbS1tb2RlbHMvMTcwMDAwMDAwMDAwMF9idWlsZGluZy5ydnQ'], 'description': "APS URN (base64url-encoded Autodesk object ID, starts with 'dXJu', unpadded) as returned by upload_model."}}}
get_supported_formats
Return the full matrix of supported input formats organized by subscription tier (free / pro / enterprise). Use to tell a user whether their file type is accepted before calling upload_model, or to surface pricing tier info.
When to use: you need to validate a file extension or show a customer the supported format list.
When NOT to use: you already know the extension is common (.rvt/.ifc/.nwd/.obj) — just call upload_model, which returns an 'Unsupported format' error for anything outside the matrix.
APS scopes: none (static data).
Rate limits: APS default ~50 req/min per app per endpoint; Model Derivative translation jobs ~60 req/min; OSS uploads size-limited per file to 100MB for direct upload, larger via resumable.
Errors: 401 APS token expired/invalid — refresh (not applicable: no APS call); 403 scope or resource permission denied (not applicable); 404 not applicable; 429 rate limited — backoff and retry (worker-level only); 5xx APS upstream outage — retry with jitter (not applicable).
Side effects: READ-ONLY and pure. Idempotent.
입력 스키마
{'type': 'object', 'properties': {}}
get_viewer_link
Return a shareable browser URL for the embedded APS viewer and a matching QR code for mobile/XR handoff. Does not require the model to be fully translated — the viewer page will poll the manifest.
When to use: you need to hand a stakeholder a URL to see the 3D model in a browser, or print a QR for a jobsite.
When NOT to use: you need the raw APS URN for programmatic API calls — use the model_id you already have instead. Do not use to check translation progress — call get_model_metadata.
APS scopes: none (URL assembly only); the viewer page itself uses viewables:read data:read server-side via /token.
Rate limits: APS default ~50 req/min per app per endpoint; Model Derivative translation jobs ~60 req/min; OSS uploads size-limited per file to 100MB for direct upload, larger via resumable.
Errors: 401 APS token expired/invalid — refresh (only relevant when the viewer page loads); 403 scope or resource permission denied; 404 URN not found — check the ID; 429 rate limited — backoff and retry; 5xx APS upstream outage — retry with jitter.
Side effects: READ-ONLY and pure. Idempotent: same model_id always returns the same URL + QR.
입력 스키마
{'type': 'object', 'required': ['model_id'], 'properties': {'model_id': {'type': 'string', 'examples': ['dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6c2NhbmJpbS1tb2RlbHMvMTcwMDAwMDAwMDAwMF9idWlsZGluZy5ydnQ'], 'description': "APS URN (base64url-encoded Autodesk object ID, starts with 'dXJu', unpadded) or the model_id returned from upload_model."}}}
list_models
List every object currently stored in the scanbim-models OSS bucket, with URN, size in MB, and a viewer URL for each. Returns the raw OSS inventory, not the D1 models table, so freshly uploaded items appear immediately.
When to use: you need to enumerate previously uploaded models to find a URN, show an inventory, or pick one for a follow-up tool call.
When NOT to use: you already know the exact URN — call get_model_metadata directly. This tool is not a search; it returns up to the OSS default page (typically first 10 objects unless OSS paginates).
APS scopes: bucket:read data:read
Rate limits: APS default ~50 req/min per app per endpoint; Model Derivative translation jobs ~60 req/min; OSS uploads size-limited per file to 100MB for direct upload, larger via resumable.
Errors: 401 APS token expired/invalid — refresh; 403 scope or resource permission denied; 404 bucket not found — no models have been uploaded yet (upload one first); 429 rate limited — backoff and retry; 5xx APS upstream outage — retry with jitter.
Side effects: READ-ONLY. Idempotent.
입력 스키마
{'type': 'object', 'properties': {'format': {'type': 'string', 'examples': ['rvt'], 'description': "Reserved for future filtering by file extension (e.g. 'rvt', 'ifc'). Currently informational only; the OSS listing is not filtered by this value."}, 'project_name': {'type': 'string', 'examples': ['1200 Main St - Tower A'], 'description': 'Reserved for future filtering by the D1 project_name column. Currently informational only; the OSS listing is not filtered by this value.'}}}
lumion_render
Queue a Lumion-style architectural visualization still render with landscaping, people, vehicles, and atmospheric effects. Returns a render_id and preview_url; the render pipeline is a ScanBIM roadmap item so today this tool responds synchronously with a stub job descriptor.
When to use: you want a more 'Lumion-flavored' render (lush entourage, vehicles, people) vs. Twinmotion's cleaner look.
When NOT to use: you need real-time viewing — use get_viewer_link. You need video — use twinmotion_walkthrough.
APS scopes: none today (render pipeline is ScanBIM-internal); viewables:read data:read will apply when live.
Rate limits: APS default ~50 req/min per app per endpoint; Model Derivative translation jobs ~60 req/min; OSS uploads size-limited per file to 100MB for direct upload, larger via resumable.
Errors: 401 APS token expired/invalid — refresh (will apply when pipeline is live); 403 scope or resource permission denied; 404 URN not found — check the ID; 429 rate limited — backoff and retry; 5xx APS upstream outage — retry with jitter.
Side effects: NON-IDEMPOTENT. Each call mints a new render_id (lum_<epoch_ms>). Inserts a row into D1 usage_log.
입력 스키마
{'type': 'object', 'required': ['model_id'], 'properties': {'style': {'enum': ['photorealistic', 'artistic', 'sketch', 'aerial'], 'type': 'string', 'examples': ['photorealistic'], 'description': "Overall visual preset. 'photorealistic' = full PBR, 'artistic' = painterly, 'sketch' = line-drawing overlay, 'aerial' = drone perspective."}, 'model_id': {'type': 'string', 'examples': ['dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6c2NhbmJpbS1tb2RlbHMvMTcwMDAwMDAwMDAwMF9idWlsZGluZy5ydnQ'], 'description': "APS URN (base64url-encoded, starts with 'dXJu', unpadded) of the model to render."}, 'add_people': {'type': 'boolean', 'examples': [True], 'description': 'Populate animated/static human entourage. Defaults to true.'}, 'add_vehicles': {'type': 'boolean', 'examples': [False], 'description': 'Populate cars, trucks, and other vehicles in parking/streets. Defaults to false.'}, 'add_landscaping': {'type': 'boolean', 'examples': [True], 'description': 'Populate trees, shrubs, and ground cover appropriate to region. Defaults to true.'}}}
twinmotion_render
Queue a photorealistic Twinmotion-style still render of a translated model with time-of-day, weather, season, and resolution controls. Returns a render_id and preview_url; the actual render pipeline is a ScanBIM roadmap item (Week 5 buildout), so today this tool responds synchronously with a stub job descriptor.
When to use: you want a scripted way to request a hero still for a proposal or client deck.
When NOT to use: you need real-time interactive rendering — use get_viewer_link. You need a moving camera — use twinmotion_walkthrough. You expect the image file bytes back in the response — this tool returns a URL, not bytes.
APS scopes: none today (render pipeline is ScanBIM-internal); viewables:read data:read will apply when the pipeline goes live.
Rate limits: APS default ~50 req/min per app per endpoint; Model Derivative translation jobs ~60 req/min; OSS uploads size-limited per file to 100MB for direct upload, larger via resumable.
Errors: 401 APS token expired/invalid — refresh (will apply when pipeline is live); 403 scope or resource permission denied; 404 URN not found — check the ID; 429 rate limited — backoff and retry; 5xx APS upstream outage — retry with jitter.
Side effects: NON-IDEMPOTENT. Each call mints a new render_id (tm_<epoch_ms>). Inserts a row into D1 usage_log. When the pipeline is live it will create a rendering job on ScanBIM's compute backend.
입력 스키마
{'type': 'object', 'required': ['model_id'], 'properties': {'season': {'enum': ['spring', 'summer', 'autumn', 'winter'], 'type': 'string', 'examples': ['autumn'], 'description': "Vegetation and ground-cover preset. Defaults to 'summer'."}, 'weather': {'enum': ['clear', 'partly_cloudy', 'overcast', 'rain', 'snow'], 'type': 'string', 'examples': ['partly_cloudy'], 'description': "Sky and atmospheric preset. Defaults to 'clear'."}, 'model_id': {'type': 'string', 'examples': ['dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6c2NhbmJpbS1tb2RlbHMvMTcwMDAwMDAwMDAwMF9idWlsZGluZy5ydnQ'], 'description': "APS URN (base64url-encoded, starts with 'dXJu', unpadded) of the model to render."}, 'resolution': {'enum': ['1080p', '4k', '8k'], 'type': 'string', 'examples': ['4k'], 'description': "Output image resolution. Defaults to '4k'."}, 'time_of_day': {'enum': ['dawn', 'morning', 'noon', 'afternoon', 'dusk', 'night'], 'type': 'string', 'examples': ['dusk'], 'description': "Sun angle preset driving lighting, shadows, and sky. Defaults to 'noon'."}, 'camera_preset': {'type': 'string', 'examples': ['hero-exterior'], 'description': "Named camera viewpoint (e.g. 'hero-exterior', 'lobby-entry'). Free-form string passed through to the render pipeline."}}}
twinmotion_walkthrough
Queue a cinematic Twinmotion-style fly-through video of a translated model. Returns a video_id and download_url; the render pipeline is a ScanBIM roadmap item so today this tool responds synchronously with a stub job descriptor.
When to use: you want a short marketing or pre-con video scripted from an agent workflow.
When NOT to use: you want real-time interactivity — use get_viewer_link. You want a still image — use twinmotion_render.
APS scopes: none today (render pipeline is ScanBIM-internal); viewables:read data:read will apply when live.
Rate limits: APS default ~50 req/min per app per endpoint; Model Derivative translation jobs ~60 req/min; OSS uploads size-limited per file to 100MB for direct upload, larger via resumable.
Errors: 401 APS token expired/invalid — refresh (will apply when pipeline is live); 403 scope or resource permission denied; 404 URN not found — check the ID; 429 rate limited — backoff and retry; 5xx APS upstream outage — retry with jitter.
Side effects: NON-IDEMPOTENT. Each call mints a new video_id (tmv_<epoch_ms>). Inserts a row into D1 usage_log.
입력 스키마
{'type': 'object', 'required': ['model_id'], 'properties': {'style': {'enum': ['cinematic', 'technical', 'presentation'], 'type': 'string', 'examples': ['cinematic'], 'description': "Animation and color-grade preset. 'cinematic' = orbits + tilts, 'technical' = orthographic pans, 'presentation' = slow lobby-to-penthouse."}, 'model_id': {'type': 'string', 'examples': ['dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6c2NhbmJpbS1tb2RlbHMvMTcwMDAwMDAwMDAwMF9idWlsZGluZy5ydnQ'], 'description': "APS URN (base64url-encoded, starts with 'dXJu', unpadded) of the model to animate."}, 'duration_seconds': {'type': 'number', 'examples': [60], 'description': 'Video duration in seconds. Integer 10-600; defaults to 60 when omitted.'}}}
upload_model
Ingest a 3D model from a public URL into APS OSS and kick off a Model Derivative translation job, returning the URN plus a browser viewer link and QR code. Supports 50+ formats: Revit (.rvt/.rfa), Navisworks (.nwd/.nwc), IFC, FBX, OBJ, SolidWorks, point clouds (E57/LAS/RCP), CAD (DWG/STEP/IGES), etc.
When to use: you have a publicly downloadable 3D file (S3 presigned URL, GitHub raw, etc.) and need it translated to SVF2 so it can be viewed, measured, or clash-checked via other tools.
When NOT to use: the file is only on a local disk or behind auth (fetch will fail) — first push it to a public URL. Do not call to re-translate a model already uploaded; call get_model_metadata instead.
APS scopes: data:read data:write data:create bucket:read bucket:create viewables:read
Rate limits: APS default ~50 req/min per app per endpoint; Model Derivative translation jobs ~60 req/min; OSS uploads size-limited per file to 100MB for direct upload, larger via resumable.
Errors: 401 APS token expired/invalid — refresh; 403 scope or resource permission denied; 404 source file_url not reachable or bucket not found — check the ID; 409 bucket name conflict (bucket already owned by another app — pick a unique bucketKey); 429 rate limited — backoff and retry; 5xx APS upstream outage — retry with jitter.
Side effects: NON-IDEMPOTENT. Creates the scanbim-models bucket if absent, uploads a new OSS object with a timestamped key (each call creates a distinct object even for the same input), submits a Model Derivative job (x-ads-force=true overwrites prior derivatives for the same URN), and inserts a row into D1 usage_log + models table.
입력 스키마
{'type': 'object', 'required': ['file_url', 'file_name'], 'properties': {'file_url': {'type': 'string', 'examples': ['https://storage.googleapis.com/scanbim-public/sample/rac_basic_sample_project.rvt'], 'description': 'Publicly fetchable HTTPS URL to the 3D model file. Must be directly downloadable (no login wall, no JS redirect); the worker does a plain fetch() and streams the bytes into APS OSS. Max 100MB for direct upload. Presigned S3/GCS URLs work well.'}, 'file_name': {'type': 'string', 'examples': ['office-tower-L1-L12.rvt'], 'description': 'Filename including the extension. The extension is used to determine the tier (free/pro/enterprise) and is preserved in the OSS object key (prefixed with a Unix-ms timestamp). Use only ASCII + dash/underscore/dot; no path separators.'}, 'project_name': {'type': 'string', 'examples': ['1200 Main St - Tower A'], 'description': "Optional free-text label stored alongside the model row in D1 for grouping models by project. Does not affect APS storage or URN. Defaults to 'default' when omitted."}}}
xr_launch_ar_session
Create a shareable WebXR AR passthrough session URL and QR code. On phone or tablet with WebXR AR support, the model is overlaid on the camera feed at the requested scale.
When to use: a field user needs to walk the jobsite with a phone and see the model overlaid in-place at 1:1 scale, or drop a tabletop mini-model on a desk.
When NOT to use: the target device is a Meta Quest in VR mode — use xr_launch_vr_session. The device lacks WebXR AR (desktop browser) — use get_viewer_link.
APS scopes: viewables:read data:read (enforced at viewer page load, not at tool call).
Rate limits: APS default ~50 req/min per app per endpoint; Model Derivative translation jobs ~60 req/min; OSS uploads size-limited per file to 100MB for direct upload, larger via resumable.
Errors: 401 APS token expired/invalid — refresh (only at viewer page load); 403 scope or resource permission denied; 404 URN not found — check the ID; 429 rate limited — backoff and retry; 5xx APS upstream outage — retry with jitter.
Side effects: NON-IDEMPOTENT. Each call mints a new session_id (ar_<epoch_ms>). Inserts a row into D1 usage_log read by xr_list_sessions. No APS resources are created.
입력 스키마
{'type': 'object', 'required': ['model_id'], 'properties': {'scale': {'enum': ['1:1', 'tabletop', 'custom'], 'type': 'string', 'examples': ['1:1'], 'description': "Model placement scale. '1:1' for in-situ real-world scale, 'tabletop' for ~1:50 desk-top display, 'custom' to allow pinch-to-scale. Defaults to '1:1'."}, 'model_id': {'type': 'string', 'examples': ['dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6c2NhbmJpbS1tb2RlbHMvMTcwMDAwMDAwMDAwMF9idWlsZGluZy5ydnQ'], 'description': "APS URN (base64url-encoded, starts with 'dXJu', unpadded) of the model to load in AR."}, 'session_name': {'type': 'string', 'examples': ['Jobsite AR walkdown - 2026-04-18'], 'description': 'Human-readable session label shown in the session list.'}}}
xr_launch_vr_session
Create a shareable WebXR VR walkthrough session URL (and Meta Quest oculus:// deep link + QR code) for a translated model. The session_id is generated server-side; rendering happens in the user's Quest browser.
When to use: you need to walk a client or field team through a model in immersive VR on Meta Quest 2/3/Pro.
When NOT to use: the user is on a phone/tablet without a headset — use xr_launch_ar_session or get_viewer_link. The model has not finished translating — call get_model_metadata first.
APS scopes: viewables:read data:read (enforced at viewer page load, not at tool call).
Rate limits: APS default ~50 req/min per app per endpoint; Model Derivative translation jobs ~60 req/min; OSS uploads size-limited per file to 100MB for direct upload, larger via resumable.
Errors: 401 APS token expired/invalid — refresh (only at viewer page load); 403 scope or resource permission denied; 404 URN not found — check the ID; 429 rate limited — backoff and retry; 5xx APS upstream outage — retry with jitter.
Side effects: NON-IDEMPOTENT. Each call mints a new session_id (vr_<epoch_ms>). Inserts a row into D1 usage_log which is later read by xr_list_sessions. No APS resources are created.
입력 스키마
{'type': 'object', 'required': ['model_id'], 'properties': {'model_id': {'type': 'string', 'examples': ['dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6c2NhbmJpbS1tb2RlbHMvMTcwMDAwMDAwMDAwMF9idWlsZGluZy5ydnQ'], 'description': "APS URN (base64url-encoded, starts with 'dXJu', unpadded) of the model to load in VR."}, 'session_name': {'type': 'string', 'examples': ['Owner walkthrough - Level 3 MEP'], 'description': "Human-readable session label shown in the session list. Defaults to 'VR Session' if omitted."}, 'max_participants': {'type': 'number', 'examples': [5], 'description': 'Maximum concurrent participants in multi-user mode. Integer 1-20. Defaults to 5.'}, 'enable_measurements': {'type': 'boolean', 'examples': [True], 'description': 'Enable in-VR tape-measure tool. Defaults to true.'}, 'enable_voice_annotations': {'type': 'boolean', 'examples': [False], 'description': 'Enable voice-note recording anchored to model elements. Defaults to false.'}}}
xr_list_sessions
List the last 20 VR/AR sessions launched via xr_launch_vr_session and xr_launch_ar_session, sorted by creation time desc. Sourced from the D1 usage_log table; returns an empty array if D1 is unavailable or no sessions have been recorded.
When to use: you want to audit who launched which XR session and when, or surface recent sessions to a user.
When NOT to use: you want details (join URL, features) for a specific session — those details live inside the original launch response and are not stored beyond the log row.
APS scopes: none (D1 read only).
Rate limits: APS default ~50 req/min per app per endpoint; Model Derivative translation jobs ~60 req/min; OSS uploads size-limited per file to 100MB for direct upload, larger via resumable.
Errors: 401 APS token expired/invalid — refresh (not applicable: no APS call); 403 scope or resource permission denied (not applicable); 404 not applicable; 429 rate limited — backoff and retry (worker-level only); 5xx APS upstream outage — retry with jitter (not applicable).
Side effects: READ-ONLY. Idempotent.
입력 스키마
{'type': 'object', 'properties': {'model_id': {'type': 'string', 'examples': ['dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6c2NhbmJpbS1tb2RlbHMvMTcwMDAwMDAwMDAwMF9idWlsZGluZy5ydnQ'], 'description': 'Reserved for future filtering by model URN. Currently not applied; all recent xr_* sessions are returned.'}, 'session_type': {'enum': ['vr', 'ar', 'all'], 'type': 'string', 'examples': ['all'], 'description': 'Reserved for future filtering by session type. Currently not applied; both VR and AR sessions are returned.'}}}
기록
최근 도구 변경
추가됨
lumion_render
2026년 9월 17일 12:53 PM
추가됨
twinmotion_walkthrough
2026년 9월 17일 12:53 PM
추가됨
twinmotion_render
2026년 9월 17일 12:53 PM
추가됨
xr_list_sessions
2026년 9월 17일 12:53 PM
추가됨
xr_launch_ar_session
2026년 9월 17일 12:53 PM
추가됨
xr_launch_vr_session
2026년 9월 17일 12:53 PM
추가됨
acc_project_summary
2026년 9월 17일 12:53 PM
추가됨
acc_search_documents
2026년 9월 17일 12:53 PM
추가됨
acc_list_rfis
2026년 9월 17일 12:53 PM
추가됨
acc_list_issues
2026년 9월 17일 12:53 PM
추가됨
acc_create_rfi
2026년 9월 17일 12:53 PM
추가됨
acc_create_issue
2026년 9월 17일 12:53 PM
추가됨
acc_list_projects
2026년 9월 17일 12:53 PM
추가됨
get_supported_formats
2026년 9월 17일 12:53 PM
추가됨
get_model_metadata
2026년 9월 17일 12:53 PM
추가됨
list_models
2026년 9월 17일 12:53 PM
추가됨
get_viewer_link
2026년 9월 17일 12:53 PM
추가됨
detect_clashes
2026년 9월 17일 12:53 PM
추가됨
upload_model
2026년 9월 17일 12:53 PM
탐색
유사한 MCP 서버
kernelcad
com.kernelcad/kernelcad
Authors, evaluates, reviews, simulates, edits, and exports parametric CAD assemblies and geometry from editable TypeScript-based …
Picas to millimeters, number discarded
io.github.sadri-dridi/pica-mm
Converts picas to millimeters and provides general developer utility checks.
Ciceros to millimeters, number discarded
io.github.sadri-dridi/cicero-mm
Converts ciceros, a typographic unit, to millimeters.
bimhouse
house.bim/bimhouse
Creates and edits house BIM models, checks Japanese building-code constraints, estimates materials and construction costs, matche…
FabTally 3D-Print Slicer, Quote & DFM
com.fabtally/slicer
Analyzes, validates, or slices 3D models and provides printability checks, printer and material recommendations, orientation opti…
Aspicio
io.github.frontsail-ai/aspicio
Describes, renders, and interactively views DXF and vector PDF technical drawings, including layers, entities, dimensions, and ex…
frontier-reference
so.falcon/frontier-reference
Provides reference information on frontier technologies, sensors, companies, file formats, format conversion, and related design …
protogen
io.github.jdhart81/protogen
Creates parametric CAD designs and exports them to CAD formats while generating manufacturing plans, bills of materials, DFM note…