revit-mcp

endpoint

https://revit-mcp.itmartin24.workers.dev/mcp

protocol

streamable-http ·2024-11-05

authentication

none observed

public key

none — nobody has proven they own this listing · is it yours? claim it

karma

0 · newcomer

Is revit-mcp live?

Yes — it answered the hub's last check (checked 1h ago). It answered 100% of checks over the last 30 days.

Is revit-mcp free to use?

Not measured yet.

What tools does revit-mcp have?

8 tools: revit_clash_detect, revit_get_sheets, revit_upload, revit_get_elements, revit_get_parameters, revit_run_schedule, revit_export_ifc, revit_get_views.

Is revit-mcp safe to connect?

The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

• revit_clash_detect reads unknown never probed

  When to use: Perform a lightweight clash analysis between two Revit categories (e.g. Mechanical Equipment vs Structural Framing) using bounding-box overlap where available, falling back to shared-Level proximity, then annotate with any matching VDC rules stored in the D1 database. When NOT to use: Do not use as a substitute for Navisworks Manage for contractual clash reports — this is a first-pass coordination sniff test, not a certified Clash Detective run. APS scopes: data:read viewables:read (Model Derivative metadata + properties). 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 — refresh. 403 scope insufficient — add viewables:read. 404 URN not found — verify model_id. 429 rate limited — back off. 5xx APS upstream — retry with jitter. Side effects: Read-only against APS. May read from D1 vdc_rules table if present. Idempotent.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132

  {
    "type": "object",
    "required": [
      "model_id",
      "category_a",
      "category_b"
    ],
    "properties": {
      "model_id": {
        "type": "string",
        "pattern": "^dXJu[A-Za-z0-9_-]+$",
        "examples": [
          "dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6c2NhbmJpbS1yZXZpdC0xNzMxMjM0NTY3L015QnVpbGRpbmcucnZ0"
        ],
        "description": "Base64url-encoded URN of the translated Revit model. Always begins with 'dXJu'."
      },
      "category_a": {
        "type": "string",
        "examples": [
          "Mechanical Equipment"
        ],
        "description": "First Revit category for the pairwise clash check (case-insensitive substring match). Typical MEP/structural examples: Mechanical Equipment, Ducts, Pipes, Cable Trays."
      },
      "category_b": {
        "type": "string",
        "examples": [
          "Structural Framing"
        ],
        "description": "Second Revit category to compare against category_a. Often a structural/architectural discipline when category_a is MEP."
      }
    }
  }

  arguments 32 lines copy
• revit_get_sheets reads unknown never probed

  When to use: Enumerate the drawing sheets (title blocks with sheet number + sheet name like 'A-101: First Floor Plan') published from a translated Revit model, so an agent can pick which sheet to render, review, or cross-reference. When NOT to use: Do not use to list model views like floor plans or 3D views (use revit_get_views) — this returns only 2D sheet entries. APS scopes: data:read viewables:read (Model Derivative metadata + object tree). 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 — refresh. 403 scope insufficient — add viewables:read. 404 URN not found — check model_id. 429 rate limited — back off. 5xx APS upstream — retry with jitter. Side effects: Read-only. Idempotent.

  mcp-tool

  12345678910111213141516

  {
    "type": "object",
    "required": [
      "model_id"
    ],
    "properties": {
      "model_id": {
        "type": "string",
        "pattern": "^dXJu[A-Za-z0-9_-]+$",
        "examples": [
          "dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6c2NhbmJpbS1yZXZpdC0xNzMxMjM0NTY3L015QnVpbGRpbmcucnZ0"
        ],
        "description": "Base64url-encoded URN of the translated Revit model whose sheets you want to list. Always begins with 'dXJu'."
      }
    }
  }

  arguments 16 lines copy
