`jodi_oil_series`

Pack: jodi · Endpoint: https://gateway.pipeworx.io/jodi/mcp

Monthly 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.

Parameters

Name	Type	Required	Description
`country`	string	yes	ISO2 code (“SA”) or name (“Saudi Arabia”)
`product`	string	no	crude (default), ngl, other, total, or a refined product: lpg, naphtha, gasoline, kerosene, jet_fuel, gas_diesel, fuel_oil, other_products, total_products
`flow`	string	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`	number	no	How many trailing months (default 24, max 120)
`end_month`	string	no	Last month of the window as YYYY-MM; defaults to the latest month JODI has published for anyone

Example call

Arguments

{
  "country": "Saudi Arabia",
  "flow": "exports",
  "months": 24
}

curl

curl -X POST https://gateway.pipeworx.io/jodi/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"jodi_oil_series","arguments":{"country":"Saudi Arabia","flow":"exports","months":24}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('jodi_oil_series', {
  "country": "Saudi Arabia",
  "flow": "exports",
  "months": 24
});

More examples

{
  "country": "AE",
  "product": "gasoline",
  "flow": "demand"
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "jodi": {
      "url": "https://gateway.pipeworx.io/jodi/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

jodi_oil_series