Jodi Oil Compare
jodi_oil_compareCompare 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.
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": "production",
"months_back": 3
},
"name": "jodi_oil_compare"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flow | No | production (default), imports, exports, closing_stocks, stock_change, etc, see jodi_oil_series | |
| product | No | crude (default), ngl, other, total, or a refined product, see jodi_oil_series | |
| countries | No | ISO2 codes or names; defaults to the Gulf producer set | |
| end_month | No | Latest month to compare from, as YYYY-MM; defaults to the newest month anyone in the list has reported | |
| months_back | No | How many months before the latest to compare against (default 12 = year-over-year; use 3 for quarter-over-quarter) |