Epwforge

What is Epwforge?

Epwforge is an MCP server that gives Claude, Cursor, and other AI agents the ability to generate, morph, and download weather files (.epw, .ddy) for building energy simulation tools like EnergyPlus, OpenStudio, IES VE, and eQUEST. It integrates with the EPWForge platform, allowing agents to produce custom TMYx, actual meteorological years, future‑climate (CMIP6) morphs, urban heat island adjustments, extreme events, and wildfire smoke overlays.

How to use Epwforge?

Install the Python package (pip install epwforge-mcp) and add a epwforge entry to your MCP client config (e.g., claude_desktop_config.json), pointing to the epwforge-mcp command and supplying your EPWFORGE_API_KEY. The server provides ten tools; most agents will call find_station to discover available stations, then either get_station_epw for a published TMYx file or generate_weather_file for a custom synthesized one.

Key features of Epwforge

• Synthesize custom weather files from ERA5 reanalysis at any global lat/lon.
• Fetch published TMYx files from the OneBuilding/GuzzStations library.
• Apply CMIP6 future‑climate morphing with SSP scenarios and warming percentiles.
• Inject extreme events — heat waves, cold snaps, humidity, wind, and wildfire smoke.
• Generate design‑day (DDY) files for EnergyPlus sizing.
• Run batch and ensemble generation for multi‑scenario analysis.
• Analyze and compare EPWs inline without creating new files.
• Render SVG charts of diurnal profiles and scenario deltas.

Use cases of Epwforge

• Generate a worst‑case future climate EPW for a building at a specific lat/lon with SSP3‑7.0, urban heat island, and a 14‑day heat wave.
• Fetch the latest published TMYx file for an airport station to use in a compliance submittal.
• Create a 10‑member ensemble of per‑model CMIP6 morphed EPWs for inter‑model uncertainty analysis.
• Run a sensitivity sweep comparing up to 10 scenarios (e.g., different SSPs and percentiles) and view results as a delta chart.
• Quickly analyze an existing EPW file’s design conditions, degree‑days, and monthly temperature shape.

FAQ from Epwforge

What is the difference between generate_weather_file and get_station_epw?

generate_weather_file synthesizes a custom EPW from ERA5 reanalysis at any lat/lon, allowing full customization (SSP, UHI, events, smoke) and takes ~10 seconds. get_station_epw fetches a published TMYx file from a named station in ~1 second, with no customization — ideal for compliance and reproducibility.

What are the plan requirements for Epwforge?

TMYx/AMY basis generation, UHI, events, and smoke are available on the Starter plan. SSP future‑climate morphing, per‑model ensembles, and compare_scenarios (if it triggers generation) require the Pro plan. find_station, get_station_epw, analyze_epw, and chart tools are free with an API key.

How do compound events work?

When you specify multiple events (e.g., "heatwave,hothumid"), hothumid’s humidity is automatically blended onto the heatwave at 50%. Cold‑family events similarly combine wind onto a cold snap. The primary event intensity slider controls the shape; the secondary is folded into the primary stitch.

What environment variables are required?

EPWFORGE_API_KEY is required — generate one at epwforge.com/account. EPWFORGE_BASE_URL can be set to override the API host (default https://epwforge.com).

Is there a limit on file size?

The server recommends using the save_to parameter to write files to disk instead of returning base64‑encoded content (≈250 KB for a typical year), keeping agent context lean. Tier enforcement returns a 403 if a feature requires a