`jodi_oil_compare`

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

Compare JODI-Oil countries on one series, at the latest reported month AND against N months earlier — ranked by change. This is the tool for “which Gulf producers raised crude output most this quarter” (pass months_back:3) and “Saudi crude exports vs a year ago” (pass countries:[“Saudi Arabia”], months_back:12) — both are the same comparison, just different country lists. Defaults to the Gulf/Persian-Gulf producers (Saudi Arabia, UAE, Kuwait, Qatar, Oman, Bahrain, Iraq, Iran) if no countries are given. A country missing a compared month is marked reported:false and excluded from the ranking rather than treated as a zero. Example: jodi_oil_compare({flow:“production”, months_back:3}); jodi_oil_compare({countries:[“Saudi Arabia”], flow:“exports”, months_back:12}). Keyless.

Parameters

Name	Type	Required	Description
`countries`	array	no	ISO2 codes or names; defaults to the Gulf producer set
`items`	string	no
`product`	string	no	crude (default), ngl, other, total, or a refined product — see jodi_oil_series
`flow`	string	no	production (default), imports, exports, closing_stocks, stock_change, etc — see jodi_oil_series
`months_back`	number	no	How many months before the latest to compare against (default 12 = year-over-year; use 3 for quarter-over-quarter)
`end_month`	string	no	Latest month to compare from, as YYYY-MM; defaults to the newest month anyone in the list has reported

Example call

Arguments

{
  "flow": "production",
  "months_back": 3
}

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_compare","arguments":{"flow":"production","months_back":3}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('jodi_oil_compare', {
  "flow": "production",
  "months_back": 3
});

More examples

{
  "countries": [
    "Saudi Arabia"
  ],
  "flow": "exports",
  "months_back": 12
}

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_compare