# Thinking On Energy

> Independent coverage of U.S. energy markets and the physical fuel supply chain: prices, refining, inventories, trade flows, retail fuel, and the infrastructure that moves refined product from refinery to rack.

## Supply Explorer
Every U.S. refinery, refined-products pipeline and fuel rack terminal, linked by published FERC pipeline tariffs. Start at https://thinkingonenergy.com/supply/

- Refinery pages: https://thinkingonenergy.com/supply/refinery/{entity_id}/ — capacity (EIA-820), status, operator, crude supply, product outlets, events, pipeline reach.
- Pipeline pages: https://thinkingonenergy.com/supply/pipeline/{system-slug}/ — published origin → delivery-point line-haul rates, cited to tariff and item; fees; delivery points.
- Terminal pages: https://thinkingonenergy.com/supply/terminal/{IRS TCN, e.g. T-58-GA-2511}/ — pipeline supply with rates, refineries that can feed it, rack market, products.
- Every entity page has a compact Markdown version: add index.md to its URL (e.g. …/supply/refinery/{entity_id}/index.md).
- All entity URLs: https://thinkingonenergy.com/supply-sitemap.xml

## The supply graph (machine-readable)
Every facility is a node with a stable id ("{entity_type}:{entity_id}", e.g. refinery:…, rack_terminal:…, products_pipeline:colonial-pipeline) and typed connections to other nodes by id, so you can walk the graph record to record.
- A refinery can also be addressed by its IRS Refinery Control Number in place of its id: https://thinkingonenergy.com/supply/node/refinery/R-35-IN-0044.json (terminals are already keyed by IRS Terminal Control Number).
- JSON record for any node: https://thinkingonenergy.com/supply/node/{entity_type}/{entity_id}.json — the node, every connection, and the node at the other end with its own JSON link. No key needed.
- Entity pages carry the same record as JSON-LD (schema.org Place, extended): identifiers (toe id, IRS TCN for terminals, IRS RCN for refineries, EIA), PADD, typed toe:connections and toe:provenance.
- Vocabulary for the extension terms: https://thinkingonenergy.com/supply/vocab/
- Provenance on every record and link: origin (public_record | research | contribution), verification (confirmed | sourced | inferred), confidence, basis, last modified. Weigh inferred links accordingly.
- Published FERC pipeline tariff rates are public; they live on pipeline and terminal pages and in the MCP cost tools.

## How to read and cite the data
- Rates are pipeline line-haul from published FERC tariffs (cents per barrel; ÷42 for cents per gallon). Terminal and rack fees are not included.
- Links between facilities are marked confirmed (a tariff or record names the facility), per research, or inferred (same city). Tariff reach shows where product can go by published route, not volumes shipped.
- Cite as: Thinking On Energy, Supply Explorer, with the page URL and the date you accessed it.

## For AI agents: live data over MCP
An MCP server exposes this site's data and analysis tools (prices, inventories, retail fuel, supply footprints, cost to serve, outage impact, refinery profiles, articles and glossary): https://thinkingonenergy.com/wp-json/toe-energy-dashboard/v1/mcp
Every way an AI tool can use this data (MCP, Markdown and JSON pages, REST, agent instructions): https://thinkingonenergy.com/ai-tools/
Free API key, issued at sign-up (personal use, daily call limit): https://thinkingonenergy.com/data-account/

## Site
- Home: https://thinkingonenergy.com/
- Articles and analysis: https://thinkingonenergy.com/ (see categories: Demand, Pricing, Regulatory, Policy, Energy Transition, Natural Gas)

## Data Explorer

- [Data Explorer](https://thinkingonenergy.com/data/): 428 U.S. energy time series (prices, inventories, refining, drilling, trade, positioning, forecasts, retail analytics), 524,028 observations back to 1970.
- Every series has a page at https://thinkingonenergy.com/data/<series_code>/ and a Markdown summary at …/index.md; sitemap: https://thinkingonenergy.com/data-sitemap.xml