# EPW.tools

> EPW.tools is a freemium MCP server for health and science. Generate EnergyPlus EPW, DDY and STAT weather files for any site from your assistant. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://epw.tools/ai-weather-files
- **Repository:** https://github.com/carlobianchi89/epwtools-python
- **MCP Registry name:** io.github.carlobianchi89/epwtools
- **Categories:** health and science, developer tools
- **Listing updated:** 2026-11-14

## About

Each generation tool writes the EPW, DDY and STAT files into a folder you name, ready to simulate. You can ask for an actual meteorological year, a typical year for design, CMIP6 morphed future climate for 2050 or 2080, or a forecast of the next 1 to 15 days. Design conditions use either the ASHRAE method or the site's own Enhanced approach.

It pairs with NLR's OpenStudio-MCP: the vendor tested a chain where an assistant fetched weather for Lugano, then built, sized and simulated a small office. A tip from the site says to name an explicit ASHRAE climate zone when using openstudio-mcp v1.2.1.

Most files cost one credit and a future-climate file three, and new accounts get free credits. Nearest-station lookup and design conditions are free without a key. The Python client, CLI and MCP server are MIT licensed.

## Features

- **Actual years:** Weather files for any coordinates and year from 1990.
- **Typical years:** TMY files for design work.
- **Future climate:** CMIP6 morphed scenarios for 2050 and 2080.
- **Short forecasts:** Simulation-ready EPW for the next 1 to 15 days.
- **Design conditions:** Heating and cooling design days by two methods.
- **Station lookup:** Find nearby NOAA stations for a coordinate.

## Good for

- Fetch a 2023 weather file for a building model
- Run the same building in a 2050 climate
- Size HVAC with Enhanced design days
- Check weather at a site before a simulation

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://epw.tools/api/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "epwtools": {
      "type": "http",
      "url": "https://epw.tools/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "epwtools": {
      "serverUrl": "https://epw.tools/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "epwtools": {
      "type": "http",
      "url": "https://epw.tools/api/mcp"
    }
  }
}
```

## Tools

- `generate_epw`: Actual-meteorological-year EPW for a location and year.
- `generate_tmy`: Typical meteorological year for design.
- `generate_future_climate`: CMIP6 morphed future scenarios for 2050 and 2080.
- `generate_forecast`: Next 1 to 15 days as an EPW.
- `get_design_conditions`: Heating and cooling design conditions.
- `get_nearest_stations`: NOAA stations near a coordinate.
- `get_job_result`: Download links for a completed job.

## FAQ

### What does a file cost?

Most use one credit and a future-climate file uses three; new accounts start with free credits.

### Which tools are free?

Nearest stations, design conditions with the ASHRAE method, the model list and analysis of public EPWs work without a key.

### Can it work with OpenStudio?

Yes, the site documents running it with OpenStudio-MCP.

### Is the client open source?

The client, CLI and MCP server are MIT licensed; the service has its own terms.

### Is EPW.tools free?

EPW.tools has a free plan, with paid plans for more usage or features.

### How do I add EPW.tools to Claude Code?

Run this command in your terminal: claude mcp add --transport http epwtools https://epw.tools/api/mcp

### What are the best alternatives to EPW.tools?

The closest alternatives to EPW.tools are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.

---
Source: https://ai-powered.com/mcp/epw-tools
