Heating Oil and Propane Prices MCP

io.github.theluckystrike由 GitHub 帳號 theluckystrike 發布v1.0.0更新於 Nov 5, 2026

Heating oil and propane prices per gallon by state, from the EIA weekly survey, with history.

已驗證Streamable HTTP可網頁執行金融資料與分析

概覽

AI 產生的概覽

遠端 MCP 伺服器，讓助理取得 EIA 每週公布的各州暖氣油與丙烷每加侖價格，並提供歷史資料與配送成本估算。

可以做什麼
  • 查詢美國、EIA 區域或受調查州本週暖氣油與丙烷的 EIA 平均每加侖價格，含週變化、最近五個調查週、去年同期價格與下次發布日期
  • 依燃料與地區查詢兩個日期之間的每週價格歷史，含最高、最低與平均值
  • 依加侖數估算一次配送的費用、每百萬 Btu 成本，並比較暖氣油與丙烷，可選擇對比電費或天然氣費率
  • 每項結果回傳結構化 JSON，並附摘要、資料截止日期與來源
適用情境
適合回答某州目前暖氣油或丙烷價格、與去年同期相比的變化、加滿一桶油要花多少錢，或哪種燃料每 Btu 較便宜等問題。助理本身無法得知本週價格，此伺服器會在呼叫時從 EIA 讀取。
執行需求
遠端 streamable HTTP 端點，不需要 API 金鑰、權杖或註冊。將伺服器 URL 加入為自訂連接器或寫入用戶端的 MCP 設定即可。需要能連線至該託管端點；README 提到的本機 npm 套件尚未發布。
安裝前請注意
價格是 EIA 經銷商調查所得的州平均值，並非經銷商報價，實際配送價格、運費與合約條款會有差異。並非所有州都在調查範圍內，且 4 月至 9 月 EIA 每月只蒐集一次價格。託管伺服器會快取 EIA 頁面最多一小時，數值可能略有延遲。工具為唯讀，不索取任何憑證。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Heating Oil and Propane Prices MCP，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.theluckystrike%2Fheating-oil-propane-prices-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "heating-oil-and-propane-prices": {
      "type": "http",
      "url": "https://heating-oil-propane-prices-mcp.lipmichal.workers.dev/mcp"
    }
  }
}

README

heating-oil-propane-prices-mcp

Heating oil and propane prices for AI assistants. Ask for this week's price per gallon in your state and get the U.S. Energy Information Administration (EIA) average, the change from last week and a year ago, and what a tank fill costs.

This is a Model Context Protocol (MCP) server. It reads the EIA weekly residential heating oil and propane survey at call time. It needs no API key.

Tools

ToolWhat it returns
get_heating_oil_propane_pricesThis week's EIA average residential heating oil and propane price per gallon (taxes included) for the US, an EIA region or a surveyed state, the change from last week, the last five survey weeks, the price a year ago and the next release date.
get_heating_fuel_price_historyWeekly prices for a fuel and area between two dates (most series start in 1990), with high, low and average.
estimate_heating_fuel_costCost of a delivery at this week's state average (or your price), cost per million Btu, and heating oil vs propane per million Btu, optionally against your electricity or natural gas rate.

Every result has structured JSON, a one-paragraph summary, as_of, source and more (a page on mcpstamp.com).

What it knows that your model does not

  • This week's price. EIA publishes new prices every Wednesday from October to March, so a remembered number is stale.
  • Which states EIA surveys. Heating oil covers 21 Northeast and Midwest states; propane covers 38. Other states get the covered list, not a made-up number.
  • Real year-over-year change from the EIA history file.

Install

Hosted (Claude.ai custom connector, ChatGPT developer mode)

Paste this URL. No token, no sign-up. It works now.

https://heating-oil-propane-prices-mcp.lipmichal.workers.dev/mcp

Claude Code

claude mcp add --transport http heating-fuel-prices https://heating-oil-propane-prices-mcp.lipmichal.workers.dev/mcp

Claude Desktop

Claude Desktop adds remote servers under Settings, Connectors, Add custom connector. Paste the URL above.

Cursor

Add to ~/.cursor/mcp.json:

json
{  "mcpServers": {    "heating-fuel-prices": { "url": "https://heating-oil-propane-prices-mcp.lipmichal.workers.dev/mcp" }  }}

VS Code

Add to .vscode/mcp.json:

json
{  "servers": {    "heating-fuel-prices": { "type": "http", "url": "https://heating-oil-propane-prices-mcp.lipmichal.workers.dev/mcp" }  }}

Local stdio (after npm release)

The npm package is not published yet. After it is, run it locally with Node 20 or newer:

claude mcp add heating-fuel-prices -- npx -y heating-oil-propane-prices-mcp

Example prompts

  • "What are heating oil prices this week?"
  • "How much is propane in Maine right now, and how does it compare with last year?"
  • "What will 200 gallons of heating oil cost me in Connecticut?"
  • "Is propane or heating oil cheaper per Btu in Pennsylvania?"
  • "Show me propane prices in Minnesota over the last year."

Data sources

Full list with fetch dates in DATA_SOURCES.md.

Limitations

  • State averages from a dealer survey, not a quote. Dealer price, delivery fees, volume and contracts vary.
  • From April to September EIA collects one price a month.
  • Not every state is surveyed (no heating oil price for Texas, for example).
  • The hosted server caches EIA pages for up to an hour.

More

More MCP servers that answer questions your assistant cannot answer alone are on mcpstamp.com.

Part of the Zovo MCP collection: https://mcp.zovo.one

Built by theluckystrike.

Development

npm installnpm test                              # builds, then runs the fixture tests and an offline stdio testnode scripts/stdio-transcript.mjs     # live stdio round trip, writes .live/stdio-transcript.jsonl

License

MIT

來源：README.md，提交 d9d37ff

工具

3

get_heating_oil_propane_prices

Get heating oil and propane prices

Latest EIA weekly average residential price per gallon (taxes included) of heating oil and propane for the US, an EIA region or a surveyed state, read at call time from eia.gov: price, change from last week, the last five survey weeks, the price a year ago and the next release date. Heating oil is surveyed in Northeast and Midwest states; propane in about 40 states. Uncovered states return the covered list.

輸入參數fuelstate

get_heating_fuel_price_history

Get heating fuel price history

EIA weekly residential heating oil or propane prices per gallon for the US or a surveyed state between two dates (series since 1990 for most areas), with high, low and average. Default is the last 52 weeks.

輸入參數fuel必填stateend_datestart_date

estimate_heating_fuel_cost

Estimate heating fuel cost

Cost of a heating oil or propane delivery (gallons times this week's EIA average for the state, or a given price), the cost per million Btu, and a comparison of heating oil and propane per million Btu at the same area's averages. Optionally add your electricity rate (cents per kWh) or natural gas rate (dollars per therm) to compare. Uses EIA heat contents.

輸入參數fuel必填stategallons必填price_per_gallonefficiency_percentelectricity_cents_per_kwhnatural_gas_dollars_per_therm

版本歷史

1
  1. v1.0.0最新Nov 5, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分