EPW.tools

io.github.carlobianchi89/epwtoolscarlobianchi89streamable-httpv0.5.3Scanned 2 hours ago

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

9 tools: 4 change things and 5 only read.

Reads private data · 1
Reads text others write · 9
Can send data out · 1
No findings

Tools listed without sign-in. Remote posture

Anlyon alternative

4 of these tools change something. Run those as governed actions.

Declare what an action changes, and Anlyon puts it under a shared limit, binds every approval to the exact request, and grades the outcome. It works on any HTTPS API you can describe as an action.

Anlyon does not run, proxy or govern this MCP server. A tool your own code calls directly is not routed through Anlyon and is not governed by it.

Import an OpenAPI spec →

Tools

Grouped by what each tool does, most consequential first. Open one for its reasons and full description; descriptions are the publisher's own words.

9 tools

Changes things 4Creates or changes something that can be changed back.Claude Code: ask

generate_epwStart an actual-year (AMY) EPW + DDY + STAT for any point, 1990 to last year.Reads text others writeNo findings
Why it is in this group
- The name "generate_epw" says "generate": a word for a change.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it
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). Returns a job_id; poll with get_job_result.
Annotations the server declares
- title: Generate actual-year EPW (AMY)
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
generate_forecastStart a forecast EPW for the next 1-15 days (operational sims, MPC, demand response).Reads text others writeNo findings
Why it is in this group
- The name "generate_forecast" says "generate": a word for a change.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it
Start a forecast EPW for the next 1-15 days (operational sims, MPC, demand response). Up to 7 days free.
Annotations the server declares
- title: Generate forecast EPW
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
generate_future_climateStart a CMIP6-morphed future EPW (Belcher 2005).Reads text others writeNo findings
Why it is in this group
- The name "generate_future_climate" says "generate": a word for a change.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it
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.
Annotations the server declares
- title: Generate future-climate EPW (CMIP6)
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
generate_tmyStart a typical meteorological year from a chosen period (at least 5 years; 10-20 is usual).Reads text others writeNo findings
Why it is in this group
- The name "generate_tmy" says "generate": a word for a change.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it
Start a typical meteorological year from a chosen period (at least 5 years; 10-20 is usual). 1 credit.
Annotations the server declares
- title: Generate typical year (TMY)
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true

Only reads 5Looks things up and changes nothing.Show 5 read-only tools

analyze_epwSummary 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 warni…Reads private dataReads text others writeCan send data outNo findings
Why it is in this group
- The name "analyze_epw" says "analyze": a word for reading.
What it can reach
- private-dataThe description's first sentence says "file": it reads files.
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
- untrusted-inputThe description's first sentence says "url": it reads web pages, which anyone can write.
- untrusted-inputThe input takes a URL (input.url), and the tool reads it: it reads web pages, which anyone can write.
- outboundThe input takes a URL (input.url): a request to a URL can carry data to whoever runs it.
Claude Code: ask, because it is tagged outbound.
Description, as the server wrote it
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.
Annotations the server declares
- title: Analyze an EPW by URL
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
get_design_conditionsHeating and cooling design conditions for any site, free, in one of two modes that are never mixed.Reads text others writeNo findings
Why it is in this group
- The name "get_design_conditions" says "get": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it
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.
Annotations the server declares
- title: Design conditions (ASHRAE method or EPW.tools Enhanced)
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
get_job_resultStatus of a job started by a generate_* tool; when complete, the download URLs (they carry the key).Reads text others writeNo findings
Why it is in this group
- The name "get_job_result" says "get": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it
Status of a job started by a generate_* tool; when complete, the download URLs (they carry the key).
Annotations the server declares
- title: Job status and download links
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
get_nearest_stationsNearest weather stations to a point (name, WMO id, distance, years of record).Reads text others writeNo findings
Why it is in this group
- The name "get_nearest_stations" says "get": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it
Nearest weather stations to a point (name, WMO id, distance, years of record). Free, no key.
Annotations the server declares
- title: Nearest weather stations
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
list_cmip6_modelsThe 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…Reads text others writeNo findings
Why it is in this group
- The name "list_cmip6_models" says "list": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it
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.
Annotations the server declares
- title: CMIP6 models for future climate
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Exfil surface

Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.

