# epwforge-mcp

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add guzz-labs/epwforge-mcp

# Browse available tools
npx -y smithery tool list guzz-labs/epwforge-mcp

# Get full schema for a tool
npx -y smithery tool get guzz-labs/epwforge-mcp find_station

# Call a tool
npx -y smithery tool call guzz-labs/epwforge-mcp find_station '{}'
```

## Direct MCP Connection

Endpoint: `https://epwforge-mcp--guzz-labs.run.tools`

## Tools (4)

- `find_station` — Search the GuzzStations catalog (17,000+ weather stations worldwide, self-hosted mirror of OneBuilding TMYx). Returns m…
- `analyze_weather` — Compute design conditions, HDD/CDD, monthly stats, and peak heating/cooling days for one or more EPW files. Accepts a `…
- `chart_weather` — Render an SVG chart from EPW data. Five chart types: `diurnal` (~10 KB, monthly hourly profile), `temp_carpet` (heatmap…
- `generate_weather_file` — Generate and deliver an EPW or DDY file. The only paid tool — charges credits per call: 1 for a single file, 2 for a 4-…

```bash
# Get full input/output schema for a tool
npx -y smithery tool get guzz-labs/epwforge-mcp <tool-name>
```

## Resources

- `epwforge://catalog/ssp-scenarios` — Valid combinations of CMIP6 emission scenario, future horizon, and warming percentile for SSP morphing.
- `epwforge://catalog/uhi-presets` — Stewart & Oke 2012 LCZ-derived UHI intensities for urban classes.
- `epwforge://catalog/event-types` — Event types valid for the `events` param; auto-compound pairs; intensity scale.
- `epwforge://catalog/tmy-periods` — Available vintages for synthesized TMYx files.
- `epwforge://catalog/credit-costs` — Per-action credit costs for generate_weather_file. Read tools (find_station, analyze_weather, chart_weather) are always…
- `epwforge://methodology/overview` — Short reference on how EPWForge synthesizes and morphs weather data.

## Prompts (5)

- `climate-stress-test` (location, horizon) — Run a climate stress test on a building location: baseline + future + extreme-event scenarios with comparison.
- `future-cooling-load` (location, ssp, year) — Estimate how a building's cooling design will change between today and a future horizon under a chosen SSP.
- `site-weather-overview` (location) — Get a quick visual + numeric overview of a location's climate.
- `compare-sites` (locations, ssp, year) — Compare 2+ candidate locations for climate resilience under a future scenario.
- `energyplus-design-days` (location, scenario) — Generate EnergyPlus SizingPeriod:DesignDay IDF objects for a location and scenario.