Skip to content
MCP server

EPW.tools

Generate EnergyPlus EPW, DDY and STAT weather files for any site from your assistant

Install
Pricing
Freemium
Platforms
CLI, API
Runs
Locally or Remotely
Version
0.5.5
Listing updated
3 days ago

About EPW.tools

EPW.tools is a freemium MCP server for health and science. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://epw.tools/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "epwtools": {
      "url": "https://epw.tools/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • EPWTOOLS_API_KEYYour EPW.tools API key (free credits on signup at https://epw.tools)Required

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium

Free credits on signup, then credit-based; some tools free without a key

Prices change. Check epw.tools before you buy.

EPW.tools 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 to EPW.tools

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools