@pipeworx/un-energy
Connect: https://pipeworx.io/mcp — every tool in the catalog, including @pipeworx/un-energy’s. Install: one-click buttons
Connect to just the @pipeworx/un-energy pack
https://gateway.pipeworx.io/un-energy/mcp — only @pipeworx/un-energy’s own tools, nothing else in the catalog.
No MCP client? Skip the connection: POST https://gateway.pipeworx.io/v1/tools/search_packs {"query":"..."} to find a tool below, GET /v1/tools/<name> for its schema, POST the same URL with arguments for the data — see For AI agents.
Tools: 3
United Nations energy statistics: country energy balances in terajoules and the Energy Statistics Database by fuel, flow and year, answered live per request.
Tools
un_energy_balance(country, commodity?, flow?, year?)- energy balance in TJ: product group (coal and peat, oil products, natural gas, electricity, total energy) against a flow (production, imports, exports, total energy supply, transformation, final consumption). Answers “total natural gas supply of Egypt in 2023 in TJ”.un_energy_statistics(country, commodity?, flow?, year?)- one named fuel or product against one flow in the unit the country reported (tonnes, cubic metres, GWh, TJ), with the UNSD conversion factor and the value converted to TJ. Answers “final energy consumption of aviation gasoline in Brazil in 2022”.un_energy_codes(kind, query?)- browse valid countries, products and flows.
Auth
Keyless.
Data sources
- United Nations Statistics Division (UNSD), Energy Balances.
- United Nations Statistics Division (UNSD), Energy Statistics Database.
Queried live per request; nothing is stored. Country, product and flow words are resolved against UNSD’s own code lists (held in memory for the life of the process). Words matching several products return every match, labelled.
Things worth knowing:
- The two datasets are not the same series. Energy balances are normalised to net calorific terajoules; the Energy Statistics Database carries each country’s reported quantity plus the conversion factor UNSD applies. For the same country, fuel and year the TJ totals can differ between them (Egypt natural gas 2023: 1,712,327 TJ in the balances, 1,902,586 TJ in the statistics database).
- Balance flows are signed: exports, stock builds and transformation inputs are negative.
- A query with no record is an error naming what was asked, not an empty list. The latest published year varies by country.
value_published x unit_multiplier = value; UNSD publishes tonnes as thousands (32.668 = 32,668 metric tons).
Tools
- un_energy_balance — Country energy balance from the UN Statistics Division, always in terajoules (TJ): one product group (coal and peat, oil products, natural gas, electricity, total energy, …) against one flow (primar
- un_energy_statistics — Energy Statistics Database of the UN Statistics Division: one named fuel or product (aviation gasoline, hard coal, lignite, kerosene-type jet fuel, natural gas, fuelwood, hydro electricity, …) again
- un_energy_codes — Browse the valid countries, products and flows for the UN energy tools, with codes. kind picks the list: country, balance_commodity, balance_flow, commodity, flow. query filters by words. Example: un_
Tools
un_energy_balance— Country energy balance from the UN Statistics Division, always in terajoules (TJ): one product group (coal and peat, oil products, natural gas, electricity, total energy, ...) against one flow (primarun_energy_codes— Browse the valid countries, products and flows for the UN energy tools, with codes. kind picks the list: country, balance_commodity, balance_flow, commodity, flow. query filters by words. Example: un_un_energy_statistics— Energy Statistics Database of the UN Statistics Division: one named fuel or product (aviation gasoline, hard coal, lignite, kerosene-type jet fuel, natural gas, fuelwood, hydro electricity, ...) again