openstudio-mcp

Add custom EMS control or reporting logic (EnergyPlus Python Plugins) — setpoint resets, schedule overrides, supervisory control, custom metrics. Use when no packaged HVAC/schedule tool covers the control logic the user wants.

OpenStudio Analysis Framework (OSAF) workflows, algorithm selection, validation, submission, and result download. Use when the user asks about OSAF, OpenStudio Server analyses, sampling, sweeps, optimization, calibration, or OSA JSON configs.

Create, test, and apply custom OpenStudio measures. Use when user asks to "write a measure", "create a custom measure", "modify the model with Ruby/Python code", or needs logic beyond what existing tools provide.

Generate comprehensive energy analysis report from simulation results. Use when user asks for "energy report", "full results", or "detailed analysis".

OpenStudio model object relationships, tool dependencies, and common error patterns. Use when building or modifying models to ensure correct tool ordering.

Run model quality checks before simulation. Use when user asks to "check the model", "validate", "QA/QC", or before running a simulation.

Create a complete building model from scratch — geometry, envelope, loads, HVAC, weather, and simulation. Use when user wants to "create a building", "build a model", or "start a new model".

Analyze energy conservation measures — apply upgrades and compare before/after performance. Use when user asks about "retrofit", "upgrade", "ECM", "energy savings", or "what-if analysis".

Guided HVAC system selection and setup. Use when user asks to "add HVAC", "set up heating and cooling", or "what HVAC system should I use".

Multi-tool recipes for common building energy modeling tasks. Use when chaining tools together for operations like adding windows, changing insulation, setting up HVAC, or running simulations.

Diagnose simulation failures and unexpected results. Use when user says "simulation failed", "error", "EUI looks wrong", "unmet hours", or when get_run_status shows failure.

Run EnergyPlus simulation and extract results in one step. Use when user says "simulate", "run simulation", or "run the model".

Generate 3D visualization of the current model. Use when user says "show me the model", "visualize", or "view".

ASHRAE 90.1 Appendix G baseline system selection criteria. Use when recommending HVAC system types, creating baseline models, or answering questions about ASHRAE 90.1 compliance.