CRREM Server

MCP server exposing CRREM v2.05 carbon pathway data for real estate decarbonization analysis.

Endpoint

POST /mcp — MCP Streamable HTTP transport (stateless)
GET /health — Health check

Tools

Tool	Description
get_pathway	Carbon & energy targets by country/property type/year
get_emission_factors	Grid emission factors by country
get_climate_zone	Climate zone for US/CA/AU postal codes
calculate_stranding_risk	Full stranding analysis for a building
list_countries	Available countries
list_property_types	Available property types for a country

Data notes

• Countries: EU-27 + CH + NO + UK + HK (CRREM v2.05). No US/CA/AU pathway data.
• Country codes: EL for Greece, UK for United Kingdom (not GB), HK for Hong Kong.
• Emission factors: Electricity only in CRREM v2.05 dataset.
• Postal zones: US (full ZIP), CA (first letter of FSA), AU (numeric prefix).
• Interpolation: Linear interpolation between data points for any year 2020–2050.
• Data source: soapboxbuild/crrem-data (public GitHub repo).

Stranding status logic

• stranded: currentIntensity > pathwayTarget at the reference year
• at-risk: currently on pathway but will strand before 2050
• on-pathway: on pathway and won't strand through 2050

Local dev

npm install
npm run dev       # tsx watch
npm run build     # tsc
node dist/index.js