Click to connect EPWForge to Claude, Cursor, or any MCP-aware client.
Hey Claude,
How hot will my Phoenix project be in 2090?
The EPWForge MCP server lets Claude (and Cursor, and any MCP-aware client) generate, analyze, and chart simulation-ready weather files from natural-language prompts — TMY, AMY, CMIP6 future morphing, UHI, extreme events, wildfire smoke, and EnergyPlus DesignDay IDF blocks, all from the engine behind epwforge.com.
Four tools. Three work without authentication. Anyone can search stations, analyze any EPW, or chart a synthesized future-climate scenario — no signup, no credits.
Add this to your Claude Desktop / Claude Code / Cursor MCP config. Three of the four tools (find_station, analyze_weather, chart_weather) work immediately — no credentials needed.
Auto-detects your client config and wires everything up:
uvx epwforge-mcp install --api-key sk_live_...
Hosted (for claude.ai web users)
Browser-based Claude can't run local MCP processes. Add this URL as a Custom MCP Server instead — same 4 tools, same anon access:
https://epwforge.com/api/mcp
The four tools
find_stationNo auth · free
Search the GuzzStations catalog (17,000+ weather stations worldwide). Optional flags surface AMY extreme years (hottest/coldest/most-humid on record) + monthly CMIP6 deltas for a given SSP/year. Returns ready-to-use epw_url fields.
analyze_weatherNo auth · free
Design conditions, HDD/CDD, monthly stats, peak days for any EPW URL — or a synthesized config (full morph/UHI/event/smoke pipeline runs server-side, stats only returned). Optional `include_full_ashrae` (0.4/1/2% values), `include_idf` (paste-ready EnergyPlus DesignDay), `include_improbability` (stress-test score), `units` (imperial/metric).
chart_weatherNo auth · free
5 SVG chart types: diurnal hourly profile, temp_carpet (8760-cell heatmap), wind_rose, monthly_boxplot, comparison delta bars. Accepts URL(s) or a synthesized config. Brand-themed SVGs; >50 KB outputs auto-upload to Blob so your agent context stays lean.
generate_weather_fileAuth · credits
Generates and delivers EPW or DDY. Single file (1 credit), scenarios batch up to 10 (1 credit each), or per-model CMIP6 ensemble (10 credits). Requires API key — free signup gets 5 welcome credits.
Resources browsable in claude.ai's connector UI
Reference docs the agent can read at any time without a tool call. Catalog of valid params, presets, and how to format results — minimizes "what values are valid for X" reasoning loops.
epwforge://catalog/ssp-scenariosValid SSP × year × percentile combinations
epwforge://methodology/overviewShort reference on the morphing + event pipeline + known limitations
epwforge://guidelines/response-styleHow to format results back to the user (tables for comparisons, headline-first, etc.)
Prompts pre-built workflow templates
One-click workflows in claude.ai's prompt picker. Each runs a coordinated multi-tool sequence — useful for "I know what I want to do but not the exact tool call ordering."
climate-stress-testBaseline + future + worst-case scenarios at a location, with comparison chart
future-cooling-loadCooling design DB shift between today and a chosen future horizon
site-weather-overviewQuick numeric + visual overview of any location
compare-sitesRank 2–10 candidate sites by climate resilience under a future SSP