usda_nass_get_livestock_inventory
Retrieves USDA NASS survey head counts for cattle, hogs, or sheep by year, state or national, and class. Use it to pull point-in-time livestock inventory data for a chosen survey day.
Instructions
Head counts of cattle, hogs or sheep on hand on the survey days of a year, by class.
Survey inventories (statisticcat_desc INVENTORY, unit_desc HEAD,
domain_desc TOTAL, freq_desc POINT IN TIME, source_desc
SURVEY), state or national, one row per survey day, class and short_desc
(cattle on feed carry the class ALL CLASSES with prodn_practice_desc
ON FEED), sorted by the day (begin_code, its month), then
reference_period_desc, class_desc and short_desc.
reference_period_desc names the day: FIRST OF JAN in the national cattle
series of 2024; the four quarterly days FIRST OF MAR, FIRST OF JUN,
FIRST OF SEP and FIRST OF DEC in Iowa's hogs series of 2024. The whole herd is
the class INCL CALVES for cattle, ALL CLASSES for hogs and INCL LAMBS for
sheep. value is the head count as published.
Args:
commodity: Upstream commodity_desc: LivestockCommodity.CATTLE,
LivestockCommodity.HOGS or LivestockCommodity.SHEEP.
year: Year of the survey days, e.g. 2024.
state: Two-letter state code for the state series, e.g. StateAlpha.IA,
StateAlpha.TX; None returns the national US TOTAL series.
class_desc: One upstream class_desc to keep, e.g. "INCL CALVES",
"COWS, BEEF" or "COWS, MILK" for cattle, "ALL CLASSES",
"BREEDING" or "MARKET" for hogs, "INCL LAMBS" for sheep; None
returns every class. A class with no record for the commodity, year and
place raises NotFoundError.
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": "<commodity>",
"year": "<year>"
},
"name": "usda_nass_get_livestock_inventory"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | Yes | ||
| state | No | ||
| commodity | Yes | ||
| class_desc | No |