Miso

@pipeworx/miso

MISO（Midcontinent ISO）实时电力数据 — 15 个州的覆盖区域（从路易斯安那州到明尼苏达州，另包括曼尼托巴省）的燃料结构、负荷、每五分钟 LMP、风能／太阳能预测与实际值，以及输电约束绑定情况。

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

工具

• miso_fuel_mix(period?) — 各燃料类别（煤炭、天然气、核能、风能、太阳能、水电、电池储能、其他）的发电量（MW）及覆盖区域总量。 current（默认值）= 最近的 5 分钟时段；today / yesterday = 全天数据。
• miso_lmp(region?, node?, limit?) — 各定价节点每五分钟的 LMP（$/MWh），包括损耗和拥塞分量，以及所有辅助服务的出清价格 （调频、里程、旋转备用、补充备用、短期备用、向上／向下爬坡）。 中部、北部和南部区域约有 1,600 个节点。
• miso_binding_constraints(kind?) — 当前受约束的流量门及其影子价格。transmission（默认值）、subregional 或 reserve。
• miso_load() — 今天逐小时的实际负荷与相同时段的中期负荷预测，以及每五分钟的总负荷序列。
• miso_wind_solar() — 逐小时风能和太阳能预测与实际发电量（MW）。

身份验证

无需密钥。无需注册、无需密钥，也未记录速率限制。

数据来源

• https://public-api.misoenergy.org/ — 实时公共 API。该主机根路径以 HTML 形式呈现端点索引。
• https://www.misoenergy.org/markets-and-operations/rtdataapis/ — MISO 关于这些数据源的官方页面。

注意事项

大家仍在引用的那个端点，返回的始终是零数据。 MISO 长期文档中记载的实时数据代理 —

https://api.misoenergy.org/MISORTWDDataBroker/DataBrokerServices.asmx
  ?messageType=getfuelmix&returnType=json

— 仍可解析，仍返回 HTTP 200，但对每个数据 messageType（getfuelmix、getlmpconsolidatedtable、 gettotalload，等等）都返回

{"error": "no data", "See": "https://www.misoenergy.org/markets-and-operations/rtdataapis"}

。只有 getapiversion 仍包含有效负载。任何只检查 res.ok 的客户端都会永远报告成功，却始终得不到数据 — 这属于 docs/silent-zero-policy.md 中所述的故障类型。已于 2026-09-17 验证该端点失效。本工具包仅连接 public-api.misoenergy.org，并且 misoGet 会在响应正文包含字符串 error 时抛出异常，以便未来停用时明确报错，而不是静默失败。

其他值得了解的信息：

• 所有数值都是字符串。 "34168"，而 /api/Snapshot 展示数据源中的数值会用逗号分组，如 "99,978"。num() 会进行类型转换；遇到空值时返回 null，绝不会返回 0，因此“没有读数”不会被误读为“零兆瓦”。
• 时间戳全年均使用 EST。 MISO 不会因夏令时调整市场时钟；有效负载会明确标注这一点。
• /api/FuelMix 只返回一个时段的数据，而非序列。 如需全天数据，请使用 /Today 或 /Yesterday。
• MediumTermLoadForecast 使用 HourEnding，而不是 Hour — 它旁边的 ClearedMW 使用的是 Hour。若两者都按 Hour 匹配，预测列会静默地全部变为 null。
• /api/WindSolar/GetCombined 也会返回未来时段，这些时段没有实际值，而非实际值有意义。对于尚未发生的时段，本工具包会将实际值设为 null，而不会报告晚上 11 点的风力发电量为 0 MW。
• getapiversion 会在未协商的情况下以 gzip 压缩，因此不带 --compressed 的原始 curl 会输出二进制内容。Workers 的 fetch 会自动解压。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/miso/mcp 上的 tools/list 会返回上表中的工具，以及 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/miso_fuel_mix \
  -H 'Content-Type: application/json' \
  -d '{}'

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

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

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经过网关：

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

也可以直接运行，以确认它能正常启动：

npx -y @pipeworx/mcp-miso

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

使用 ask_pipeworx

你可以用通俗的英语提问，而不是直接调用工具——这既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Miso data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT