Producer Prices by Country
producer.pricesFarm-gate producer prices by country for one commodity and year, from FAOSTAT. Use for 'where is this cheap at source' and for comparing what growers are actually paid across countries. THIS IS NOT A BENCHMARK: a producer price is what the farmer received, and differs from price.latest and from the export unit value in trade.partners — all three can be correct and several-fold apart. Covers seven crops only (ZC ZW ZS ZR KC CC CT); sugar, palm and livestock are deliberately unmapped because FAOSTAT prices a different product for those. Annual, usually one to two years behind.
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>"
},
"name": "producer.prices"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Four-digit year; defaults to the latest available. | |
| commodity | Yes | Instrument code. Example: KC for coffee. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | Yes | ||
| notes | Yes | Read before presenting any figure from this tool. | |
| source | No | ||
| commodity | Yes | ||
| countries | Yes | Countries, cheapest first | |
| license_tag | No | ||
| faostat_item | No | The FAOSTAT item actually priced | |
| country_count | No | ||
| years_available | No | ||
| peer_band_multiple | No | The multiple of the median beyond which far_from_peers is set | |
| vs_median_available | No | False when too few countries report for a median to mean anything | |
| peer_median_usd_per_tonne | No |