• revit_upload changes data unknown never probed

  When to use: Ingest a Revit (.rvt / .rfa / .rte / .rft) file into Autodesk Platform Services by downloading it from a publicly reachable URL, uploading it to an OSS bucket, and starting an SVF2 translation so downstream revit_* tools can read elements, parameters, sheets, and views. When NOT to use: Do not call if you already have a translated URN (use the existing model_id instead), if the file is not a Revit source file, or if the URL requires authentication the worker cannot satisfy. APS scopes: data:read data:write data:create bucket:read bucket:create viewables:read (OSS bucket create + object PUT + Model Derivative job). 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 — refresh credentials and retry. 403 scope insufficient — request data:write + bucket:create. 404 bucket/object not found — confirm bucket was created. 409 bucket exists — safe to ignore, reuse it. 429 rate limited — back off with exponential delay. 5xx APS upstream — retry with jitter up to 3x, then surface. Side effects: Creates a new transient OSS bucket named scanbim-revit-<timestamp>, uploads the object, and starts a Model Derivative translation job. NOT idempotent — each call creates a fresh bucket and new URN.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132

  {
    "type": "object",
    "required": [
      "file_url",
      "file_name"
    ],
    "properties": {
      "file_url": {
        "type": "string",
        "format": "uri",
        "examples": [
          "https://example.com/models/MyBuilding.rvt"
        ],
        "description": "Public HTTPS URL the worker can fetch the Revit file from. Must return 200 with the raw .rvt bytes (no auth gate, no HTML redirect). Max 100MB for direct upload."
      },
      "file_name": {
        "type": "string",
        "pattern": "^[A-Za-z0-9._-]+\\.(rvt|rfa|rte|rft)$",
        "examples": [
          "MyBuilding.rvt"
        ],
        "description": "Original file name including the Revit extension (.rvt, .rfa, .rte, .rft). Used as the OSS object key; non-alphanumeric characters are sanitized to underscores."
      },
      "project_name": {
        "type": "string",
        "examples": [
          "Acme HQ Tower - Phase 2"
        ],
        "description": "Optional human-readable project label echoed back in the response for bookkeeping. No effect on APS processing."
      }
    }
  }

  arguments 32 lines copy
• revit_get_elements reads unknown never probed

  When to use: After a Revit model has finished translating, fetch the first ~100 elements belonging to a Revit category (e.g. Walls, Doors, Windows, Structural Columns) with their objectid, name, externalId, and property bag. When NOT to use: Do not call before translation completes (manifest.status must be success), and do not use for free-text searches across the whole model — filter by category here or use revit_run_schedule for tabular views. APS scopes: data:read viewables:read (Model Derivative metadata + properties). 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 — refresh. 403 scope insufficient — add viewables:read. 404 URN not found — confirm model_id and that translation has run. 429 rate limited — back off. 5xx APS upstream — retry with jitter. Side effects: Read-only. Idempotent.

  mcp-tool

  123456789101112131415161718192021222324

  {
    "type": "object",
    "required": [
      "model_id",
      "category"
    ],
    "properties": {
      "category": {
        "type": "string",
        "examples": [
          "Walls"
        ],
        "description": "Revit category name to filter on (case-insensitive substring match). Use canonical Revit category names like Walls, Doors, Windows, Structural Columns, Ducts, Pipes, Mechanical Equipment."
      },
      "model_id": {
        "type": "string",
        "pattern": "^dXJu[A-Za-z0-9_-]+$",
        "examples": [
          "dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6c2NhbmJpbS1yZXZpdC0xNzMxMjM0NTY3L015QnVpbGRpbmcucnZ0"
        ],
        "description": "Base64url-encoded URN of the translated Revit model (returned from revit_upload as model_id/urn). Always begins with 'dXJu' (base64 of 'urn:')."
      }
    }
  }

  arguments 24 lines copy
• revit_get_parameters reads unknown never probed

  When to use: Enumerate the Revit parameters (type + instance) that appear on elements in a given category, or on one specific element by objectid. Returns unique values per parameter and how many elements carry it — ideal for schema discovery before building a schedule. When NOT to use: Do not use when you just need the elements themselves (use revit_get_elements), or to modify values — this is read-only. APS scopes: data:read viewables:read (Model Derivative metadata + properties). 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 — refresh. 403 scope insufficient — add viewables:read. 404 URN not found — verify model_id. 429 rate limited — back off. 5xx APS upstream — retry with jitter. Side effects: Read-only. Idempotent.

  mcp-tool

  12345678910111213141516171819202122232425262728293031

  {
    "type": "object",
    "required": [
      "model_id",
      "category"
    ],
    "properties": {
      "category": {
        "type": "string",
        "examples": [
          "Doors"
        ],
        "description": "Revit category to filter on (case-insensitive substring match). Ignored when element_id is supplied."
      },
      "model_id": {
        "type": "string",
        "pattern": "^dXJu[A-Za-z0-9_-]+$",
        "examples": [
          "dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6c2NhbmJpbS1yZXZpdC0xNzMxMjM0NTY3L015QnVpbGRpbmcucnZ0"
        ],
        "description": "Base64url-encoded URN of the translated Revit model (returned from revit_upload). Always begins with 'dXJu'."
      },
      "element_id": {
        "type": "string",
        "examples": [
          "12345"
        ],
        "description": "Optional APS Model Derivative objectid of a single element to inspect. When provided, overrides category filtering and returns parameters only for that element."
      }
    }
  }

  arguments 31 lines copy
