# io.github.guzz-labs/epwforge-mcp (remote · epwforge.com)

EPW/DDY weather files - TMY/AMY/CMIP6 morphing, UHI, events, smoke. 3 of 4 tools anon-free.

- Trust score: 68/100 (medium)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `epwforge.com`: 68/100 (this document), [markdown](https://verifymcp.io/servers/guzz-labs-epwforge-mcp/api-mcp.md), [page](https://verifymcp.io/servers/guzz-labs-epwforge-mcp/api-mcp)
- pypi · `epwforge-mcp`: 5/100, [markdown](https://verifymcp.io/servers/guzz-labs-epwforge-mcp/epwforge-mcp.md), [page](https://verifymcp.io/servers/guzz-labs-epwforge-mcp/epwforge-mcp)

## Channel facts

- Endpoint: `https://epwforge.com/api/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.3.1`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 63/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 6 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 77/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 3234 tokens (~202/item across 16 items; 6 tools + 10 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 99/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 98% of tool parameters carry a description.
- **Capabilities**: 73/100
  - Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28.
  - Supports UI / widget rendering.

## Install

### Claude

```bash
claude mcp add --transport http guzz-labs-epwforge-mcp https://epwforge.com/api/mcp
```

### Codex

```toml
[mcp_servers.guzz-labs-epwforge-mcp]
url = "https://epwforge.com/api/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "guzz-labs-epwforge-mcp": {
      "type": "remote",
      "url": "https://epwforge.com/api/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add guzz-labs-epwforge-mcp --url https://epwforge.com/api/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  guzz-labs-epwforge-mcp:
    url: "https://epwforge.com/api/mcp"
```

### Other

```json
{
  "mcpServers": {
    "guzz-labs-epwforge-mcp": {
      "type": "http",
      "url": "https://epwforge.com/api/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 68, +1)

No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-01 (score 67, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-31 (score 67, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 67, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-28 (score 66, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes. Other categories moved too: Schema Quality & AI Usability rose 1.

### 2026-07-27 (score 65, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 65)

First indexed and scored.

## MCP tools (6)

### `find_station` (~360 tokens)

Search the GuzzStations catalog (17,000+ weather stations worldwide, self-hosted mirror of OneBuilding TMYx). Returns matching stations with EPW URLs ready to pass to analyze_weather or chart_weather. Optionally enriches with AMY extreme years (hottest / coldest / most-humid on record) and CMIP6 climate deltas. No auth required.

Input parameters:

- `country` (string): ISO 3-letter country code filter, e.g. 'USA', 'GBR'
- `include_amy_extremes` (boolean): When true and lat+lon are set, also returns the hottest / coldest / most-humid years on record (per ERA5, 1950–present). Useful for picking AMY basis years.
- `include_climate_deltas` (boolean): When true with lat+lon+ssp+year, also returns the monthly CMIP6 delta-T per month and per variable. Lets agents reason about specific shifts before generating files.
- `lat` (number): Latitude — when set, results sorted by proximity
- `lon` (number)
- `max_results` (integer): Max stations (default: 10)
- `percentile` (integer): Warming percentile (only used with include_climate_deltas, default 50)
- `query` (string): Search by city / state (case-insensitive partial match)
- `ssp` (string): SSP scenario (only used with include_climate_deltas). ssp370 is the recommended high-end; ssp585 (SSP5-8.5) is an opt-in extreme stress-test pathway for worst-case analysis.
- `year` (integer): Future horizon (only used with include_climate_deltas)

### `analyze_weather` (~604 tokens)

Compute design conditions, HDD/CDD, monthly stats, and peak heating/cooling days for one or more EPW files. Accepts a `url` (existing EPW), `urls` (compare 2+), or `config` (synthesize on the fly with morphing/UHI/events/smoke). Config mode runs the full generation pipeline server-side but returns only stats — never the EPW content. **Token-saver: pass `compact: true` to get a ~10-field headline response (~100 tokens) instead of the full ~800-token payload.** Use compact for sanity-checking, dashboards, or when chaining many calls; full when you need monthly arrays / peak days / full ASHRAE. Optional `include_full_ashrae` adds ASHRAE 0.4/1/2% cooling + 99.6/99% heating design conditions with mean coincident dewpoint. Optional `include_improbability` (config mode) adds a stress-test score. Optional `include_idf` adds ready-to-paste EnergyPlus SizingPeriod:DesignDay objects. Optional `units` ('imperial' default | 'metric'). **Presentation: when calling with `urls` (multiple files), the response includes a `comparisons` array — render it as a markdown table to the user. Lead with the headline delta, not the raw data.** No auth required; no credits charged.

Input parameters:

- `compact` (boolean): Return a ~10-field headline-only response (~100 tokens) instead of the full ~800-token payload. Drops monthly arrays, peak days, n_hours, weather_basis blob. Good for sanity checks, dashboards, batch…
- `config` (object): Synthesize an EPW server-side and analyze it. Stats only — file never returned. lat + lon required. Same morph/UHI/event params as generate_weather_file.
- `include_full_ashrae` (boolean): Add ASHRAE 0.4%/1%/2% cooling DB + 99.6%/99% heating DB design conditions to the response. Free. Ignored when compact=true.
- `include_idf` (boolean): Add ready-to-paste EnergyPlus SizingPeriod:DesignDay IDF objects to the response. AEC-facing. Ignored when compact=true.
- `include_improbability` (boolean): Add EPWForge's stress-test improbability score (config mode only). Indicates how extreme the synthesized scenario is vs historical baselines.
- `units` (string): Output units (default: imperial). When 'metric', temperatures are °C, wind m/s, precip mm, distance km/m.
- `url` (string): EPW URL to analyze (single file)
- `urls` (array): Multiple EPW URLs for comparison (first = baseline). Max 10.

### `chart_weather` (~769 tokens)

Render an SVG chart from EPW data. Eight chart types: `diurnal` (~10 KB, monthly hourly profile), `temp_carpet` (heatmap of hour × day-of-year — ~30 KB preview / ~150 KB full), `wind_rose` (~12 KB, polar bars by direction × speed), `monthly_boxplot` (~6 KB, Q1/median/Q3 + whiskers per month), `utci_carpet` (~90 KB, outdoor heat-stress hour × day, colored by UTCI category — Bröde 2012, shaded Tmrt), `economizer_carpet` (~90 KB, air-side economizer free / integrated / locked-out hour × day under ASHRAE 90.1 high-limit), `pv_tilt_azimuth` (~60 KB, annual PV generation across full tilt × azimuth space, isotropic-sky POA at lat from EPW header — optimum orientation marked), `solar_under_events` (~12 KB, weekly GHI of the modified scenario vs the no-overlay reference; bands color event-affected weeks. Requires `config` — server runs the pipeline twice, with and without overlays), `comparison` (~10 KB, design-condition deltas across EPWs). Accepts `url` (single), `urls` (2+ for comparison), or `config` (synthesize on the fly). Config mode is anon-safe — runs pipeline, returns SVG only. No auth required. **Token budget**: SVGs are returned inline by default. Large outputs (>50 KB) auto-upload to Blob storage (when configured) and return a URL instead, keeping your context lean. Always check `svg_size_kb` in the response. **Presentation: when handing the chart to the user, just link or embed it — don't narrate what's in it. Let the chart speak.**

Input parameters:

- `chart_type` (string): Default: diurnal
- `config` (object): Synthesize an EPW and chart it. Same params as generate_weather_file. SVG only — no file delivery.
- `econ_high_limit_f` (number): economizer_carpet only. ASHRAE 90.1 high-limit shutoff. Defaults: 75°F (drybulb mode) or 28 BTU/lb (enthalpy mode).
- `econ_mode` (string): economizer_carpet only. 'drybulb' (default) limits OA by Tdb; 'enthalpy' limits by moist-air enthalpy — more honest in humid climates (captures latent load).
- `econ_supply_air_f` (number): economizer_carpet only. Supply-air temperature setpoint (°F). Default 55.
- `pv_azimuth` (number): pv_tilt_azimuth only. Optional — marks the user's planned compass azimuth (deg, 0=N, 180=S) on the heatmap.
- `pv_tilt` (number): pv_tilt_azimuth only. Optional — marks the user's planned tilt (deg, 0=horizontal) on the heatmap alongside the optimum.
- `resolution` (string): temp_carpet only. 'preview' (default) ~30 KB with 32 color buckets — visually identical at typical render sizes. 'full' ~150 KB with per-cell rgb() — use only when saving to file or when you specific…
- `url` (string): EPW URL (single-EPW charts: diurnal, temp_carpet, wind_rose, monthly_boxplot, utci_carpet, economizer_carpet, pv_tilt_azimuth)
- `urls` (array): EPW URLs for chart_type=comparison (first = baseline)

### `explore_design_conditions` (~291 tokens)

Interactive single-site design-conditions explorer. Returns full ASHRAE design conditions + diurnal chart for the requested scenario. In MCP Apps-capable hosts (Claude Desktop, ChatGPT, VS Code, Goose), the response renders as a widget with sliders for SSP / year / percentile / UHI — dragging a slider re-calls this tool live. Use when a user wants to interactively tune a single site. For multi-site comparison, use analyze_weather(urls=[...]) instead. Defaults to present-day TMY (no morph) — pass ssp+year for future scenarios. P75 default percentile is design-realistic; P50 underestimates the tail. No auth required.

Input parameters:

- `allow_custom_location` (boolean): Required when no OneBuilding station within 50 km
- `lat` (number, required): Latitude, decimal degrees
- `lon` (number, required): Longitude, decimal degrees
- `percentile` (integer): Warming percentile. P75 design-realistic; P50 median.
- `ssp` (string): CMIP6 emission scenario. Omit for present-day TMY. ssp370 is the recommended high-end; ssp585 (SSP5-8.5) is an opt-in extreme stress-test pathway for worst-case analysis.
- `uhi` (string): Urban Heat Island preset
- `year` (integer): Future horizon. Pair with ssp.

### `generate_weather_file` (~702 tokens)

Generate and deliver an EPW or DDY file. A paid tool — charges credits per call: 1 for a single file, 1 per scenario for a scenarios batch (max 10), 10 for a per-model CMIP6 ensemble. Requires auth (Bearer API key or OAuth). Credits come from a Forge pass ($9.99/wk = 2 non-expiring credits, or $99/yr) or a top-up pack; see the epwforge://catalog/pricing resource. No account? Buy a fixed-price guest bundle — see preview_forge_bundle. For free analysis without credits, use analyze_weather or chart_weather on a real published EPW URL.

Input parameters:

- `amy_year` (integer): Year for AMY basis
- `basis` (string): Weather file basis (default: tmy)
- `ensemble` (boolean): Generate a per-model CMIP6 ensemble (~20 EPWs, one per climate model). Costs 10 credits. Requires ssp + year.
- `event_duration` (integer): Event length in days (3-30, default 14). **For stress-test scenarios use 14-21 days** — shorter durations don't capture sustained operational impact (charging schedules, occupancy patterns, equipment…
- `events` (string): Comma-separated events. Valid: heatwave, coldsnap, hothumid, coldwindy. Pairs auto-compound (heat+humid, cold+wind).
- `format` (string): Output format (default: epw)
- `include_ddy` (boolean): When format=epw, also include the matching DDY in the response (single-file only).
- `intensity` (string): Per-event "type:1-7" intensity (1-10 with stress_test=true). 5 = typical extreme, 7 = severe ~50-yr return.
- `intensity_auto` (boolean): Auto-fill unspecified intensities from IPCC AR6 (default: true)
- `lat` (number, required): Latitude, decimal degrees
- `lon` (number, required): Longitude, decimal degrees
- `percentile` (integer): Warming percentile (default: 50)
- `scenarios` (array): Batch mode — array of configs, each generated in parallel. Same shape as the top-level config. When set, top-level config params are ignored. Costs 1 credit per scenario (up to 10).
- `smoke` (boolean): Enable wildfire smoke overlay
- `smoke_duration` (integer): Smoke days (3-30, default: 7)
- `smoke_intensity` (integer): Smoke severity 1-10 → peak AOD 0.1-6.0
- `ssp` (string): CMIP6 emission scenario. ssp370 is the recommended high-end for design; ssp585 (SSP5-8.5) is an opt-in extreme stress-test pathway (~4.4°C, low likelihood per IPCC AR6 / CMIP7) for worst-case analysi…
- `stress_test` (boolean): Unlock intensity 8-10. Default false.
- `tmy_period` (string): TMYx vintage. Default 2011-2025.
- `uhi` (string): Urban Heat Island preset
- `year` (integer): Future horizon

### `preview_forge_bundle` (~151 tokens)

Preview a fixed-price Forge bundle for a location — the no-account way to buy weather files. Returns the exact scenario breakdown, file count, price, and a purchase link the user opens for guest checkout. Bundles: Carbon (10 scenarios), Titanium (30), Damascus (64); each scenario delivered as EPW + DDY + STAT + PVsyst. Free, no auth, creates no order.

Input parameters:

- `bundle_id` (string, required): Which bundle to preview.
- `lat` (number): Site latitude (optional — for a location-specific summary).
- `location` (string): Optional human label for the site, e.g. 'Boston, MA'.
- `lon` (number): Site longitude.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/guzz-labs-epwforge-mcp/api-mcp#diagnostics

## Score history

- 2026-08-03: 68
- 2026-08-02: 68
- 2026-08-01: 67
- 2026-07-31: 67
- 2026-07-29: 67
- 2026-07-28: 66
- 2026-07-27: 65
- 2026-07-26: 65

## Links

- Remote endpoint: https://epwforge.com/api/mcp
- Repository: https://github.com/guzz-labs/epwforge-mcp
- Website: https://epwforge.com/
- Changelog RSS feed: https://verifymcp.io/servers/guzz-labs-epwforge-mcp/api-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/guzz-labs-epwforge-mcp/api-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/guzz-labs-epwforge-mcp/api-mcp