Eia

liveEnergyEconomicsGovernment

US Energy Information Administration API v2 — petroleum prices, natural gas, electricity generation, and ethanol production data.

6tools
0msauth
free tier50 calls/day

Tools

eia_series

Search EIA for any energy data series by route path. Returns historical data points with timestamps and values. Use for specific energy metrics not covered by category tools.

No parameters required.

▶Try it
eia_petroleum

Get EIA petroleum time series data for a specific product (gasoline, diesel, crude, stocks, supply, production, imports). Returns prices or volumes by period with regional breakdowns. Requires free EI

No parameters required.

▶Try it
us_fuel_price

US gas station prices: the weekly national average retail pump price per gallon of regular, midgrade or premium gasoline, or diesel, from the U.S. Energy Inform

No parameters required.

▶Try it
eia_natural_gas

Get EIA natural gas time series for a named series (prices, production, consumption, storage, spot_prices). Returns period, value, and area metadata. Requires free EIA API key.

No parameters required.

▶Try it
eia_electricity

Get EIA electricity data for a named series (generation, retail_sales, prices, state_generation). Returns time series with period and value across fuel sources and regions. Requires free EIA API key.

No parameters required.

▶Try it
eia_ethanol

Get fuel ethanol production volumes, stocks, and imports. Returns time series for ethanol supply chain metrics.

No parameters required.

▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/eia/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/eia/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"eia_series","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("eia_series", {});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("us energy information administration api v2 — petroleum prices, natural gas, electricity generation, and ethanol production data");