Jodi Oil Series
jodi_oil_seriesMonthly JODI-Oil series for one country, production, imports, exports, direct use, refinery intake, stock change or closing stocks, for crude oil/NGL/other/total-crude or a refined product (LPG, gasoline, kerosene, jet fuel, gas/diesel, fuel oil). Answers "Saudi crude oil production over the last two years", "UAE crude exports vs a year ago", "Iraq refinery intake trend". A month with no JODI submission comes back as {reported:false, value:null}, NEVER 0, because JODI is self-reported and countries skip or delay months. Example: jodi_oil_series({country:"Saudi Arabia", flow:"exports", months:24}); jodi_oil_series({country:"AE", product:"gasoline", flow:"demand"}). Keyless.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"flow": "exports",
"months": 24,
"country": "Saudi Arabia"
},
"name": "jodi_oil_series"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flow | No | production (default), imports, exports, closing_stocks, stock_change, direct_use, refinery_intake, statistical_difference, other_sources, transfers (crude); or refinery_output, receipts, products_transferred, interproduct_transfers, demand (refined products) | |
| months | No | How many trailing months (default 24, max 120) | |
| country | Yes | ISO2 code ("SA") or name ("Saudi Arabia") | |
| product | No | crude (default), ngl, other, total, or a refined product: lpg, naphtha, gasoline, kerosene, jet_fuel, gas_diesel, fuel_oil, other_products, total_products | |
| end_month | No | Last month of the window as YYYY-MM; defaults to the latest month JODI has published for anyone |