Heating Oil and Propane Prices MCP

io.github.theluckystrikePublished by GitHub account theluckystrikev1.0.0Updated Nov 5, 2026

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

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Remote MCP server that gives an assistant current EIA weekly heating oil and propane prices per gallon by state, with history and delivery cost estimates.

What you can do
  • Look up this week's EIA average heating oil and propane price per gallon for the US, an EIA region or a surveyed state, with weekly change, the last five survey weeks, the year-ago price and the next release date
  • Pull weekly price history for a fuel and area between two dates, with high, low and average
  • Estimate the cost of a delivery in gallons, cost per million Btu, and compare heating oil against propane, optionally against an electricity or natural gas rate
  • Return structured JSON with a summary, as-of date and source for each result
When to use it
Useful when someone asks what heating oil or propane costs right now in a given state, how prices compare with last year, what a tank fill would cost, or which fuel is cheaper per Btu. The assistant cannot know this week's price on its own, and the server reads it from EIA at call time.
Requirements
Remote streamable HTTP endpoint; no API key, token or sign-up. Add the server URL as a custom connector or in the client's MCP configuration. Network access to the hosted endpoint is needed; a local npm package is mentioned but not yet published.
Before you install
Prices are state averages from an EIA dealer survey, not dealer quotes, so actual delivery cost, fees and contracts vary. Not every state is surveyed, and from April to September EIA collects only one price a month. The hosted server caches EIA pages for up to an hour, so values may lag slightly. Results are read-only and no credentials are requested.

Installation

In SourceWeft

  1. Open Heating Oil and Propane Prices MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.theluckystrike%2Fheating-oil-propane-prices-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "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

Source: README.md at commit d9d37ff

Tools

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.

Parametersfuelstate

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.

Parametersfuelrequiredstateend_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.

Parametersfuelrequiredstategallonsrequiredprice_per_gallonefficiency_percentelectricity_cents_per_kwhnatural_gas_dollars_per_therm

Version history

1
  1. v1.0.0LatestNov 5, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts