Proper BIM MCP Server

Revit shared parameter validation, ISO 19650 naming checks, and sheet list auditing — directly in Claude, Cursor, and any MCP-compatible AI assistant.

Built by Proper BIM — proper tools, fairly priced.

Install

Add to your Claude Desktop or Claude Code config (claude_desktop_config.json):

{
  "mcpServers": {
    "proper-bim": {
      "command": "npx",
      "args": ["-y", "@properbim/mcp-server"]
    }
  }
}

No API key needed for the free tools. Restart Claude after saving.

What you can ask

"Parse my shared parameter file at C:/BIM/project.txt"

"Check if the parameters in this SPF follow ISO 19650 naming conventions"

"Find any duplicate GUIDs in my shared parameter file"

"Validate my sheet list CSV — are there duplicates or empty fields?"

"My sheet numbers should follow the pattern AR-001 — check this list"

Tools

| Tool | What it does | Tier | |------|-------------|------| | read_shared_parameter_file | Parse a Revit .txt SPF → groups + parameters | Free | | find_duplicate_parameters | Find duplicate GUIDs or names (silent Revit corruption) | Free | | check_iso19650_naming | Validate parameter names against ISO 19650 rules | Free | | validate_sheet_naming | Check a sheet list CSV for duplicates and naming issues | Free |

All tools accept a file path, raw file content pasted inline, or a JSON list.

Example output

check_iso19650_naming on a shared parameter file:

{
  "totalChecked": 24,
  "passCount": 21,
  "errorCount": 2,
  "warningCount": 1,
  "summary": "2 error(s), 1 warning(s) across 24 parameters. 21 pass cleanly.",
  "violations": [
    {
      "ruleId": "ISO-001",
      "severity": "error",
      "parameterName": "Sheet Number",
      "message": "\"Sheet Number\" contains spaces. Use underscores or camelCase."
    },
    {
      "ruleId": "ISO-006",
      "severity": "warning",
      "parameterName": "x",
      "message": "\"x\" is too short (1 chars, min 3)."
    }
  ]
}

Pro features (coming with Proper Params)

Set your Proper BIM API key to unlock unlimited checks and additional tools:

{
  "mcpServers": {
    "proper-bim": {
      "command": "npx",
      "args": ["-y", "@properbim/mcp-server"],
      "env": {
        "PROPER_API_KEY": "pk_live_..."
      }
    }
  }
}

Pro tools include: full compliance reports, live Revit model queries, and audit log export. Get a key at properbim.com.

ISO 19650 rules checked

| Rule | Severity | |------|---------| | No spaces in parameter names | Error | | Max 128 characters | Error | | Only letters, digits, underscore, hyphen | Error | | Must not start with a digit | Warning | | Must not start or end with _ or - | Warning | | Minimum 3 characters | Warning | | No consecutive separators (__, --) | Warning | | All-uppercase names (reserved for system params) | Info |

Custom prefix validation supported (e.g., all parameters must start with Pr_).

Supported AI clients

Works with any MCP-compatible client:

• Claude Desktop
• Claude Code (CLI)
• Cursor
• VS Code with Copilot Chat
• Cline, Goose, and other MCP hosts

More Proper BIM tools

• Proper Swap — Swap titleblocks across all Revit sheets with full parameter mapping
• Proper Sheets — Excel↔Revit sheet sync with ISO 19650 metadata
• Proper Params — Shared parameter editor, binding audit, bulk bind
• Proper Quantify — Share Navisworks quantities with estimators, no license needed

MIT License · Built by Fabrizio Giargeri · properbim.com