EPW.tools

io.github.carlobianchi89/epwtoolsVersion 0.5.3

EnergyPlus weather files (EPW, DDY, STAT) and design conditions for any site, OpenStudio-MCP ready.

Status

Responds474 msNov 14, 2026, 14:47 UTCAnswered our handshake without sign-in.

Registry data may be out of date

We could not refresh it, so this page shows the last copy.

Last checked: Nov 14, 2026, 14:47 UTC
Latency: 474 ms
Remotes responding: 1 of 1
Sign-in: No sign-in
Hosting: Hosted outside the EU (detected)
Registry data as of: Nov 14, 2026, 22:14 UTC

Data from the official MCP Registry, checked by run.zero. How we check

Connect

Streamable HTTP

https://epw.tools/api/mcpResponds474 msNov 14, 2026, 14:47 UTC

No sign-in

Claude Code

claude mcp add --transport http epwtools https://epw.tools/api/mcp

Claude Desktop and claude.ai

1
2
3

Settings > Connectors > Add custom connector
Name: epwtools
Remote MCP server URL: https://epw.tools/api/mcp

Cursor

{
  "mcpServers": {
    "epwtools": {
      "url": "https://epw.tools/api/mcp"
    }
  }
}

VS Code

code --add-mcp '{"name":"epwtools","type":"http","url":"https://epw.tools/api/mcp"}'

Streamable HTTP

pypi: epwtools 0.5.3

Package only

PyPI (uvx)

claude mcp add epwtools -e 'EPWTOOLS_API_KEY=<YOUR_EPWTOOLS_API_KEY>' -- uvx epwtools==0.5.3

Replace <YOUR_EPWTOOLS_API_KEY> before running.

Built your own server? run.zero hosts MCP servers on European infrastructure.

Host your own MCP server on run.zero

Tools

9 tools

Tools of EPW.tools
	Description		Read-only	Idempotent	Open world
`analyze_epw`Summary statistics of any public EPW by URL (OneBuilding, EnergyPlus, a shared file): location header, dry-bulb mean/min/max, annual global horizontal irradiation, data range warnings. Free, no key. 10 MB max.	Summary statistics of any public EPW by URL (OneBuilding, EnergyPlus, a shared file): location header, dry-bulb mean/min/max, annual global horizontal irradiation, data range warnings. Free, no key. 10 MB max.	No	Yes	Yes	Yes
`generate_epw`Start an actual-year (AMY) EPW + DDY + STAT for any point, 1990 to last year. 1 credit; +2 with urban_street_level (53 US cities: hourly street-level air temperature from citizen stations). station_id (from get_nearest_stations) builds the year from that station instead of the nearest usable one. Returns a job_id; poll with get_job_result.	Start an actual-year (AMY) EPW + DDY + STAT for any point, 1990 to last year. 1 credit; +2 with urban_street_level (53 US cities: hourly street-level air temperature from citizen stations). station_id (from get_nearest_stations) builds the year from that station instead of the nearest usable one. Returns a job_id; poll with get_job_result.	No	No	No	Yes
`generate_forecast`Start a forecast EPW for the next 1-15 days (operational sims, MPC, demand response). 1 credit; more than 7 days needs an account that has bought credits.	Start a forecast EPW for the next 1-15 days (operational sims, MPC, demand response). 1 credit; more than 7 days needs an account that has bought credits.	No	No	No	Yes
`generate_future_climate`Start a CMIP6-morphed future EPW (Belcher 2005). scenario: ssp126, ssp245, ssp370, ssp585; horizon: any decade 2030-2100; model from list_cmip6_models. 3 credits.	Start a CMIP6-morphed future EPW (Belcher 2005). scenario: ssp126, ssp245, ssp370, ssp585; horizon: any decade 2030-2100; model from list_cmip6_models. 3 credits.	No	No	No	Yes
`generate_tmy`Start a typical meteorological year from a chosen period (at least 5 years; 10-20 is usual). 1 credit.	Start a typical meteorological year from a chosen period (at least 5 years; 10-20 is usual). 1 credit.	No	No	No	Yes
`get_design_conditions`Heating and cooling design conditions for any site, free, in one of two modes that are never mixed. mode="ashrae_method": the ASHRAE Handbook Ch. 14 method replicated at the nearest ASHRAE station for the chosen edition (2025, 2021, 2017, 2013, 2009, 2005); validated about 0.25 degC from the published tables. mode="enhanced": EPW.tools Enhanced, not the ASHRAE method: values at the site itself for today's climate with a tested 90 % range. The DDY file for Enhanced costs 1 credit through the web or the API.	Heating and cooling design conditions for any site, free, in one of two modes that are never mixed. mode="ashrae_method": the ASHRAE Handbook Ch. 14 method replicated at the nearest ASHRAE station for the chosen edition (2025, 2021, 2017, 2013, 2009, 2005); validated about 0.25 degC from the published tables. mode="enhanced": EPW.tools Enhanced, not the ASHRAE method: values at the site itself for today's climate with a tested 90 % range. The DDY file for Enhanced costs 1 credit through the web or the API.	No	Yes	Yes	Yes
`get_job_result`Status of a job started by a generate_* tool; when complete, the download URLs. The links are valid for a short time (see downloads_note); call this tool again for fresh ones.	Status of a job started by a generate_* tool; when complete, the download URLs. The links are valid for a short time (see downloads_note); call this tool again for fresh ones.	No	Yes	Yes	Yes
`get_nearest_stations`Nearest weather stations to a point (name, WMO id, distance, years of record). Free, no key.	Nearest weather stations to a point (name, WMO id, distance, years of record). Free, no key.	No	Yes	Yes	Yes
`list_cmip6_models`The models available for future-climate morphing: `models` are global CMIP6 models (NASA NEX-GDDP, 25 km); `regional` are EURO-CORDEX pairs (12.5 km, Europe only, 27-72 N / 25 W-45 E) usable as `model` ids. Free.	The models available for future-climate morphing: `models` are global CMIP6 models (NASA NEX-GDDP, 25 km); `regional` are EURO-CORDEX pairs (12.5 km, Europe only, 27-72 N / 25 W-45 E) usable as `model` ids. Free.	No	Yes	Yes	Yes

Details

Registry status: Active
Published: Nov 4, 2026
Updated: Nov 4, 2026
Website: https://epw.tools/ai-weather-files⁠ (opens in a new tab)
Repository: https://github.com/carlobianchi89/epwtools-python⁠ (opens in a new tab)
Categories (suggested): Data and analyticsSuggested categories are assigned automatically from the registry text and may be wrong. Verified operators can correct them.
GDPR: Not declared

Are you the operator? Claim this listing