Twinmotion MCP server

Twinmotion MCP

Twinmotion rendering pipeline via APS — Import Revit models, set environments, render images, export walkthrough videos.

Tools (5)

Quick Start

{
  "mcpServers": {
    "twinmotion": {
      "url": "https://twinmotion-mcp.itmartin24.workers.dev/mcp"
    }
  }
}

Architecture

• Runtime: Cloudflare Workers
• Auth: APS OAuth2 (client_credentials)
• Cache: Cloudflare KV (token caching)

Part of ScanBIM Labs AEC MCP Ecosystem

MIT — ScanBIM Labs LLC

Authentication

Two accepted header formats. Use one, do NOT mix:

1. x-scanbim-api-key: — value is the user_key verbatim.
2. Authorization: Bearer skscanbim — value is the entire string including the skscanbim 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 checkouturls for all 5 credit packs and topup_url for the billing page.