9 paths in this server alone from private data, through text someone else wrote, to a way out. Denying 1 outbound tool breaks every one.

Reads private data1: Reads files, mail, messages, databases, secrets, calendars or repositories.; analyze_epw
Reads text others write9: Brings in text someone else can write: web pages, inbound email, messages, issues and comments.; analyze_epw
generate_epw
generate_forecast
generate_future_climate
generate_tmy
get_design_conditions
get_job_result
get_nearest_stations
list_cmip6_models
Can send data out1: Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.; analyze_epw

deny to break every path

{
  "permissions": {
    "deny": [
      "mcp__epwtools__analyze_epw"
    ]
  }
}

Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.

Remote posture

What anyone on the internet sees at the remote endpoint: an anonymous initialize and tools/list, and the public OAuth metadata.

Tools listed without sign-in

Looked at Nov 4, 2026, 02:19 UTC, unchanged since Nov 4, 2026. No credentials were sent and no tool was called. What is looked at.

Reachable: yes
HTTP status of an anonymous initialize: 200
tools/list served without credentials: yes
Tools that change things, listed without credentials: 4
Protocol version: 2025-06-18
WWW-Authenticate on 401: not observed
resource_metadata in WWW-Authenticate: not observed
RFC 9728 protected resource metadata: not observed
Authorization servers: not observed
Legacy HTTP+SSE transport: no
Dynamic client registration: not observed
Client ID metadata documents: not observed

WarnThe whole server
The endpoint served tools/list without credentials, and the list has 4 tools that change things (4 write). Whether a call also works without credentials was not tested: tools are never called.
Matched text
https://epw.tools/api/mcp: tools/list returned 9 tools to an anonymous client, including generate_epw (write), generate_tmy (write), generate_future_climate (write), generate_forecast (write)
What this check looks for

Findings

Matches of fixed checks, with the text they matched.

No check matched anything in these tool definitions. That is not a safety guarantee.

History

Changes to its tool definitions and to its remote endpoint, newest first.

No change seen yet. Its tools are rescanned every day, and a remote endpoint is looked at once a week.

All changes to this server

Install

Pinned to version 0.5.3. Values in angle brackets are yours to fill in.

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

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

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json

{
  "permissions": {
    "allow": [
      "mcp__epwtools__get_nearest_stations",
      "mcp__epwtools__get_design_conditions",
      "mcp__epwtools__list_cmip6_models",
      "mcp__epwtools__get_job_result"
    ],
    "ask": [
      "mcp__epwtools__analyze_epw",
      "mcp__epwtools__generate_epw",
      "mcp__epwtools__generate_tmy",
      "mcp__epwtools__generate_future_climate",
      "mcp__epwtools__generate_forecast"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as epwtools. Review it before you use it.

Capability tags behind 9 rules

mcp__epwtools__get_nearest_stations untrusted-input
mcp__epwtools__get_design_conditions untrusted-input
mcp__epwtools__list_cmip6_models untrusted-input
mcp__epwtools__analyze_epw private-data, untrusted-input, outbound
mcp__epwtools__generate_epw untrusted-input
mcp__epwtools__generate_tmy untrusted-input
mcp__epwtools__generate_future_climate untrusted-input
mcp__epwtools__generate_forecast untrusted-input
mcp__epwtools__get_job_result untrusted-input

Keep the decision: fail CI when the tools change, follow every change, or show a badge.

Pin in CI

Fail a build when the tools you reviewed are not the tools the server serves today.

curl -s "https://anlyon.dev/api/v1/servers/io.github.carlobianchi89/epwtools/verify?hash=307a79eab4dacbcb2000cdc67e19924dabdf68038820326e9433b7f9fa4da2c0" | jq -e '.changed == false'

Pinned hash 307a79eab4da, from Nov 4, 2026, 02:18 UTC.

Watch

Get told when its tools change: a new tool, a new description, a new class.

https://anlyon.dev/servers/io.github.carlobianchi89/epwtools/changes.xml

An Atom feed. Works in any feed reader or Slack's RSS app.

Badge

[![anlyon.dev](https://anlyon.dev/badge/io.github.carlobianchi89/epwtools.svg)](https://anlyon.dev/servers/io.github.carlobianchi89/epwtools)

Source: MCP Registry · repository. Synced Nov 4, 2026, 03:17 UTC.