bSDD MCP Server

bSDD MCP 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.

!bSDD + Claude Desktop !Node.js !License

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

1. Install dependencies

npm install

1. Build

npm run build

1. 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: ``json "args": ["C:\\Users\\youruser\\bSDD-mcp\\build\\index.js"] ` macOS/Linux example: `json "args": ["/Users/youruser/bSDD-mcp/build/index.js"] ``

1. 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