• revit_run_schedule reads unknown never probed

  When to use: Build a tabular, spreadsheet-style schedule (rows = elements matching a keyword, columns = up to 15 shared parameters) from a translated Revit model — useful for Door Schedules, Wall Schedules, Room Schedules, and QA/QC exports. When NOT to use: Do not use when you only need raw element metadata (use revit_get_elements) or parameter schema (use revit_get_parameters). APS scopes: data:read viewables:read (Model Derivative metadata + properties). 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 — refresh. 403 scope insufficient — add viewables:read. 404 URN not found — check model_id. 429 rate limited — back off. 5xx APS upstream — retry with jitter. Side effects: Read-only. Idempotent.

  mcp-tool

  123456789101112131415161718192021222324

  {
    "type": "object",
    "required": [
      "model_id",
      "schedule_name"
    ],
    "properties": {
      "model_id": {
        "type": "string",
        "pattern": "^dXJu[A-Za-z0-9_-]+$",
        "examples": [
          "dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6c2NhbmJpbS1yZXZpdC0xNzMxMjM0NTY3L015QnVpbGRpbmcucnZ0"
        ],
        "description": "Base64url-encoded URN of the translated Revit model. Always begins with 'dXJu'."
      },
      "schedule_name": {
        "type": "string",
        "examples": [
          "Doors"
        ],
        "description": "Category name or keyword used to select rows (case-insensitive substring match on Category/name). Common examples: Walls, Doors, Windows, Rooms, Furniture, Mechanical Equipment."
      }
    }
  }

  arguments 24 lines copy
• revit_export_ifc changes data unknown never probed

  When to use: Kick off a Model Derivative translation of a previously uploaded Revit URN into IFC (IFC2x3 Coordination View 2.0 by default) so the model can be exchanged with non-Autodesk tools (Solibri, BIMcollab, Tekla, openBIM workflows). When NOT to use: Do not use for SVF/SVF2 web viewing (that happens automatically in revit_upload), and do not call repeatedly while a prior IFC job is still inprogress — poll the manifest instead. APS scopes: data:read data:write viewables:read (Model Derivative job + manifest). 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 — refresh. 403 scope insufficient — add data:write. 404 URN not found — confirm model_id was translated. 409 not applicable. 429 rate limited — back off. 5xx APS upstream — retry with jitter up to 3x. Side effects: Creates a Model Derivative job and, on completion, a new IFC derivative inside the model's manifest. Safe to re-run (APS deduplicates) but each call with x-ads-force may retranslate.

  mcp-tool

  123456789101112131415161718192021222324

  {
    "type": "object",
    "required": [
      "model_id"
    ],
    "properties": {
      "model_id": {
        "type": "string",
        "pattern": "^dXJu[A-Za-z0-9_-]+$",
        "examples": [
          "dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6c2NhbmJpbS1yZXZpdC0xNzMxMjM0NTY3L015QnVpbGRpbmcucnZ0"
        ],
        "description": "Base64url-encoded URN of the translated Revit model to export to IFC. Always begins with 'dXJu'."
      },
      "include_properties": {
        "type": "boolean",
        "default": true,
        "examples": [
          true
        ],
        "description": "Whether to include Revit property sets in the IFC output. true -> IFC2x3 Coordination View 2.0 (with psets); false -> minimal IFC2x3 geometry."
      }
    }
  }

  arguments 24 lines copy
• revit_get_views reads unknown never probed

  When to use: Return every view (both 2D — floor plans, ceiling plans, elevations, sections, sheets — and 3D — default {3D}, perspective views, isometric views) in the translated Revit model, including each view's GUID, name, role, and whether it is the master view. When NOT to use: Do not use when you only want drawing sheets (use revit_get_sheets) or element data inside a view (use revit_get_elements / revit_run_schedule). APS scopes: data:read viewables:read (Model Derivative metadata + object tree). 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 — refresh. 403 scope insufficient — add viewables:read. 404 URN not found — check model_id. 429 rate limited — back off. 5xx APS upstream — retry with jitter. Side effects: Read-only. Idempotent.

  mcp-tool

  12345678910111213141516

  {
    "type": "object",
    "required": [
      "model_id"
    ],
    "properties": {
      "model_id": {
        "type": "string",
        "pattern": "^dXJu[A-Za-z0-9_-]+$",
        "examples": [
          "dXJuOmFkc2sub2JqZWN0czpvcy5vYmplY3Q6c2NhbmJpbS1yZXZpdC0xNzMxMjM0NTY3L015QnVpbGRpbmcucnZ0"
        ],
        "description": "Base64url-encoded URN of the translated Revit model whose views you want to list. Always begins with 'dXJu'."
      }
    }
  }

  arguments 16 lines copy

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.