Iso Ne

@pipeworx/iso-ne

通过 ISO New England Web 服务获取 ISO New England 市场数据——为新英格兰六州（CT、MA、ME、 NH、RI、VT）提供五分钟 LMP、系统负荷和发电燃料结构数据。

属于 Pipeworx——一个将 AI Agent 连接到 1882+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供方无关联，未经其认可，也非其发布。

工具

• isone_lmp(location_id?, date?, limit?) — 五分钟实时 LMP，包含能源、拥塞和损耗分项。省略 date 时使用当前时段。
• isone_load(date?, limit?) — 五分钟系统总负荷，单位为 MW。
• isone_fuel_mix(date?, limit?) — 按燃料类别统计的发电量（天然气、核能、水电、风能、太阳能、垃圾、木材、煤炭、石油、填埋气、进口电力），并包含边际燃料标记。

身份验证

目前仅支持自带凭据（BYO）。 使用 HTTP Basic 身份验证访问 webservices.iso-ne.com。 平台备用环境变量——尚未配置：PLATFORM_ISONE_KEY。

可在 https://www.iso-ne.com/participate/applications-status-changes/ 免费注册（需要“ISO Express / Web Services”账户），但 ISO-NE 会先审批账户，之后凭据才能生效。新注册的账户会像密码错误一样遭到拒绝，因此该工具包的 401 提示会指出需要等待审批，而不是暗示密码错误。

_apiKey 接受以下任一格式：

• "username:password" — 明文；工具包会对其进行 Base64 编码。
• base64("username:password") — 预先编码，采用与 seo-serp 相同的约定。

其他格式会在本地明确报错，而不会变成看似服务中断的上游 401 错误。

**使用一个环境变量，而非 PLATFORM_ISONE_USER + PLATFORM_ISONE_PASS：**网关会为每个工具包准确注入一个密钥，写入 _apiKey。因此，存储的凭据就是 Basic 方案实际需要的单个字符串。workers/gateway/src/pack-manifest.json 中将该工具包标记为 byoExpected: true，以避免供应商密钥检查阻止部署；凭据配置完成当天就移除该标记。

数据来源

• https://webservices.iso-ne.com/api/v1.1/ — 需要身份验证的 API。 /fiveminutelmp/current、/fiveminutesystemload/current、/genfuelmix/current， 以及用于获取历史日期数据的 /…/day/YYYYMMDD。
• https://www.iso-ne.com/isoexpress/ — 基于相同数据的公共浏览器界面。

注意事项

• 没有无需密钥的备用方案。已实际验证，并非推测。 于 2026-09-17 进行探测，以下请求均遭拒绝：
  • webservices.iso-ne.com/api/v1.1/fiveminutesystemload/current → 401
  • www.iso-ne.com/ws/wsclient → 500（对尝试的所有参数格式均如此）
  • www.iso-ne.com/transform/csv/genfuelmix?start=… → 403；即使使用浏览器 User-Agent 和 isoexpress Referer，仍为 403。请注意这是 403 而不是 404，因此该路径确实存在——它受会话限制，而不仅仅是受 UA 限制（参见 reference_gov_site_ua_blocks，通常更换 UA 就能解决）。
• 此处的响应结构尚未验证。 由于没有账户，尚未在实际环境中观察到 ISO-NE 对该工具包的响应正文。ISO-NE 会以单数/复数嵌套形式包装结果——{"FiveMinLmps": {"FiveMinLmp": [...]}}——工具包会以通用方式解包（深入到第一个值为数组的属性），并按原样返回各行，不会重新映射字段名。每个响应中的 envelope 字段都会报告实际遍历过的键，因此首次使用凭据调用时，就能看到真实结构，而不会被隐藏。获取凭据后再收紧处理逻辑。
• 当天的请求可能合理地返回空结果。 ISO-NE 会在事后发布每天的报告。工具包会将成功但返回 0 行视为错误，并提示尝试前一天，而不是把空数组作为正常结果返回。
• ISO-NE 的文档并未始终使用 .json 后缀；本工具包会为每个路径添加 .json，这是 v1.1 API 接受的形式。

快速开始

将其添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "iso-ne": {
      "url": "https://gateway.pipeworx.io/iso-ne/mcp"
    }
  }
}

此端点实际提供的内容

tools/list 在 https://gateway.pipeworx.io/iso-ne/mcp 返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall 及网关范围内的其他工具。因此，你看到的工具数量会多于表格所列：目前，单个工具包端点除了该工具包自身的工具外，还会列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围，并且是当天有效范围的权威依据。

这是有意为之，并非意外复用。元工具让限定范围的连接也能回答该工具包未涵盖的问题——通过跨整个目录路由的 ask_pipeworx，无需再添加第二个 MCP 服务。目前无法挂载不包含这些工具的工具包端点；如果额外的架构定义消耗的上下文超过了路由带来的价值，请连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出每个工具包的工具，而不只是当前工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和相同的 1882+ 个数据源。唯一的区别在于直接列出的是哪个工具包的工具；从任一端点都可以通过 ask_pipeworx 访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/isone_lmp \
  -H 'Content-Type: application/json' \
  -d '{"limit":100}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/isone_lmp。查找工具：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需与网关往返通信：

{
  "mcpServers": {
    "iso-ne": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-iso-ne"]
    }
  }
}

或者直接运行以确认服务能启动：

npx -y @pipeworx/mcp-iso-ne

它通过 stdin/stdout 使用 MCP 协议，并响应 initialize/tools/list/tools/call，但仅提供此工具包的工具——不包含上文网关连接额外提供的任何共享元工具。源码相同，工具相同，但没有 ask_pipeworx 路由功能。

使用 ask_pipeworx

你可以不直接调用工具，而是用自然语言提问——该功能既适用于上文的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Iso Ne data" })

网关会自动选择合适的工具并填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT