usda_psd_get_release_dates
Retrieve USDA PSD release dates for a commodity by country and market year; filter by a stored vintage to return only records revised after that month.
Instructions
When PSD last revised each country and market year of a commodity: poll for releases.
One record per country and market year: release_year and release_month name
the PSD release, a month without a day. Compare them with a stored meta.vintage
of get_data, or pass that vintage as since, to fetch only what changed.
Upstream answers every country and every market year since 1960 at once (7,754
records for wheat), ordered by market year; market_year, country_code and
since keep only the matching records, after the one call, in upstream's order.
Args:
commodity_code: PSD commodity code, seven digits, e.g. "0410000" (Wheat),
"0440000" (Corn), "2222000" (Oilseed, Soybean).
market_year: Keep only this PSD market year, e.g. 2023; None keeps all.
country_code: Keep only this PSD country code (not ISO), e.g. "US", "BR";
None keeps all.
since: Keep only the records revised in a release later than this month,
"YYYY-MM", e.g. "2026-09"; the form meta.vintage takes, so a
stored vintage passes as it is, and that release itself is not kept (strictly
after). None keeps all.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"commodity_code": "<commodity_code>"
},
"name": "usda_psd_get_release_dates"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| since | No | ||
| market_year | No | ||
| country_code | No | ||
| commodity_code | Yes |