carlobianchi89Python client, CLI and MCP server for EPW.tools: EnergyPlus weather files (EPW, DDY, STAT) for any
Python client, CLI and MCP server for EPW.tools: EnergyPlus weather files (EPW, DDY, STAT) for any location, past years, typical years and future climate
epwtools
Python client, command-line tool and MCP server for EPW.tools: EnergyPlus weather files (EPW, with DDY design days and STAT summaries) for any location on Earth.
- Actual years from 1990 to now, for any coordinates, with or without a nearby weather station
- Typical years (TMY), extreme and heatwave years
- Future climate for 2030 to 2100 under SSP scenarios
- Design conditions (ASHRAE method) and short-term forecast weather files
The weather data are built and validated by EPW.tools (methodology, validation); this package is the open-source way to call them from Python, the terminal or an AI assistant.
Install
pip install epwtools # client + CLI
pip install 'epwtools[mcp]' # + MCP server for AI assistantsGet a free API key at epw.tools (API tab); the first files are free.
export EPWTOOLS_API_KEY=your-keyPython
from epwtools import EPWClient
client = EPWClient() # reads EPWTOOLS_API_KEY
# actual year 2023 for a site in Denver
epw = client.generate(lat=39.74, lon=-104.99, year=2023, name="Denver", out_dir="weather")
# typical year built from 2005-2024
tmy = client.tmy(lat=45.46, lon=9.19, start=2005, end=2024, name="Milan", out_dir="weather")
# design conditions (ASHRAE method)
dc = client.design_conditions(lat=51.51, lon=-0.13)Command line
epwtools configure # store your key
epwtools generate --lat 39.74 --lon -104.99 --year 2023 --name Denver
epwtools tmy --lat 45.46 --lon 9.19 --start 2005 --end 2024 --name Milan
epwtools future --lat 40.71 --lon -74.01 --scenario ssp245 --horizon 2050 --name NYC
epwtools --helpAI assistants (MCP)
Let Claude, ChatGPT and other MCP-capable assistants make weather files for you:
uvx --from 'epwtools[mcp]' epw-tools-mcpor use the hosted server, listed in the official MCP Registry. Tools include generate_epw, generate_tmy,
generate_future_climate, generate_forecast, get_design_conditions and get_nearest_stations.
Setup guide: epw.tools/ai-weather-files.
Also on EPW.tools (web)
EPW to CSV / Excel converter · Manual J design temperatures by address · Construction weather days · Data-centre site climate · API licence for software vendors
Licence
The client, CLI and MCP server in this repository are MIT-licensed. Use of the EPW.tools service and its data is governed by the EPW.tools terms of service (linked in the footer of epw.tools).
Install with your agent
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/epwtools to learn what the "epwtools" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
From the project README
pip install epwtools
pip install 'epwtools[mcp]'uvx --from 'epwtools[mcp]' epw-tools-mcpThis server runs locally, so we can't read its tool list over the web yet.
We could not run this server: it ships no npx package for our sandbox and no public endpoint. The four checks that need a live server are left out, and the grade tops out at B until one exists.
What's missing
- Easy installA paste-ready client config (an mcpServers block) is documented.0/12
All 5 checks (4 passed)
- Installation methodRequiredThe README documents at least one way to install or connect.15/15
- Has a READMERequiredThe repository ships documentation we could read.10/10
- Easy installA paste-ready client config (an mcpServers block) is documented.0/12
- Has a licenseThe repository declares a license.8/8
- Claimed by ownerThe maintainer proved ownership of this listing.4/4
- Verified liveNot checkableWe connected to the server and it answered a real MCP handshake.—
- Exposes toolsNot checkableThe server reports at least one tool, from its manifest or a live read.—
- Ships promptsNot checkableThe server exposes at least one prompt template.—
- Ships resourcesNot checkableThe server exposes at least one resource.—
Show this grade in your README
Paste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/epwtools)Alternatives to epwtools
Nothing comparable is listed yet.
No tagged releases on record.
Send this prompt to your agent to leave a review
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "epwtools" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
Subscribe to our newsletter
One email a week. New agents, MCP servers and skills, and what is actually getting traction.