BSDD Server

MCP server for the buildingSMART Data Dictionary (bSDD) API. Enables AI assistants like Claude to query standardized building classifications, properties, and data dictionaries for BIM model enrichment.

What is bSDD?

The buildingSMART Data Dictionary is an online service that hosts classifications and their properties, allowed values, units, translations, and relations. It provides a standardized way to describe building elements across multiple classification systems like IFC, ETIM, UniClass, OmniClass, and many more.

Features

This MCP server exposes 9 tools to query the bSDD API:

Tool	Description
bsdd_list_dictionaries	List available dictionaries (IFC, ETIM, UniClass, etc.)
bsdd_get_dictionary_classes	Browse class hierarchy of a dictionary
bsdd_get_class	Get full class details with properties and relations
bsdd_search_classes	Search classes by keyword across dictionaries
bsdd_get_class_properties	Get properties of a class (data types, units, allowed values)
bsdd_get_class_relations	Get relationships between classes
bsdd_get_property	Get property details (type, unit, constraints)
bsdd_get_property_classes	Find which classes use a given property
bsdd_text_search	Free-text search across all bSDD content

No API key required — the bSDD public read endpoints are used.

Installation

Prerequisites

• Node.js 18 or higher
• Claude Desktop

Setup

1. Clone the repository

git clone https://github.com/JardiMargalefAgusti/bSDD-mcp.git
cd bSDD-mcp

2. Install dependencies

npm install

3. Build

npm run build

4. Configure Claude Desktop

Open Claude Desktop settings: Settings → Developers → Edit Config

Add the following entry inside "mcpServers":

{
  "mcpServers": {
    "bSDD": {
      "command": "node",
      "args": ["/absolute/path/to/bSDD-mcp/build/index.js"]
    }
  }
}

Replace /absolute/path/to/bSDD-mcp with the actual path where you cloned the repository.

Windows example:

"args": ["C:\\Users\\youruser\\bSDD-mcp\\build\\index.js"]

macOS/Linux example:

"args": ["/Users/youruser/bSDD-mcp/build/index.js"]

5. Restart Claude Desktop

The 9 bsdd_* tools should now appear in your tool list.

Usage Examples

Once connected, you can ask Claude things like:

• "List all available bSDD dictionaries"
• "What properties should an IfcWall have according to IFC 4.3?"
• "Search bSDD for fire resistance properties"
• "Get the class definition of IfcDoor with its property sets"
• "Which IFC classes use the AcousticRating property?"
• "Show me the ETIM classification for electrical panels"
• "What are the allowed values for the FireRating property?"

BIM Enrichment Workflows

This server is designed to work alongside other BIM-related MCP servers:

bSDD + IFC Viewer (BIM-Builder)

1. Query bSDD for standard properties of an IFC class
2. Check which properties are missing in your loaded IFC model
3. Create PropertySets and add standardized properties

bSDD + Revit (FlowRun)

1. Search bSDD for classification codes and required properties
2. Generate shared parameters in Revit
3. Assign standardized values by category/type

Project Structure

bSDD-mcp/
├── src/
│   ├── index.ts              # MCP server entry point (stdio transport)
│   ├── bsdd-client.ts        # HTTP client for bSDD REST API
│   ├── tools/
│   │   ├── dictionaries.ts   # Dictionary browsing tools
│   │   ├── classes.ts        # Class lookup, search, properties, relations
│   │   ├── properties.ts     # Property details and reverse-lookup
│   │   └── search.ts         # Free-text search
│   └── types/
│       └── bsdd.ts           # TypeScript interfaces for API responses
├── package.json
├── tsconfig.json
└── build/                    # Compiled JavaScript (generated)

API Reference

This server uses the bSDD REST API:

• Base URL: https://api.bsdd.buildingsmart.org
• Authentication: None required (public read access)
• Documentation: bSDD API docs

License

MIT