Revit

What the revit MCP server does

The revit MCP server provides MCP access to Revit model data and selected model-processing workflows through Autodesk Platform Services. It is designed for agents that need to inspect uploaded models, retrieve structured information, and request common AEC data operations without manually navigating Revit.

The service covers model upload and translation, category-based element queries, parameter retrieval, schedule extraction, clash detection using VDC rules, IFC export, and inventory queries for sheets and views. It does not describe desktop application control or editing individual Revit objects directly.

How it works

The revit MCP server is exposed as a remote MCP endpoint. The README’s quick-start configuration uses:

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

Cloudflare Workers provide the runtime. APS OAuth2 with the client-credentials flow handles Autodesk service authentication. Cloudflare D1 records usage, while Cloudflare KV caches tokens.

The repository also documents a unified MCP endpoint at https://mcp.scanbimlabs.io/unified/mcp for direct JSON-RPC requests. That example calls a list_models tool, which is separate from the eight Revit tools listed for this service.

Setup and configuration

Connect an MCP client to the documented Revit URL, then provide a ScanBIM user key when authentication is required. The key can be sent in either of two ways:

• x-scanbim-api-key: <your_user_key>
• Authorization: Bearer sk_scanbim_<your_user_key>

Use only one format. The first form sends the user key verbatim. The second sends the complete value, including the sk_scanbim_ prefix. User keys are obtained from the ScanBIM billing settings page. The README’s shell example stores the first form in the SCANBIM_USER_KEY environment variable.

Tools and capabilities

The available tools are:

• revit_upload uploads a Revit file to APS and starts translation.
• revit_get_elements retrieves elements by category.
• revit_get_parameters returns parameters for an element.
• revit_run_schedule extracts schedule data.
• revit_clash_detect runs clash detection with VDC rules.
• revit_export_ifc exports a model as IFC.
• revit_get_sheets lists model sheets.
• revit_get_views lists model views.

Together, these operations support model inspection, schedule-oriented extraction, coordination checks, and interchange through IFC.

Limitations and notes

Authentication is enforced by the service. A missing or malformed header returns HTTP 401 with a JSON-RPC error code of -32001. Successful calls return HTTP 200 and debit credits. If the account lacks credits, the service returns HTTP 402 and includes checkout URLs for five credit packs plus a billing-page top-up URL.

Switching between the two authentication formats can create a separate free-plan account for the alternate key, so clients should keep one header format consistently.