Log inSubmit server
Epwforge MCP logo

Epwforge MCP

Generate, analyze, chart, and download EPW, DDY, CSV, ZIP, and PVsyst weather files through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Epwforge MCP

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "epwforge-mcp": {
      "command": "uvx",
      "args": [
        "epwforge-mcp"
      ],
      "env": {
        "EPWFORGE_API_KEY": "YOUR_VALUE_HERE",
        "EPWFORGE_BASE_URL": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The epwforge-mcp MCP server connects AI agents to EPWForge for weather-station search, EPW analysis, SVG charting, and weather-file generation. It can find among roughly 17,000 stations, analyze existing files or synthesize scenario statistics from coordinates, and generate weather files with climate, UHI, and event modifications. Read-only operations require no API key, while generated files consume credits and require authentication. Use it for building-energy simulation workflows involving TMYx, AMY, CMIP6 scenarios, design conditions, or extreme-weather stress tests.

Use cases

  • Find nearby TMYx stations for a building project
  • Compare weather files across multiple cities
  • Analyze future climate and urban-heat scenarios
  • Generate EPW, DDY, CSV, ZIP, or PVsyst files
  • Chart thermal, wind, solar, or comfort conditions

Key features

  • Searches a catalog of roughly 17,000 weather stations
  • Analyzes single files, file comparisons, and synthesized scenarios
  • Returns inline SVG weather charts
  • Applies CMIP6, UHI, and extreme-event modifications
  • Generates EPW, DDY, CSV, ZIP, and PVsyst downloads
  • Supports all-SSP ensemble generation

Tools4

What Epwforge MCP lets your agent do. Expand a tool for its parameters.

Self-reported~223 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

Not checked yetLast checked Today

We have not completed a health check for this listing yet.

7/15 checks healthy over the last 43d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 1d ago via OSV.dev · epwforge-mcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

Last commit4mo agoMost recent push to the default branch.
Tools exposed4Callable tools this server registers over MCP.

How Epwforge MCP works

What epwforge-mcp MCP server does

The epwforge-mcp MCP server exposes EPWForge weather-data operations to MCP-compatible AI clients. It supports workflows for EnergyPlus, OpenStudio, IES VE, eQUEST, and other tools that consume weather files. The service can work with published TMYx station data or synthesize weather scenarios for coordinates.

Its source data and scenario features cover TMYx generation from ERA5 reanalysis, historical AMY years from 1950 onward, CMIP6 SSP projections, urban heat-island adjustments, and injected events such as heatwaves, cold snaps, hot-humid conditions, cold-windy conditions, and wildfire smoke. Generated outputs can include EPW, DDY, CSV, ZIP, and PVsyst formats.

How it works

Four MCP tools provide the interface:

  • find_station searches the GuzzStations catalog by station name, country, or coordinates. The optional compact response returns only the newest TMYx for each station.
  • analyze_weather summarizes one EPW, compares two to ten URLs, or calculates statistics for a scenario supplied as coordinates and configuration. Configuration mode returns statistics rather than EPW content.
  • chart_weather returns inline SVG charts for temperature, wind, solar, UTCI, economizer conditions, monthly distributions, and comparisons. Large charts may be returned through a URL instead.
  • generate_weather_file creates a downloadable file using the selected morphing options. It also supports bundles and an all-SSP ensemble mode.

Analysis can include ASHRAE design conditions, improbability metrics, and IDF output when requested. Scenario inputs can specify an SSP, year, warming percentile, UHI preset, event type, intensity, duration, and smoke settings.

Setup and configuration

Install the Python package with pip install epwforge-mcp, or run it with uvx epwforge-mcp. Python 3.10 or newer is required. A local MCP client can start the epwforge-mcp command and optionally pass EPWFORGE_API_KEY in its environment. EPWFORGE_BASE_URL can replace the default API host, primarily for testing against another backend.

find_station, analyze_weather, and chart_weather work without authentication. generate_weather_file requires an API key and available credits. The hosted equivalent is available at https://epwforge.com/api/mcp for browser-based MCP clients.

Limitations and notes

The epwforge-mcp MCP server does not return EPW content from station search or analysis operations. Configuration-based analysis also keeps the synthesized file server-side and returns statistics only. Use generate_weather_file when the actual downloadable artifact is needed.

Credit usage applies only to generation. A single EPW, DDY, CSV, or PVsyst file costs one credit; bundles and all-SSP generation can cost two credits, while CMIP6 ensemble generation is charged per model at ten credits. Calls made without sufficient credits return an HTTP 402 surfaced as an MCP ToolError with a hint.

The server uses consolidated tools. Older operations such as design-day generation, ensemble generation, EPW analysis, and scenario comparison are now reached through parameters on the four current tools. Exact parameters and behavior are documented at EPWForge’s documentation site, in the package tool docstrings, and through the running server’s tools/list response.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Epwforge MCP

epwforge-mcp is an MCP server that connects AI agents to EPWForge for weather-data workflows. Its main tools search weather stations, analyze EPW files or synthesized scenarios, render SVG charts, and generate downloadable EPW, DDY, CSV, ZIP, or PVsyst files. Read-only tools work without authentication; file generation requires an API key and credits.

Install it with `pip install epwforge-mcp` or run it with `uvx epwforge-mcp`. Python 3.10 or newer is required. Configure your MCP client to launch the `epwforge-mcp` command, and add `EPWFORGE_API_KEY` only if the agent must generate downloadable files.

Yes, epwforge-mcp works with Cursor through its MCP settings. Configure Cursor to launch the `epwforge-mcp` command and optionally provide `EPWFORGE_API_KEY`. Station search, analysis, and charting do not require a key, while file generation requires authentication and credits.

epwforge-mcp can generate EPW, DDY, CSV, ZIP, and PVsyst outputs. ZIP bundles can include multiple weather-related files, and the generation tool also supports ensemble requests across SSPs. The exact output depends on the selected format and scenario parameters.

Related MCP servers

All in Environment & Nature All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewEpwforge MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/epwforge-mcp?style=directory)](https://allmcps.com/mcp/epwforge-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/epwforge-mcp"><img src="https://allmcps.com/api/badge/epwforge-mcp?style=directory" alt="Epwforge MCP on AllMCPs" /></a>