← The evidence ledger
Evidence row 731981
Observed , by probe.mcp/1.
- Kind
- mcp.tools
- About
- endpoint 3a46848f-c691-4ffa-8516-5095f7ec3ab2
- Recorded
- Previous row
- #302587
- Body SHA-256
- 7b7a28d4f23e54a489a0ab735b43a625ecd4388e9b8e64609eb068b73dcdaa0e
- Leaf
- 0x28be0d78ac1fd65235c58ec6a4da7a41525cc062141d02e464830c9b5ab277c4
What was observed
{
"count": 27,
"tools": [
{
"description": "Derived comparison of ESR contracted export sales against GATS actual shipments for one commodity: total contracted, total shipped, and the gap in metric tons — a positive gap means sold but not yet shipped. Use to gauge the unshipped export backlog; use get_export_sales or get_trade_flows instead for the underlying weekly or monthly detail. Read-only; no API key. This is a computed aggregate across both stored datasets over all stored periods, not a USDA-published figure; totals are rounded to whole tons.",
"inputSchema": {
"properties": {
"commodity": {
"description": "Commodity slug (see list_gats_commodities)",
"enum": [
"wheat",
"barley",
"corn",
"sorghum",
"soybeans",
"soybean_meal",
"soybean_oil",
"cotton",
"rice"
],
"type": "string"
},
"partner": {
"description": "Partner country code (2-letter ISO/GENC, e.g. MX, CN) or omit for all partners",
"type": "string"
}
},
"required": [
"commodity"
],
"type": "object"
},
"name": "compare_contracts_vs_shipments"
},
{
"description": "Most recent weekly NASS crop condition ratings for corn, soybeans, or wheat — the share of the crop rated excellent, good, fair, poor, and very poor, plus a combined good+excellent percentage — from USDA NASS QuickStats. Use for current crop health; use get_crop_condition_history instead for week-by-week change across the season, and get_crop_progress for growth-stage pace. Read-only lookup of stored statistics; no API key. Ratings are published weekly in season, but the stored copy refreshes weekly, so the returned `period` (e.g. 2026-W30) is the freshest stored week, not necessarily the current one.",
"inputSchema": {
"properties": {
"commodity": {
"default": "CORN",
"description": "Commodity (CORN, SOYBEANS, WHEAT). Default: CORN",
"type": "string"
},
"geography": {
"default": "US",
"description": "US for national, or state code (IA, IL, etc.); state coverage is the major corn-belt states. Default: US",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "get_crop_condition"
},
{
"description": "Week-by-week NASS crop condition ratings for corn, soybeans, or wheat across the growing season — each week's excellent/good/fair/poor/very poor shares plus a combined good+excellent percentage — from USDA NASS QuickStats. Use to track crop health trends or compare weeks within the season; use get_crop_condition instead when only the latest week matters. Read-only lookup of stored statistics; no API key. Returns up to `weeks` most recent stored weeks, oldest first (default 12, max 52); coverage is the current season, national plus major corn-belt states, and the stored copy refreshes weekly.",
"inputSchema": {
"properties": {
"commodity": {
"default": "CORN",
"description": "Commodity (CORN, SOYBEANS, WHEAT). Default: CORN",
"type": "string"
},
"geography": {
"default": "US",
"description": "US for national, or state code (IA, IL, etc.); state coverage is the major corn-belt states. Default: US",
"type": "string"
},
"weeks": {
"default": 12,
"description": "Number of most recent weeks to return (default 12, max 52)",
"type": "number"
}
},
"required": [],
"type": "object"
},
"name": "get_crop_condition_history"
},
{
"description": "Most recent weekly NASS crop progress for corn, soybeans, or wheat — the share of the crop at each growth stage (planted, emerged, silking, harvested, and similar; the stages present vary by commodity) — from USDA NASS QuickStats. Use for current season pace; use get_crop_progress_history instead for week-by-week pace across the season, and get_crop_condition for health ratings. Read-only lookup of stored statistics; no API key. Progress is published weekly in season, but the stored copy refreshes weekly; the returned `period` (e.g. 2026-W30) is the freshest stored week.",
"inputSchema": {
"properties": {
"commodity": {
"default": "CORN",
"description": "Commodity (CORN, SOYBEANS, WHEAT). Default: CORN",
"type": "string"
},
"geography": {
"default": "US",
"description": "US for national, or state code (IA, IL, etc.); state coverage is the major corn-belt states. Default: US",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "get_crop_progress"
},
{
"description": "Week-by-week NASS crop progress for corn, soybeans, or wheat across the growing season — each week's share of the crop at each growth stage (planted, emerged, silking, harvested, and similar) — from USDA NASS QuickStats. Use to track season pace or compare against earlier weeks; use get_crop_progress instead when only the latest week matters. Read-only lookup of stored statistics; no API key. Returns up to `weeks` most recent stored weeks, oldest first (default 12, max 52); the stages present vary by commodity and point in the season. Coverage is the current season, national plus major corn-belt states, and the stored copy refreshes weekly.",
"inputSchema": {
"properties": {
"commodity": {
"default": "CORN",
"description": "Commodity (CORN, SOYBEANS, WHEAT). Default: CORN",
"type": "string"
},
"geography": {
"default": "US",
"description": "US for national, or state code (IA, IL, etc.); state coverage is the major corn-belt states. Default: US",
"type": "string"
},
"weeks": {
"default": 12,
"description": "Number of most recent weeks to return (default 12, max 52)",
"type": "number"
}
},
"required": [],
"type": "object"
},
"name": "get_crop_progress_history"
},
{
"description": "Annual NASS survey statistics — yield, production, planted or harvested area — for a commodity at national or state level, from USDA NASS QuickStats. These are survey estimates, not market prices. Use for production fundamentals; use get_crop_condition or get_crop_progress instead for in-season weekly crop status. Read-only lookup of stored statistics; no API key. Returns every stored period (year) for the requested statistic, most recent first; the stored copy refreshes weekly. Commodity, statistic, and geography are case-insensitive and default to CORN, YIELD, and US.",
"inputSchema": {
"properties": {
"commodity": {
"default": "CORN",
"description": "Commodity (CORN, SOYBEANS, WHEAT, COTTON, SORGHUM, OATS, BARLEY, RICE). Default: CORN",
"type": "string"
},
"geography": {
"default": "US",
"description": "US for national, or state code (IA, IL, etc.). Default: US",
"type": "string"
},
"stat": {
"default": "YIELD",
"description": "Statistic type (YIELD, PRODUCTION, AREA PLANTED, AREA HARVESTED). Default: YIELD",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "get_crop_stats"
},
{
"description": "Weekly price history for one dairy product, from the same USDA MARS weekly dairy reports behind get_dairy_price. Use for trends across report weeks; use get_dairy_price instead when only the latest quote matters. Read-only lookup of stored reports; no API key. Returns up to `periods` most recent report rows, oldest first (default 30, max 365); geography defaults to US-Central and cheese defaults to geography 'Oceania'. Butter returns a withheld notice — USDA publishes only price differentials for butter, no US base price.",
"inputSchema": {
"properties": {
"geography": {
"default": "US-Central",
"description": "Report region (US-Central, US-East, US-West; cheese uses US). Default: US-Central",
"type": "string"
},
"periods": {
"default": 30,
"description": "Number of most recent report rows to return (default 30, max 365)",
"type": "number"
},
"product": {
"description": "Dairy product (cheese, butter, dry_whey, fluid_milk). Butter prices are withheld — see description",
"enum": [
"butter",
"cheese",
"dry_whey",
"fluid_milk"
],
"type": "string"
}
},
"required": [
"product"
],
"type": "object"
},
"name": "get_dairy_history"
},
{
"description": "Latest price for one dairy product, from USDA MARS weekly dairy reports — the same series get_dairy_history extends over time. Use for a current quote; use get_dairy_history instead for the weekly trend. Read-only lookup of stored reports; no API key. Geography defaults to US-Central (cheese is Oceania cheddar and defaults to geography 'Oceania'). Butter is deliberately withheld: USDA publishes only price differentials for butter, no US base price, so butter returns a withheld notice instead of a misleading value.",
"inputSchema": {
"properties": {
"geography": {
"default": "US-Central",
"description": "Report region (US-Central, US-East, US-West; cheese uses US). Default: US-Central",
"type": "string"
},
"product": {
"description": "Dairy product (cheese, butter, dry_whey, fluid_milk). Butter prices are withheld — see description",
"enum": [
"butter",
"cheese",
"dry_whey",
"fluid_milk"
],
"type": "string"
}
},
"required": [
"product"
],
"type": "object"
},
"name": "get_dairy_price"
},
{
"description": "Latest week of USDA export sales for one commodity from the FAS Export Sales Reporting (ESR) system — sales contracted by exporters, not yet necessarily shipped. Use for current foreign demand; use get_export_sales_history instead for the weekly trend, and get_trade_flows for actual shipped volumes. Read-only lookup of stored reports; no API key. ESR reports weekly (released Thursdays); returns the most recent stored week's weekly exports, outstanding sales, net sales for the current marketing year, and total commitments per destination country, each row with its reported unit. Omit `country` to include all destinations.",
"inputSchema": {
"properties": {
"commodity": {
"description": "Commodity slug (see list_esr_commodities)",
"enum": [
"wheat",
"barley",
"corn",
"sorghum",
"soybeans",
"soybean_meal",
"soybean_oil",
"cotton",
"rice"
],
"type": "string"
},
"country": {
"description": "GENC country code (e.g. CHN, MEX) or omit for all destinations",
"type": "string"
}
},
"required": [
"commodity"
],
"type": "object"
},
"name": "get_export_sales"
},
{
"description": "Weekly export sales time series for one commodity, and optionally one destination country, from the same FAS ESR weekly reports behind get_export_sales. Use for demand trends across weeks; use get_export_sales instead when only the latest week matters, and compare_contracts_vs_shipments to set contracted sales against actual shipments. Read-only lookup of stored reports; no API key. Returns up to `weeks` most recent weeks, oldest first (default 12, max 52); without a `country`, each week covers all destinations combined as stored.",
"inputSchema": {
"properties": {
"commodity": {
"description": "Commodity slug (see list_esr_commodities)",
"enum": [
"wheat",
"barley",
"corn",
"sorghum",
"soybeans",
"soybean_meal",
"soybean_oil",
"cotton",
"rice"
],
"type": "string"
},
"country": {
"description": "GENC country code (e.g. CHN, MEX) or omit for all destinations",
"type": "string"
},
"weeks": {
"default": 12,
"description": "Number of most recent weeks to return (default 12, max 52)",
"type": "number"
}
},
"required": [
"commodity"
],
"type": "object"
},
"name": "get_export_sales_history"
},
{
"description": "Price history for one fertilizer product across report periods, from the same twice-monthly USDA MARS production cost reports behind get_fertilizer_price. Use for input-cost trends; use get_fertilizer_price instead when only the latest quote matters. Read-only lookup of stored reports; no API key. Returns up to `periods` most recent reports, oldest first (default 12, max 52 — roughly two years of twice-monthly reports).",
"inputSchema": {
"properties": {
"periods": {
"default": 12,
"description": "Number of most recent report periods to return (default 12, max 52)",
"type": "number"
},
"product": {
"description": "Product slug (e.g. anhydrous_ammonia, urea, dap)",
"enum": [
"anhydrous_ammonia",
"urea",
"dap",
"map",
"potash",
"liquid_n_28",
"liquid_n_32",
"ats",
"farm_diesel",
"biodiesel"
],
"type": "string"
}
},
"required": [
"product"
],
"type": "object"
},
"name": "get_fertilizer_history"
},
{
"description": "Latest price for one fertilizer product from USDA MARS production cost reports (Illinois-led regional coverage) — the same series get_fertilizer_history extends over time. Use for a current input-cost quote; use get_spreads instead to relate fertilizer cost to corn or cattle prices. Read-only lookup of stored reports; no API key. The reports publish twice a month and are fetched on the 1st and 15th, so the latest price can be up to about two weeks old; returns the price, its unit (typically USD per ton), and the change versus the prior report.",
"inputSchema": {
"properties": {
"product": {
"description": "Product slug (e.g. anhydrous_ammonia, urea, dap)",
"enum": [
"anhydrous_ammonia",
"urea",
"dap",
"map",
"potash",
"liquid_n_28",
"liquid_n_32",
"ats",
"farm_diesel",
"biodiesel"
],
"type": "string"
}
},
"required": [
"product"
],
"type": "object"
},
"name": "get_fertilizer_price"
},
{
"description": "Daily cash price history for one grain commodity in one state, from the same USDA MARS daily reports behind get_grain_price. Use for trends or day-over-day comparison; use get_grain_price instead when only the latest quote matters. Read-only lookup of stored reports; no API key. Returns up to `periods` most recent daily report rows, oldest first; `periods` counts report rows, not calendar days (default 30, max 365).",
"inputSchema": {
"properties": {
"geography": {
"default": "IL",
"description": "State/region code from a tracked MARS report (e.g. IL, IA, TX, PNW, GULF). Default: IL",
"type": "string"
},
"periods": {
"default": 30,
"description": "Number of most recent report rows to return (default 30, max 365)",
"type": "number"
},
"product": {
"description": "Grain slug (e.g. corn, soybeans, wheat)",
"enum": [
"corn",
"soybeans",
"wheat",
"sorghum",
"oats",
"barley",
"rice"
],
"type": "string"
}
},
"required": [
"product"
],
"type": "object"
},
"name": "get_grain_history"
},
{
"description": "Latest cash grain price for one commodity in one state, from USDA MARS daily market reports — the same series get_grain_history extends over time. Use for a current quote; use get_grain_history instead for trends across days. Read-only lookup of stored reports; no API key. Returns the most recent report's price with its unit (USD per bushel in most markets) and market location; a commodity/state pair with no report returns a no-data error rather than a stale price.",
"inputSchema": {
"properties": {
"geography": {
"default": "IL",
"description": "State/region code from a tracked MARS report (e.g. IL, IA, TX, PNW, GULF). Default: IL",
"type": "string"
},
"product": {
"description": "Grain slug (e.g. corn, soybeans, wheat)",
"enum": [
"corn",
"soybeans",
"wheat",
"sorghum",
"oats",
"barley",
"rice"
],
"type": "string"
}
},
"required": [
"product"
],
"type": "object"
},
"name": "get_grain_price"
},
{
"description": "Price history for one livestock category in one region, from the same USDA MARS reports behind get_livestock_price (daily direct-trade reports plus weekly auction summaries). Use for trends; use get_livestock_price instead when only the latest quote matters. Read-only lookup of stored reports; no API key. Returns up to `periods` most recent report rows, oldest first; `periods` counts report rows, not calendar days (default 30, max 365).",
"inputSchema": {
"properties": {
"geography": {
"default": "IA",
"description": "Region or state code (e.g. IA, ECB, KS). Default: IA",
"type": "string"
},
"periods": {
"default": 30,
"description": "Number of most recent report rows to return (default 30, max 365)",
"type": "number"
},
"product": {
"description": "Livestock slug (e.g. fed_cattle, feeder_cattle, hogs)",
"enum": [
"fed_cattle",
"feeder_cattle",
"hogs",
"sheep",
"cows_cwt",
"cows_head"
],
"type": "string"
}
},
"required": [
"product"
],
"type": "object"
},
"name": "get_livestock_history"
},
{
"description": "Latest price for one livestock category in one region, from USDA MARS direct-trade and auction reports — the same series get_livestock_history extends over time. Use for a current quote; use get_livestock_history instead for trends. Read-only lookup of stored reports; no API key. Returns the most recent report's price and its unit (typically USD per cwt); direct-trade reports can skip weeks when no trades occur, and a category/region pair with no report returns a no-data error rather than a stale price.",
"inputSchema": {
"properties": {
"geography": {
"default": "IA",
"description": "Region or state code (e.g. IA for Iowa direct trade, ECB for Eastern Cornbelt, or a state auction code). Default: IA",
"type": "string"
},
"product": {
"description": "Livestock slug (e.g. fed_cattle, feeder_cattle, hogs)",
"enum": [
"fed_cattle",
"feeder_cattle",
"hogs",
"sheep",
"cows_cwt",
"cows_head"
],
"type": "string"
}
},
"required": [
"product"
],
"type": "object"
},
"name": "get_livestock_price"
},
{
"description": "Derived input-to-output price spreads computed from the latest stored Magpie prices: corn-to-nitrogen cost broken down per fertilizer product (bushels of corn per ton of product and per pound of actual N), the soybean-to-corn price ratio, and the feeder-to-fed cattle spread. Use for planting and feeding economics; use the raw price tools (get_grain_price, get_fertilizer_price, get_livestock_price) instead for the quotes behind a spread. Read-only; no API key. These are Magpie calculations over stored USDA MARS prices, not USDA-published figures; a spread is omitted when either side has no stored price. Geography defaults to IL and applies to both sides of each spread.",
"inputSchema": {
"properties": {
"geography": {
"default": "IL",
"description": "State/region code used for both sides of the spreads (e.g. IL, IA). Default: IL",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "get_spreads"
},
{
"description": "Monthly US agricultural export shipments by destination, from USDA GATS (Census trade data) — quantities and values actually shipped, not sales contracted. Use for realized trade volumes; use get_export_sales instead for contracted-but-unshipped demand, and compare_contracts_vs_shipments for the sold-versus-shipped gap. Read-only lookup of stored Census data; no API key. Coverage is a rolling 24 months, refreshed monthly; quantities are in metric tons with values in USD. Some commodities are withheld when GATS unit inconsistencies fail a dollars-per-ton sanity check — a withheld result says so explicitly instead of returning bad numbers.",
"inputSchema": {
"properties": {
"commodity": {
"description": "Commodity slug (see list_gats_commodities)",
"enum": [
"wheat",
"barley",
"corn",
"sorghum",
"soybeans",
"soybean_meal",
"soybean_oil",
"cotton",
"rice"
],
"type": "string"
},
"months": {
"default": 12,
"description": "Number of months of flows to return (default 12, max 24)",
"type": "number"
},
"partner": {
"description": "Partner country code (2-letter ISO/GENC, e.g. MX, CN) or omit for all partners",
"type": "string"
}
},
"required": [
"commodity"
],
"type": "object"
},
"name": "get_trade_flows"
},
{
"description": "Revision history of one WASDE projection figure (default ending_stocks) across monthly reports — how the estimate for a commodity and marketing year moved as successive WASDE reports landed. Use to study estimate revisions; use get_wasde_projection instead for the full current balance sheet. Read-only lookup of stored projections; no API key. Returns up to 24 monthly report values, oldest first, each with its report date and unit, for the requested commodity, attribute, and country (default WORLD).",
"inputSchema": {
"properties": {
"attribute": {
"default": "ending_stocks",
"description": "Projection attribute (beginning_stocks, production, imports, exports, domestic_consumption, ending_stocks)",
"enum": [
"beginning_stocks",
"production",
"imports",
"exports",
"domestic_consumption",
"ending_stocks"
],
"type": "string"
},
"commodity": {
"description": "Commodity slug (e.g. corn, wheat, soybeans)",
"enum": [
"corn",
"wheat",
"soybeans",
"soybean_meal",
"soybean_oil",
"rice",
"barley",
"cotton"
],
"type": "string"
},
"country": {
"default": "WORLD",
"description": "Country code (WORLD, US, BR, AR). Default: WORLD aggregate",
"type": "string"
}
},
"required": [
"commodity"
],
"type": "object"
},
"name": "get_wasde_history"
},
{
"description": "Latest USDA WASDE supply/demand projections for one commodity — beginning stocks, production, imports, exports, domestic consumption, and ending stocks — from the FAS PSD database behind the monthly WASDE report. Use for the current balance-sheet outlook; use get_wasde_history instead to see how a single figure has been revised across reports. Read-only lookup of stored projections; no API key. Returns the newest stored report's values for the requested marketing year (default: the current marketing year, where e.g. 2026 means the 2025/26 season) and country (default WORLD aggregate; US, BR, and AR are also tracked).",
"inputSchema": {
"properties": {
"commodity": {
"description": "Commodity slug (e.g. corn, wheat, soybeans, rice, cotton)",
"enum": [
"corn",
"wheat",
"soybeans",
"soybean_meal",
"soybean_oil",
"rice",
"barley",
"cotton"
],
"type": "string"
},
"country": {
"default": "WORLD",
"description": "Country code (WORLD, US, BR, AR). Default: WORLD aggregate",
"type": "string"
},
"market_year": {
"description": "Marketing year (e.g. 2026 = 2025/26 season). Default: current marketing year",
"type": "number"
}
},
"required": [
"commodity"
],
"type": "object"
},
"name": "get_wasde_projection"
},
{
"description": "Lists the dairy product slugs this API tracks (cheese, butter, dry_whey, fluid_milk) with display labels. Use to discover valid `product` values before calling get_dairy_price or get_dairy_history. Read-only; no API key. Butter is listed for completeness but its price is withheld in the price tools — USDA reports no US base price for butter.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_dairy_products"
},
{
"description": "Lists the commodities tracked in USDA export sales reporting (wheat, barley, corn, sorghum, soybeans, soybean meal, soybean oil, cotton, rice) with their FAS commodity codes. Use to discover valid `commodity` slugs before calling get_export_sales or get_export_sales_history. Read-only; no API key. Slugs map to FAS 'all' aggregate commodity codes where available.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_esr_commodities"
},
{
"description": "Lists the fertilizer product slugs this API tracks (anhydrous ammonia, urea, DAP, MAP, potash, liquid N 28/32, ATS, farm diesel, biodiesel) with display labels. Use to discover valid `product` values before calling get_fertilizer_price or get_fertilizer_history. Read-only; no API key. The list is the configured catalog across the tracked MARS production cost reports, not a live availability check.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_fertilizer_products"
},
{
"description": "Lists the commodities tracked in GATS trade flows (matched to Census data by HS chapter) with display labels. Use to discover valid `commodity` slugs before calling get_trade_flows or compare_contracts_vs_shipments. Read-only; no API key. The list is the configured catalog — individual commodities can still be withheld in get_trade_flows when their source data fails sanity checks.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_gats_commodities"
},
{
"description": "Lists the grain commodity slugs this API tracks (corn, soybeans, wheat, sorghum, oats, barley, rice) with display labels. Use to discover valid `product` values before calling get_grain_price or get_grain_history. Read-only; no API key. The list is the configured MARS catalog, not a live availability check — a listed product can still have no report for a given state.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_grain_products"
},
{
"description": "Lists the livestock category slugs this API tracks (fed_cattle, feeder_cattle, cows_cwt, cows_head, hogs, sheep) with display labels. Use to discover valid `product` values before calling get_livestock_price or get_livestock_history. Read-only; no API key. The list is the configured catalog, not a live availability check — some categories trade sporadically and can have no recent report in a region. Cows are split by quote unit: cows_cwt is per-hundredweight, cows_head is per-head.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_livestock_products"
},
{
"description": "Lists the commodities tracked in WASDE projections (corn, wheat, soybeans, soybean meal, soybean oil, rice, barley, cotton) with their FAS PSD commodity codes. Use to discover valid `commodity` slugs before calling get_wasde_projection or get_wasde_history. Read-only; no API key.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "list_wasde_commodities"
}
]
}What the leaf hashes
{"body":"7b7a28d4f23e54a489a0ab735b43a625ecd4388e9b8e64609eb068b73dcdaa0e","id":731981,"kind":"mcp.tools","method":"probe.mcp/1","observed_us":1793154589665830,"prev":302587,"subject":"3a46848f-c691-4ffa-8516-5095f7ec3ab2","subject_kind":"endpoint"}Proof
Its day has not closed yet. A day closes ten minutes after midnight UTC; the proof appears here then.