Skip to main content

MCP server for searching Canadian Building Codes (NBC, OBC, BCBC, etc.)

Project description

Canadian Building Code MCP Server

PyPI version License: MIT

A Model Context Protocol (MCP) server that enables Claude to search and navigate Canadian building codes.

How It Works

This MCP server operates in two modes:

Mode Use Case PDF Required Text Extraction
Map-Only Hosted API, Quick lookup No Page numbers & coordinates only
BYOD Local MCP with full text Yes (your own) Full section text

Map-Only Mode (Default)

  • Returns page numbers, section IDs, and coordinates
  • Works everywhere (local, Vercel, Render, etc.)
  • No PDF needed - just the indexed maps

BYOD Mode (Bring Your Own Document)

  • Connect YOUR legally obtained PDF using set_pdf_path
  • Get full text extraction from sections
  • Local MCP only - not available in hosted API

Note: The hosted API at canada-aec-code-mcp.onrender.com runs in Map-Only mode. For full text extraction, run the MCP server locally and connect your own PDFs.


Quick Setup

Option A: Smithery (One-click install)

npx -y @smithery/cli@latest install davidcho/ca-building-code-mcp --client claude

Option B: uvx (Auto-updates, recommended)

Prerequisites: Install uv first (one-time setup):

# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Or via pip
pip install uv

Then add to Claude Desktop config (%APPDATA%\Claude\claude_desktop_config.json on Windows, ~/Library/Application Support/Claude/claude_desktop_config.json on Mac):

{
  "mcpServers": {
    "building-code": {
      "command": "uvx",
      "args": ["building-code-mcp"]
    }
  }
}

Benefits: Automatically checks for updates on each run - always get the latest version!

Option C: pip install (Manual updates)

pip install building-code-mcp
{
  "mcpServers": {
    "building-code": {
      "command": "building-code-mcp"
    }
  }
}

To update: Run pip install --upgrade building-code-mcp


What It Does

Ask Claude questions like:

  • "Find fire separation requirements for garages in NBC"
  • "What are the stair width requirements in OBC?"
  • "Show me section 9.10.14 of the Building Code"

Claude will search 22,500+ indexed sections across 16 Canadian building codes and guides.

Supported Codes

Building Codes (13)

Code Version Sections Description
NBC 2025 2,700+ National Building Code
NFC 2025 1,000+ National Fire Code
NPC 2025 400+ National Plumbing Code
NECB 2025 450+ National Energy Code for Buildings
OBC 2024 4,100+ Ontario Building Code (Vol 1 & 2)
OFC O. Reg. 213/07 1,900+ Ontario Fire Code
BCBC 2024 2,500+ British Columbia Building Code
ABC 2023 2,800+ Alberta Building Code
QCC 2020 2,700+ Quebec Construction Code
QECB 2020 380+ Quebec Energy Code
QPC 2020 420+ Quebec Plumbing Code
QSC 2020 1,000+ Quebec Safety Code

User's Guides (3)

Guide Version Sections Description
IUGP9 2020 1,000+ Illustrated Guide - Part 9 Housing
UGP4 2020 490+ User's Guide - NBC Structural Commentaries
UGNECB 2020 160+ User's Guide - NECB

Usage Examples

Once installed, just ask Claude naturally:

"Search for egress requirements in NBC"
"What does section 3.2.4.1 say in OBC?"
"Find fire resistance ratings for walls"
"Which building code applies in Toronto?"
"List all available building codes"

API Access

REST API available at: https://canada-aec-code-mcp.onrender.com

GET /codes              - List all codes
GET /search/{query}     - Search sections
GET /section/{id}       - Get section details

Hosted API Limitation: The hosted API runs in Map-Only mode. set_pdf_path is not available - use local MCP for full text extraction.

License

MIT License - See LICENSE file.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

building_code_mcp-1.1.1.tar.gz (2.1 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

building_code_mcp-1.1.1-py3-none-any.whl (2.1 MB view details)

Uploaded Python 3

File details

Details for the file building_code_mcp-1.1.1.tar.gz.

File metadata

  • Download URL: building_code_mcp-1.1.1.tar.gz
  • Upload date:
  • Size: 2.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.9

File hashes

Hashes for building_code_mcp-1.1.1.tar.gz
Algorithm Hash digest
SHA256 f5407cbcae8fd3c7c35212449bade57ea6c03590a558546ab57a2372d1052f82
MD5 94d1dcc578ebdeaf2c7de5ebabcc2f6a
BLAKE2b-256 86071bb81c6d57311fe9f29a279aa4e84ca63803200d1504d93307f528891133

See more details on using hashes here.

File details

Details for the file building_code_mcp-1.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for building_code_mcp-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 5ff29b3c2a63734ab426c5244a708098df60b9e4faf3f5dc9931a1e41821b5f1
MD5 22079cc74cc2d4ff361facc55d82feca
BLAKE2b-256 d53c4fe0014e2549e1950bc1280ddf4dce7394e5d47f39bb0518cf9b8d13aea7

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page