Octopus Energy

mcp-octopus-energy

Octopus Energy 公共 API MCP — 英国能源费率与产品。

属于 Pipeworx — 一个将 AI Agent 连接到 1683+ 个实时数据源的 MCP 网关。

工具

工具	描述
list_products	列出 Octopus Energy UK 能源产品（电力和燃气费率系列，例如「Agile Octopus」、「Flexible Octopus」）。返回 {count, results:[{code, display_name, direction, is_variable, is_green, is_tracker, is_prepay, is_business, term, available_from, available_to}]}。「code」可传给 product_details。可选筛选条件可缩小列表范围。
product_details	获取一个产品代码的完整详情，包括按 GSP 区域「_A」..「_P」和付款方式（例如 direct_debit_monthly）细分的费率。每个费率条目包含「code」（例如「E-1R-AGILE-24-10-01-C」）、固定费用和单位费率（含／不含 VAT）。将费率「code」用于 tariff_unit_rates。返回的费率集：single_register_electricity_tariffs、dual_register_electricity_tariffs、four_rate_ev_electricity_tariffs、single_register_gas_tariffs。
tariff_unit_rates	获取特定费率的电力单位费率时间序列 — 对于 Agile，这是按半小时跟踪批发价格。返回以 p/kWh 为单位、按时间从新到旧排列的 {count, results:[{value_exc_vat, value_inc_vat, valid_from, valid_to, payment_method}]}。将 kind="standing_charges" 设置为获取以 p/day 为单位的固定费用。默认返回最近的费率；传入 period_from/period_to 可限定时间范围。
grid_supply_point	将英国邮政编码映射到其 GSP（电网供电点）组「_A」..「_P」。group_id 是费率代码和 product_details 区域细分中使用的区域后缀。返回 {count, results:[{group_id}]}。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/octopus-energy/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 都指向同一个网关和相同的 1683+ 个数据源。唯一的区别是直接列出的工具属于哪个工具包；从任一端点都可以通过 ask_pipeworx 访问所有工具。

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

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

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

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

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

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

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

npx -y @pipeworx/mcp-octopus-energy

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

使用 ask_pipeworx

无需直接调用工具，你可以用通俗的英语提问—— 这在上方的 pack 端点和完整网关上都适用：

ask_pipeworx({ question: "your question about Octopus Energy data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT