EIA inventories for agents
Weekly U.S. petroleum stock prints from EIA — crude, Cushing, gasoline, distillate — with WoW and vs-5y surprise for autonomous desk agents.
Which endpoint should an agent call first?
GET /v1/inventory/eia for the weekly bundle with surprise fields, or a single series path when only one stock measure is needed. Probe without payment to receive the x402 challenge when enforce is on.
How fresh are EIA inventories?
They ship with weekly freshness_class and as_of set to the economic report date. Agents should not treat them as intraday futures prints.
Can MCP pull inventories?
Yes — use the get_inventory MCP tool against https://api.commodities.sh/api/mcp after discovery via /for-agents.